API Google Maps

Ostatnia aktualizacja: 18 czerwca 2024

Do czego służy klucz API Google Maps?

Klucz API Google Maps pozwala na dodanie mapy z oznaczonymi punktami (np. punkty odbioru Poczty Polskiej).
Aby wyświetlić mapę należy zarejestrować klucz API Google Maps i dodać w odpowiedniej sekcji oprogramowania. Usługa jest dostępna dla osób posiadających konto Google, dlatego aby ją uruchomić w pierwszym kroku zaloguj się na swoje konto Google.

Przed dodaniem mapy należy zaakceptować warunki korzystania z usługi Google Maps API.

Jak zarejestrować klucz API Google Maps i dodać go do konta w sklepie Shoper?

Wejdź na stronę Google Maps API i kliknij przycisk: Get started.
Google Maps Platform > Get started
Rys 1. Rozpocznij korzystać z usługi Google Maps API.
Google Maps Platform > Get started
Rys 1. Rozpocznij korzystać z usługi Google Maps API.
Uzupełnij formularz składający się z dwóch kroków, podepnij kartę płatniczą i zweryfikuj czy konto bilingowe zostało aktywowane w Google Cloud zgodnie z tą instrukcją: Manage your Cloud Billing account.
Google Maps Platform > Get started > Krok 1
Rys 2. Wypełnij pierwszą część formularza tworzenia konta w Google Cloud Platform.
Google Maps Platform > Get started > Krok 1
Rys 2. Wypełnij pierwszą część formularza tworzenia konta w Google Cloud Platform.
Google Maps Platform > Get started > Krok 2
Rys 3. W drugim kroku należy wprowadzić dane karty płatniczej.
Google Maps Platform > Get started > Krok 2
Rys 3. W drugim kroku należy wprowadzić dane karty płatniczej.
Wybierz usługę: Mapy (A) oraz Miejsca (B) i kliknij przycisk: WŁĄCZ (C).
Google Cloud Platform > Usługi
Rys 4. Zaznacz, jakie usługi chcesz aktywować w Google Maps Platform.
Google Cloud Platform > Usługi
Rys 4. Zaznacz, jakie usługi chcesz aktywować w Google Maps Platform.
System domyślnie utworzy pierwszy projekt i wygeneruje klucz API (A). Wyświetlony klucz skopiuj i kliknij: GOTOWE (B).
Google Cloud Platform > Usługi > Klucz API
Rys 5. Zapisz klucz interfejsu API dla usługi Google Maps Platform.
Google Cloud Platform > Usługi > Klucz API
Rys 5. Zapisz klucz interfejsu API dla usługi Google Maps Platform.
Zaloguj się do Panelu administracyjnego sklepu.
Przejdź do menu: Ustawienia (A) > Obsługa zamówień (B) > Formy dostawy (C) i edytuj dowolną dostawę np. Pocztę Polską (D).

Zwróć uwagę na to, aby forma dostawy Poczta Polska była utworzona z użyciem zintegrowanego typu: Poczta Polska (E).

Panel administracyjny sklepu > Ustawienia > Obsługa zamówień > Formy dostawy > Poczta Polska > Edycja
Rys 6. Wejdź do edycji dostawy Poczta Polska w Panelu administracyjnym sklepu Shoper.
Panel administracyjny sklepu > Ustawienia > Obsługa zamówień > Formy dostawy > Poczta Polska > Edycja
Rys 6. Wejdź do edycji dostawy Poczta Polska w Panelu administracyjnym sklepu Shoper.

W ustawieniach Poczty Polskiej (A) skopiowany klucz wklej do pola: Klucz API Map Google (B) celem wyświetlania punktów odbioru i uzupełnij pozostałe dane konfiguracyjne dostawy.

