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.
Nieukończone sesje, czyli sesje, które nie zostały zakończone żądaniem Szczegółów miejsca (nowe) lub Weryfikacji adresu, są rozliczane tylko na podstawie żądań automatycznego uzupełniania (nowe) korzystających z SKU: Żądania automatycznego uzupełniania.
Rozliczanie sesji
Sesje kończące się w żądaniu szczegółów miejsca (nowość) 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ń 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.
-
Żą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: 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 (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 kończy się pojedynczym żądaniem dotyczącym szczegółów miejsca (nowa wersja), które zawiera pola zdefiniowane przez kod SKU: szczegóły miejsca w wersji podstawowej.
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 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 szczegółów miejsca (nowe), które zawiera dowolne pola uwzględnione w kodach SKU szczegółów miejsca (nowe) Pro, Enterprise lub Enterprise + Atmosphere.
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 żadne opłaty.
- Końcowe żądanie szczegółów miejsca (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 żadne opłaty.
- Opcjonalne żądanie Place Details Essentials jest rozliczane bezpłatnie, jeśli zostanie wysłane przed żądaniem Address Validation.
- Żą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 usługi Autocomplete (New) zgodnie z SKU: Autocomplete Requests.
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.