Google zaleca używanie sesji z autouzupełnianiem (nowym). Sesje upraszczają cennik i zapewniają spójny model cenowy do użycia z funkcją Autocomplete (New).
Sesja rozpoczyna się od pierwszego żądania Autocomplete (New), które zawiera token sesji, trwa przez każde kolejne żądanie Autocomplete (New), a następnie kończy się żądaniem Place Details (New) lub Address Validation, które używa tokena sesji.
Po zakończeniu sesji każde wywołanie funkcji Autocomplete (New), Place Details (New) lub Address Validation, które używa wygasłego tokena sesji, jest rozliczane tak, jakby nie było tokena sesji.
Niekompletne sesje, czyli sesje, które nie są kończone przez żądanie szczegółów miejsca (nowe) lub weryfikację adresu, są rozliczane tylko za żądania autouzupełniania (nowe) przy użyciu SKU: żądania autouzupełniania.
Rozliczenia sesji
Sesje kończące się żądaniem Place Details (New) Essentials
W przypadku sesji autouzupełniania (nowego), które kończą się żądaniem korzystającym z pól z SKU: Places API Place Details Essentials:
- Pierwsze 12 żądań autouzupełniania (nowego): opłata jest naliczana za każde żądanie autouzupełniania (nowego), maksymalnie za 12 żądań, przy użyciu kodu SKU: żądania autouzupełniania.
- W przypadku żądań Autocomplete (New) o numerze 13 i wyższym w ramach tej samej sesji: opłata jest naliczana według SKU: Autocomplete Session Usage, co oznacza, że za te żądania nie są pobierane żadne opłaty.
- Place Details (New) Essentials: opłata jest naliczana również za żądanie końcowe według SKU: Places API Place Details Essentials.
Sesje kończące się żądaniami weryfikacji adresu lub szczegółów miejsca (nowe) (nie dotyczy wersji Essentials)
W przypadku sesji Autouzupełniania (nowego), które kończą się żądaniem weryfikacji adresu lub żądaniem szczegółów miejsca (nowych) z użyciem pól ze szczegółów miejsca w wersji Pro, Enterprise lub Enterprise + Atmosphere:
- Żądania autouzupełniania (nowe): wszystkie żądania autouzupełniania (nowe) są rozliczane według SKU: Autocomplete Session Usage, co oznacza, że nie są naliczane za nie opłaty.
-
Żądanie szczegółów miejsca (nowe) lub weryfikacji adresu: opłata jest naliczana również za żądanie końcowe w odpowiednim SKU:
- Żądania kończące Place Details (New) są rozliczane według SKU: Place Details Enterprise + Atmosphere, niezależnie od żądanych pól.
- Żądania zakończenia weryfikacji adresu są rozliczane według SKU: Weryfikacja adresu – wersja Enterprise.
Scenariusze cenowe sesji
3 najczęstsze scenariusze cenowe sesji to:
- Autouzupełnianie danych o lokalizacji
- Autouzupełnianie podczas odkrywania miejsc
- Autouzupełnianie podczas płatności i dostawy
W sekcjach poniżej znajdziesz opis poszczególnych opłat w każdym scenariuszu.
Autouzupełnianie danych o lokalizacji
W scenariuszu autouzupełniania danych o lokalizacji chcesz używać funkcji Autouzupełnianie (nowa) i Szczegóły miejsca (nowa), aby uzyskiwać informacje o lokalizacji miejsca. Na przykład wybierasz sugestię z autouzupełniania (nowego), a potem używasz szczegółów miejsca (nowych), aby uzyskać współrzędne geograficzne miejsca i wyświetlić je na mapie.
Informacje o lokalizacji mogą obejmować:
- Adres
- Lokalizacja jako współrzędne geograficzne
- Plus Code
- Typy
- Widoczny obszar
Sesja jest zamykana przez pojedyncze żądanie dotyczące szczegółów miejsca (nowe), które zawiera pola zdefiniowane przez kod SKU: szczegóły miejsca Essentials.
Opłata jest naliczana w ten sposób:
- Pierwsze 12 żądań autouzupełniania (nowego) jest rozliczanych według kodu SKU: żądania autouzupełniania.
- Wszystkie pozostałe żądania autouzupełniania (nowego) są rozliczane według SKU: Autocomplete Session Usage, co oznacza, że nie są za nie pobierane opłaty.
- Żądanie końcowe dotyczące informacji o miejscu (nowe) jest naliczane według SKU: Places API Place Details Essentials.
Autouzupełnianie podczas odkrywania miejsc
W scenariuszu autouzupełniania w celu wykrywania miejsc interesuje Cię uzyskanie nie tylko danych o lokalizacji miejsca. Możesz na przykład poprosić o wykonanie tych czynności:
- Opcje ułatwień dostępu
- Aktualne godziny otwarcia
- Możliwości parkowania
- Opinie
- Oceny
W tym scenariuszu sesja jest zamykana przez pojedyncze żądanie do interfejsu Place Details (New), które zawiera dowolne pola z kodów SKU Place Details (New) Pro, Enterprise lub Enterprise + Atmosphere.
Opłata jest naliczana w ten sposób:
- Wszystkie żądania autouzupełniania (nowe) są rozliczane według SKU: wykorzystanie sesji autouzupełniania, co oznacza, że za te żądania nie są naliczane żadne opłaty.
- Końcowe żądanie informacji o miejscu (nowe) jest rozliczane według kodu SKU: Places API Place Details Enterprise + Atmosphere.
Autouzupełnianie podczas płatności i dostawy
Address Validation API to usługa, która akceptuje adres. Identyfikuje komponenty adresu i je weryfikuje. Standaryzuje też adres na potrzeby wysyłki pocztą i określa dla niego najlepsze znane współrzędne długości i szerokości geograficznej.
W scenariuszu autouzupełniania podczas płatności i dostawy sesję kończysz żądaniem wysłanym do interfejsu Address Validation API w celu zweryfikowania wybranego adresu.
Opłata jest naliczana w ten sposób:
- Wszystkie żądania autouzupełniania (nowe) są rozliczane według SKU: wykorzystanie sesji autouzupełniania, co oznacza, że za te żądania nie są naliczane żadne opłaty.
- Opcjonalne żądanie Place Details Essentials jest rozliczane bezpłatnie, jeśli zostanie wysłane przed żądaniem zakończenia weryfikacji adresu.
- Żądanie zakończenia weryfikacji adresu jest rozliczane według SKU: Address Validation Enterprise.
Ceny bez sesji
Jeśli nie używasz sesji, opłaty są naliczane za każde żądanie wysłane do interfejsu Autocomplete (New) zgodnie z SKU: żądania Autocomplete.
Ceny za niepełne lub przerwane sesje
Jeśli sesja zostanie porzucona, czyli nie zostanie zakończona wywołaniem funkcji Place Details (New) lub Address Validation, Autocomplete (New), żądania wracają do modelu cenowego za żądanie i są rozliczane zgodnie z SKU: Autocomplete Requests.