Panel administracyjny sklepu > Ustawienia > Obsługa zamówień > Formy dostawy > Poczta Polska > Edycja > Klucz API
Rys 7. Wprowadź klucz API Map Google w ustawieniach konta.
Panel administracyjny sklepu > Ustawienia > Obsługa zamówień > Formy dostawy > Poczta Polska > Edycja > Klucz API
Rys 7. Wprowadź klucz API Map Google w ustawieniach konta.

Pamiętaj, że Google oferuje ograniczoną liczbę darmowych wywołań API (szczegółowe informacje na ten temat znajdziesz w Google). Przekroczenie tego limitu może spowodować naliczenie opłat, dlatego aby uniknąć wykorzystywania klucza przez niepowołane osoby ogranicz jego używanie do domeny sklepu.

WAŻNE! Jeżeli posiadasz już konto w Google Cloud, a mimo to mapy nie działają poprawnie, upewnij się w bibliotece interfejsów API Google czy masz aktywne usługi: Maps JavaScript API oraz Places API.

Google Cloud Platform > Biblioteka interfejsów API > Mapy
Rys 8. W bibliotece interfejsów API możesz sprawdzić czy usługi są aktywne.
Google Cloud Platform > Biblioteka interfejsów API > Mapy
Rys 8. W bibliotece interfejsów API możesz sprawdzić czy usługi są aktywne.

Po kliknięciu w daną usługę, pojawi się opcja jej włączenia.

Google Cloud Platform > Biblioteka interfejsów API > Places API
Rys 9. Wejdź w usługę Places API Google, aby aktywować jej działanie na stronie sklepu Shoper.
Google Cloud Platform > Biblioteka interfejsów API > Places API
Rys 9. Wejdź w usługę Places API Google, aby aktywować jej działanie na stronie sklepu Shoper.

Ograniczenie dostępu klucza API dla twojego sklepu internetowego Shoper

Klucz API jest unikalnym identyfikatorem dla twojej mapy, możesz ograniczyć dostęp dla klucza jedynie dla twoich domen.

Przejdź na stronę zarządzanie API Google i wybierz swój projekt (A), a następnie kliknij w edycję klucza API (B).
Google API > Strona Shoper > Klucz API > Edycja
Rys 10. Zarządzaj swoim projektem Shoper i przejdź do edycji Maps API Key.
Google API > Strona Shoper > Klucz API > Edycja
Rys 10. Zarządzaj swoim projektem Shoper i przejdź do edycji Maps API Key.
W sekcji Ograniczenia aplikacji zaznacz opcję: Strony odsyłające HTTP (witryny internetowe) – (A) i dodaj 3 adresy URL koszyka swojej witryny (B). Adres https://sklepxxx.shoparena.pl jest przykładowy – w to miejsce użyj własnej domeny:
  • https://sklepxxx.shoparena.pl/pl/basket,
  • https://sklepxxx.shoparena.pl/pl/basket/step3,
  • https://sklepxxx.shoparena.pl/pl/basket/rc.

i ZAPISZ zmiany (C).

Google API > Strona Shoper > Klucz API > Edycja > Ograniczenia aplikacji
Rys 11. Ogranicz dostęp dla klucza Maps API Key dla swoich domen sklepu internetowego Shoper.
Google API > Strona Shoper > Klucz API > Edycja > Ograniczenia aplikacji
Rys 11. Ogranicz dostęp dla klucza Maps API Key dla swoich domen sklepu internetowego Shoper.
Warto zapamiętać!
W powyższym artykule zostało wyjaśnione:
  • Na co pozwala klucz interfejsu API w Google Maps?
  • Jak włączyć interfejs API Google Maps dla strony sklepu Shoper?
  • Jak ograniczyć dostęp dla klucza API tylko dla wybranej witryny?
Udostępnij artykuł:

Przetestuj sklep internetowy
przez 14 dni za darmo

Korzystaj ze wszystkich funkcji oprogramowania za darmo i bez zobowiązań.

Testuj wszystkie funkcje przez 14 dni bez zobowiązań. Zakładając sklep poprzez podanie
adresu e-mail akceptujesz nasz Regulamin i Politykę Prywatności