Google zaleca używanie sesji z autouzupełnianiem (nowym). Sesje upraszczają cennik i zapewniają spójny model cenowy do używania z autouzupełnianiem (nowym).
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 Place Details (New) lub Address Validation, są rozliczane tylko za żądania Autocomplete (New) przy użyciu SKU: Autocomplete Requests.
Płatność za sesję
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 – informacje o miejscu – 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łaty są naliczane według kodu SKU: Autocomplete Session Usage, co oznacza, że za te żądania nie są pobierane żadne opłaty.
- Informacje o miejscu (nowe) – Essentials: opłata jest naliczana również za żądanie końcowe w ramach kodu SKU: Places API – informacje o miejscu – Essentials.
Sesje kończące się żądaniami weryfikacji adresu lub szczegółów miejsca (nowe) (nie w 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 z pakietów Szczegóły miejsca Pro, Enterprise lub Enterprise + Atmosphere:
- Żądania autouzupełniania (nowe): wszystkie żądania autouzupełniania (nowe) są rozliczane według kodu SKU: wykorzystanie sesji autouzupełniania, co oznacza, że nie są za nie pobierane opłaty.
-
Szczegóły miejsca (nowe) lub prośba o weryfikację adresu: opłata jest naliczana również za żądanie końcowe w odpowiednim SKU:
- Żądania kończące Informacje o miejscu (nowe) są rozliczane według SKU: Informacje o miejscu Enterprise + atmosfera, 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 do 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 (nowe), aby uzyskiwać informacje o lokalizacji danego 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 kończy się pojedynczym żądaniem szczegółów miejsca (nowych), które zawiera pola zdefiniowane przez SKU: Place Details Essentials.
Opłata jest naliczana w ten sposób:
- Pierwsze 12 żądań autouzupełniania (nowego) jest rozliczanych według kodu SKU: żądania autouzupełniania.
- Pozostałe żądania autouzupełniania (nowego) są rozliczane według kodu SKU: wykorzystanie sesji autouzupełniania, co oznacza, że nie są za nie pobierane opłaty.
- Końcowe żądanie informacji o miejscu (nowe) jest rozliczane według kodu SKU: Places API – informacje o miejscu (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 dowolnej z tych czynności:
- Opcje ułatwień dostępu
- Aktualne godziny otwarcia
- Możliwości parkowania
- Opinie
- Oceny
W tym scenariuszu sesja jest zamykana przez jedno żądanie do interfejsu Place Details (New), które zawiera dowolne pola z kodów SKU Pro, Enterprise lub Enterprise + Atmosphere interfejsu Place Details (New).
Opłata jest naliczana w ten sposób:
- Wszystkie żądania autouzupełniania (nowe) są rozliczane według kodu SKU: wykorzystanie sesji autouzupełniania, co oznacza, że nie są za nie pobierane 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 najlepiej dopasowane współrzędne określające szerokość i długość geograficzną.
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 kodu SKU: wykorzystanie sesji autouzupełniania, co oznacza, że nie są za nie pobierane opłaty.
- Opcjonalne żądanie Place Details Essentials jest rozliczane bezpłatnie, jeśli zostanie wysłane przed żądaniem Address Validation.
- Żądanie weryfikacji adresu, które spowodowało zakończenie, 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 usługi Autocomplete (New) zgodnie z SKU: Autocomplete Requests.
Ceny za niekompletne lub porzucone sesje
Jeśli sesja zostanie porzucona, czyli nie zostanie zakończona przez wywołanie żądania Place Details (New) lub Address Validation, Autocomplete (New), żądania wracają do modelu cenowego za żądanie i są rozliczane zgodnie z SKU: Autocomplete Requests.