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.
Niepełne 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ści za sesję
Sesje kończące się żądaniem Place Details (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 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 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: 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 (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 dotyczącym szczegółów miejsca (nowa wersja), które zawiera pola zdefiniowane przez kod SKU: podstawowe informacje o miejscu.
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 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 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.
- Opcjonalna prośba o podstawowe informacje o miejscu jest rozliczana bezpłatnie, jeśli zostanie wysłana przed prośbą o zakończenie weryfikacji 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 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.