Klucze API Google Maps

Globe Pickup Points obsługuje dwa opcjonalne klucze API Google, które poprawiają doświadczenie klientów przy wyborze punktu odbioru:

1. Klucz Google Maps JavaScript API (zalecany) - Wyświetla interaktywną mapę z lokalizacjami punktów odbioru
2. Klucz Google Places API (opcjonalny) - Używany do wyszukiwania adresów na mapie z autouzupełnianiem i dokładniejszymi wynikami

Oba klucze są opcjonalne, ale klucz Google Maps API jest zalecany dla najlepszego doświadczenia klienta. Bez nich klienci nadal mogą wybierać punkty odbioru z listy rozwijanej.

Co się stanie, jeśli zostawię klucz Places API pusty?

Wyszukiwanie adresów na mapie będzie nadal działać bez klucza Places API — po prostu nie będzie tak dokładne, a autouzupełnianie (sugestie adresów podczas pisania) nie będzie dostępne. Dla najlepszego doświadczenia wyszukiwania zalecamy dodanie klucza Places API.

Bezpłatny poziom

Usługi Google Maps są płatne, ale dostępny jest hojny bezpłatny poziom.

Bezpłatny poziom jest zazwyczaj wystarczający dla większości sklepów Shopify (do 10 000 wyświetleń mapy). Więcej informacji o cenach Google Maps znajdziesz tutaj.

Google zaktualizował swoje ceny od marca 2025 roku. Sprawdź ich kalkulator cen w celu uzyskania najnowszych informacji.

Tworzenie klucza Google Maps JavaScript API

Ten klucz umożliwia wyświetlanie interaktywnej mapy z lokalizacjami punktów odbioru.

1. Przejdź do Google Cloud Platform Console.
2. Jeśli nie masz jeszcze projektu, utwórz go, klikając Nowy projekt i postępując zgodnie z instrukcjami wyświetlanymi na ekranie.
3. Gdy projekt będzie gotowy, przejdź do pulpitu Interfejsy API i usługi i kliknij Włącz interfejsy API i usługi.
4. W polu wyszukiwania wpisz Google Maps JavaScript API i wybierz je. Następnie kliknij Włącz, aby aktywować API dla swojego projektu.

5. Po włączeniu API przejdź do zakładki Dane logowania i kliknij + Utwórz dane logowania. Wybierz Klucz API z menu rozwijanego. Twój nowy klucz API zostanie utworzony i wyświetlony na ekranie.

6. Ogranicz swój klucz API, aby zapobiec nieautoryzowanemu użyciu:
   • Kliknij Edytuj klucz API (lub ikonę ołówka obok klucza)
   • W sekcji Ograniczenia aplikacji wybierz Strony internetowe
   • Dodaj następujące domeny odsyłające, aby ograniczyć użycie klucza API do Twojego sklepu Shopify:
     • *.[TWOJA-DOMENA].com (zastąp swoją rzeczywistą domeną)
     • *.myshopify.com
     • [TWOJA-DOMENA].com (zastąp swoją rzeczywistą domeną)
     • https://shop.app
     • https://shopify.com
     • Uwzględnij wszelkie dodatkowe domeny, na których działa Twój sklep
   • W sekcji Ograniczenia API wybierz Ogranicz klucz i wybierz tylko Maps JavaScript API

7. Kliknij Zapisz, aby zastosować ustawienia.

Szczegółowe instrukcje znajdziesz w oficjalnym przewodniku Google dotyczącym uzyskiwania klucza API.

Tworzenie klucza Google Places API

Ten klucz jest używany do wyszukiwania adresów na mapie — klienci mogą wpisać adres i otrzymywać sugestie autouzupełniania podczas pisania. Punkty odbioru są następnie wyświetlane w pobliżu wprowadzonego adresu. Bez tego klucza wyszukiwanie nadal działa, ale bez autouzupełniania i z mniejszą dokładnością.

Ważne: Używaj oddzielnych kluczy API

Musisz utworzyć inny klucz API dla Places API, oddzielny od klucza Google Maps JavaScript API. Klucz Places API jest używany po stronie backendu i wymaga innych ograniczeń bezpieczeństwa niż klucz Maps JavaScript API.

1. W tej samej Google Cloud Platform Console użyj tego samego projektu, który utworzyłeś dla Maps API.
2. Przejdź do pulpitu Interfejsy API i usługi i kliknij Włącz interfejsy API i usługi.
3. W polu wyszukiwania wpisz Places API (New) i wybierz je. Następnie kliknij Włącz, aby aktywować API dla swojego projektu.

Używaj Places API (New)

Upewnij się, że włączasz Places API (New), a nie starsze Places API. Nowa wersja oferuje lepszą wydajność i więcej funkcji.

4. Po włączeniu API przejdź do zakładki Dane logowania i kliknij + Utwórz dane logowania. Wybierz Klucz API z menu rozwijanego.

5. Ważne: Nadaj temu kluczowi opisową nazwę, np. „Klucz Places API”, aby odróżnić go od klucza Maps JavaScript API.

6. Ogranicz ten klucz API:

   • Kliknij Edytuj klucz API
   • W sekcji Ograniczenia aplikacji wybierz Brak (ten klucz jest używany tylko po stronie serwera, nie w przeglądarce)
   • W sekcji Ograniczenia API wybierz Ogranicz klucz i wybierz tylko Places API (New)

7. Kliknij Zapisz, aby zastosować ustawienia.

Dodawanie kluczy API do Globe Pickup Points

Po utworzeniu kluczy API zintegruj je z aplikacją Globe Pickup Points:

1. Zaloguj się do swojego panelu administracyjnego Shopify.
2. Przejdź do aplikacji Globe Pickup Points.
3. Przejdź do strony Ustawienia.
4. Znajdziesz dwa oddzielne pola:
   • Klucz Google Maps API (zalecany) — wklej tutaj klucz Maps JavaScript API, aby włączyć interaktywną mapę
   • Klucz Google Places API (opcjonalny) — wklej tutaj klucz Places API do wyszukiwania adresów na mapie z autouzupełnianiem. Bez niego wyszukiwanie nadal działa, ale jest mniej dokładne i nie zawiera sugestii adresów.
5. Możesz dodać jeden lub oba klucze w zależności od funkcji, które chcesz włączyć.
6. Kliknij Zapisz, aby zastosować zmiany.

Skonfigurowanie tych kluczy API umożliwia korzystanie z zaawansowanego selektora punktów odbioru na mapie z możliwością wyszukiwania lokalizacji, znacznie poprawiając doświadczenie klientów.

---