Google zaleca używanie sesji z autouzupełnianiem (nowym). Sesje upraszczają cennik i zapewniają spójny model cenowy do używania z usługą 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 informacji o miejscu (New) lub Weryfikacja adresów, które używa tokena sesji.
Po zakończeniu sesji każde wywołanie funkcji Autocomplete (New), informacje o miejscu (New) lub Weryfikacja adresów, które używa wygasłego tokena sesji, jest rozliczane tak, jakby nie było tokena sesji.
Niepełne sesje, czyli sesje, które nie są kończone przez żądanie informacji o miejscu (New) lub Weryfikacji adresów, są rozliczane tylko za żądania Autocomplete (New) przy użyciu SKU: Autocomplete Requests.
Płatności za sesję
Sesje kończące się żądaniem informacji o miejscu (New) Essentials
W przypadku sesji autouzupełniania (nowego), które kończą się żądaniem z użyciem 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ń autouzupełniania (nowego) o numerze 13 i wyższym w ramach tej samej sesji: opłata jest naliczana według kodu SKU: wykorzystanie sesji autouzupełniania, 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 adresów lub informacji o miejscu (nowe) (nie dotyczy wersji Essentials)
W przypadku sesji Autouzupełniania (nowego), które kończą się żądaniem Weryfikacji adresów lub żądaniem informacji o miejscu (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.
-
Informacje o miejscu (nowe) lub prośba o weryfikację adresu: opłata jest naliczana również za prośbę końcową 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: Address Validation 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 (nowa wersja), a potem używasz informacji o miejscu (nowa wersja), 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 dotyczącym informacji o miejscu (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.
- Żądanie kończące dotyczące interfejsu Place Details (New) jest rozliczane według kodu SKU: Places API – informacje o miejscu (Essentials).
Autouzupełnianie podczas wyszukiwania 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 Informacje o miejscu (New), które zawiera dowolne pola z kodów SKU Pro, Enterprise lub Enterprise + Atmosphere interfejsu Informacje o miejscu (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.
- Opcjonalna prośba o podstawowe informacje o miejscu jest rozliczana bezpłatnie, jeśli zostanie wysłana przed końcową prośbą o weryfikację adresu.
- Żądanie weryfikacji adresu, które spowodowało zakończenie działania, jest rozliczane według SKU: Address Validation Enterprise.
Ceny bez sesji
Jeśli nie korzystasz z sesji, opłaty są naliczane za każde żądanie autouzupełniania (nowego) według SKU: żądania autouzupełniania.
Ceny za niekompletne lub przerwane sesje
Jeśli sesja zostanie porzucona, czyli nie zostanie zakończona przez wywołanie żądania informacje o miejscu (New) lub Weryfikacja adresów, Autocomplete (New), żądania wracają do modelu cenowego za żądanie i są rozliczane zgodnie z SKU: Autocomplete Requests.