Google zaleca korzystanie z sesji w przypadku autouzupełniania (nowego). Sesje pomagają uprościć ceny i zapewniają spójny model cenowy do stosowania z autouzupełnianiem (nowym).
Sesja rozpoczyna się od pierwszego żądania autouzupełniania (nowego), które zawiera token sesji, jest kontynuowana przez każde kolejne żądanie autouzupełniania (nowe), a następnie jest kończona przez żądanie informacji o miejscu (nowych) lub Weryfikacji adresów, które używa tokena sesji.
Po zakończeniu sesji każde wywołanie funkcji Autouzupełnianie (nowe), Informacje o miejscu (nowe) lub Weryfikacja adresów, które używa wygasłego tokena sesji, jest rozliczane tak, jakby nie było tokena sesji.
Niekompletne sesje, czyli sesje, które nie zostały zakończone żądaniem do usługi informacje o miejscu (nowa) lub Weryfikacja adresów, są rozliczane tylko za żądania autouzupełniania (nowe) przy użyciu SKU: żądania autouzupełniania.
Płatności za sesje
Sesje kończące się żądaniem informacji o miejscu (New) Essentials
W przypadku sesji autouzupełniania (nowych), które kończą się żądaniem używającym pól z SKU: Places API informacje o miejscu Essentials:
- Pierwsze 12 żądań autouzupełniania (nowych): opłata jest naliczana za każde żądanie autouzupełniania (nowe) do maksymalnie 12 żądań, przy użyciu SKU: żądania autouzupełniania.
- W przypadku 13 i kolejnych żądań Autouzupełniania (nowego) w tej samej sesji: opłaty są naliczane według SKU: wykorzystanie sesji autouzupełniania, co oznacza, że za te żądania nie są naliczane opłaty.
- Informacje o miejscu (nowe) – Essentials: opłata jest naliczana również za żądanie kończące w ramach SKU: Places API – informacje o miejscu – Essentials.
Sesje kończące się żądaniami Weryfikacji adresów lub informacji o miejscu (New) (nie Essentials)
W przypadku sesji autouzupełniania (nowego), które kończą się żądaniem Weryfikacji adresów lub żądaniem informacji o miejscu (nowym) z użyciem pól z informacji o miejscu Pro, Enterprise lub Enterprise + Atmosphere:
- Żądania autouzupełniania (nowe): wszystkie żądania autouzupełniania (nowe) są rozliczane według SKU: wykorzystanie sesji autouzupełniania, co oznacza, że nie są naliczane opłaty za te żądania.
-
Żądanie dotyczące informacji o miejscu (nowe) lub weryfikacji adresu: opłata jest naliczana również za żądanie kończące sesję według odpowiedniego kodu SKU:
- Żądania dotyczące informacji o miejscu (nowych) są rozliczane według SKU: informacje o miejscu Enterprise + atmosfera, niezależnie od żądanych pól.
- Żądania dotyczące zakończenia weryfikacji adresów są rozliczane w ramach SKU: Address Validation Enterprise.
Scenariusze cenowe sesji
Trzy najczęstsze scenariusze cenowe sesji to:
- Autouzupełnianie danych o lokalizacji
- Autouzupełnianie na potrzeby odkrywania miejsc
- Autouzupełnianie danych dotyczących płatności i dostawy
W sekcjach poniżej opisano poszczególne opłaty za rozliczenia w każdym scenariuszu.
Autouzupełnianie danych o lokalizacji
W scenariuszu autouzupełniania danych o lokalizacji chcesz używać autouzupełniania (nowego) i informacji o miejscu (nowych), aby uzyskać informacje o lokalizacji miejsca. Możesz na przykład wybrać sugestię z autouzupełniania (nowego), a następnie użyć informacji o miejscu (nowych), aby uzyskać współrzędne szerokości i długości geograficznej miejsca i wyświetlić je na mapie.
Informacje o lokalizacji mogą obejmować:
- Adres
- lokalizację jako współrzędne geograficzne,
- Plus Code
- Typy
- Widoczny obszar
Sesja kończy się pojedynczym żądaniem do usługi Informacje o miejscu (nowej), które żąda pól zdefiniowanych przez SKU: Informacje o miejscu Essentials.
Opłaty będą naliczane w ten sposób:
- Pierwsze 12 żądań autouzupełniania (nowych) jest rozliczanych według SKU: żądania autouzupełniania.
- Wszystkie pozostałe żądania Autouzupełniania (nowego) są rozliczane według SKU: Wykorzystanie sesji autouzupełniania, co oznacza, że nie są naliczane za nie opłaty.
- Żądanie dotyczące szczegółów miejsca (nowe) jest rozliczane według SKU: Places API – informacje o miejscu – Essentials.
Autouzupełnianie na potrzeby odkrywania miejsc
W scenariuszu autouzupełniania na potrzeby odkrywania miejsc chcesz uzyskać więcej niż tylko dane o lokalizacji miejsca. Możesz na przykład poprosić o:
- Opcje ułatwień dostępu
- Aktualne godziny otwarcia
- Możliwości parkowania
- Opinie
- Oceny
W tym scenariuszu sesja zostanie zakończona przez pojedyncze żądanie do usługi informacje o miejscu (nowa), które żąda dowolnych pól zawartych w kodach SKU Pro, Enterprise lub Enterprise + Atmosfera usługi informacje o miejscu (nowa).
Opłaty będą naliczane w ten sposób:
- Wszystkie żądania autouzupełniania (nowe) są rozliczane w ramach kodu SKU: wykorzystanie sesji autouzupełniania, co oznacza, że nie są naliczane opłaty za te żądania.
- Żądanie dotyczące informacji o miejscu (nowe) jest rozliczane według kodu SKU: Szczegóły miejsca w interfejsie Places API Enterprise + Atmosfera.
Autouzupełnianie na potrzeby 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 znajduje dla niego najlepsze znane współrzędne szerokości i długości geograficznej.
W scenariuszu autouzupełniania na potrzeby płatności i dostawy kończysz sesję żądaniem do Address Validation API, aby zweryfikować wybrany adres.
Opłaty będą naliczane w ten sposób:
- Wszystkie żądania autouzupełniania (nowe) są rozliczane w ramach kodu SKU: wykorzystanie sesji autouzupełniania, co oznacza, że nie są naliczane opłaty za te żądania.
- Opcjonalne żądanie podstawowych informacji o miejscu jest bezpłatne, jeśli zostanie wysłane przed żądaniem weryfikacji adresu.
- Żądanie weryfikacji adresu, które kończy sesję, jest rozliczane w ramach SKU: Address Validation Enterprise.
Ceny bez sesji
Jeśli nie korzystasz z sesji, opłaty są naliczane za żądanie do autouzupełniania (nowego) przy użyciu SKU: żądania autouzupełniania.
Ceny za nieukończone lub porzucone sesje
Jeśli sesja zostanie porzucona, czyli nie zostanie zakończona wywołaniem informacji o miejscu (nowych) lub Weryfikacji adresów, żądania autouzupełniania (nowe) powrócą do modelu rozliczeń za żądanie i będą rozliczane zgodnie z SKU: żądania autouzupełniania.