PL
ENKlucz API Google Maps Platform jest opcjonalny. Gdy dodasz go w ustawieniach aplikacji, adres podany przez kupującego w checkout jest dopasowywany dokładniej, więc lista punktów odbioru lepiej odpowiada temu, gdzie kupujący faktycznie mieszka. Rozwiązanie to zalecamy sklepom z dużą liczbą zamówień.
Klucz nie dodaje wyboru punktu z mapy. Wpływa tylko na trafność listy najbliższych punktów odbioru, wygląd checkout pozostaje taki sam.
Ile to kosztuje
Aby korzystać z Google Maps Platform (również w ramach darmowego planu), potrzebujesz konta Google z zarejestrowaną kartą kredytową lub debetową. Samo dodanie karty nie oznacza opłat: Google Maps Platform jest darmowe do 10 000 wywołań miesięcznie, a większość sklepów nie przekracza tego limitu.
Powyżej darmowego limitu Geocoding API kosztuje około 5 USD za każde 1 000 wywołań. Aktualne stawki znajdziesz w cenniku Google.
Jak utworzyć klucz API
- Przejdź do zakładki Keys & Credentials w Google Maps Platform. Jeśli nie masz jeszcze projektu Google Cloud, Google poprosi o jego utworzenie i skonfigurowanie płatności
- Jeśli klucz nie został utworzony automatycznie, kliknij + Create credentials i wybierz opcję API key
- Po utworzeniu klucza kliknij jego nazwę, aby otworzyć stronę klucza
- W polu Name wprowadź InPost – Tale Commerce, żeby później wiedzieć, do czego służy ten klucz
- Nie ustawiaj żadnych ograniczeń w sekcji Application restrictions. Ograniczenia do stron, adresów IP czy aplikacji mobilnych zablokują klucz. Jeśli to problem, skontaktuj się z nami
- W sekcji API restrictions wybierz opcję Restrict key
- Na liście wybierz Geocoding API. Jeśli nie jest widoczne, najpierw je włącz
- Kliknij Save na dole strony
Jak dodać klucz w aplikacji
- Otwórz aplikację InPost – Tale Commerce w panelu Shopify
- Przejdź do Ustawień i znajdź sekcję Integracja z Google Maps Platform
- Wklej klucz w pole Klucz API
- Kliknij Zapisz
Przy zapisie sprawdzamy klucz w Google. Jeśli coś jest nie tak, zobaczysz komunikat pod polem i klucz nie zostanie zapisany. Poprawny klucz zaczyna działać od razu.
Klucz możesz w każdej chwili usunąć: wyczyść pole Klucz API i zapisz ustawienia.
Najczęstsze komunikaty o błędach
| Komunikat | Co zrobić |
|---|---|
| Klucz jest nieprawidłowy, wygasł lub nie został znaleziony | Sprawdź, czy klucz został wklejony w całości, w zakładce Keys & Credentials |
| Klucz nie powinien mieć ograniczeń dotyczących witryn, adresów IP lub aplikacji | Usuń wszystkie ograniczenia w sekcji Application restrictions (krok 5 powyżej) |
| Geocoding API nie znajduje się na liście dozwolonych | W sekcji API restrictions dodaj Geocoding API (kroki 6 i 7 powyżej) |
| Geocoding API musi zostać włączone | Włącz Geocoding API w swoim projekcie |
| Płatności muszą zostać włączone | Skonfiguruj płatności w projekcie Google Cloud. Google wymaga karty także w darmowym planie |
| Klucz przekroczył limit zapytań | Otwórz Quotas, wybierz Geocoding API i zwiększ lub usuń limit v4 GeocodeAddress |
Świeżo utworzony klucz albo dopiero włączone Geocoding API mogą jeszcze nie być widoczne po stronie Google. Jeśli masz pewność, że wszystko jest ustawione poprawnie, odczekaj kilka minut i zapisz klucz ponownie.
Jeśli komunikat nie pasuje do żadnego z powyższych albo problem się powtarza, napisz do nas.
Gdy klucz przestanie działać już po zapisaniu, na przykład po przekroczeniu limitu lub wyłączeniu płatności, w aplikacji pojawi się komunikat o problemie. Punkty odbioru nadal wyświetlają się w checkout, ale warto wtedy zajrzeć w ustawienia.
Jak sprawdzić, czy klucz działa
Po dodaniu lub zmianie klucza złóż testowe zamówienie i wpisz w checkout adres, który nie był wcześniej używany w tym sklepie. Po kilku minutach ruch będzie widoczny w statystykach Google Maps Platform w Twoim projekcie.
Jeśli punkty odbioru w ogóle nie pojawiają się w checkout, przyczyna leży gdzie indziej. Sprawdź Paczkomaty nie wyświetlają się w checkout.