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.
Sesje niekompletne, czyli takie, które nie zostały zakończone żądaniem dotyczącym informacji o miejscu (nowych) lub Weryfikacji 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 (nowych) typu Essentials
W przypadku sesji autouzupełniania (nowych), które kończą się żądaniem korzystającym z 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 żądań Autouzupełniania (nowego) od 13 wzwyż 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 (nowych), które kończą się żądaniem weryfikacji adresu 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 (nowych) lub weryfikacji adresu: opłata jest naliczana również za żądanie kończące sesję zgodnie z odpowiednim kodem 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
3 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 rozliczeniowe w każdym scenariuszu.
Autouzupełnianie danych o lokalizacji
W scenariuszu autouzupełniania danych o lokalizacji chcesz używać funkcji autouzupełniania (nowej) 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ć szczegółów miejsca (nowych), aby uzyskać współrzędne geograficzne 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 (nowego) jest rozliczanych według SKU: żądania autouzupełniania.
- thought 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 informacji o miejscu (New) jest rozliczane według SKU: Places API Place Details 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 jest 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 według 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: Places API Enterprise – informacje o miejscu + 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 interfejsu Address Validation API, aby zweryfikować wybrany adres.
Opłaty będą naliczane w ten sposób:
- Wszystkie żądania autouzupełniania (nowe) są rozliczane według 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.