Google zaleca używanie sesji z autouzupełnianiem (nowym). 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 kończy się żądaniem informacji o miejscu (nowych) lub Weryfikacji 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 tokena sesji nie było.
Sesje niekompletne, czyli takie, które nie zostały zakończone żądaniem do usługi Informacje o miejscu (nowej) 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 (nowa wersja) 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ń Autocomplete (New): opłata jest naliczana za każde żądanie Autocomplete (New), maksymalnie za 12 żądań, przy użyciu SKU: Autocomplete Requests.
- W przypadku żądań Autocomplete (New) o numerze 13 i wyższym w tej samej sesji: opłata jest naliczana według kodu SKU: Autocomplete Session Usage, 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ń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) (inne niż Essentials)
W przypadku sesji autouzupełniania (nowego), które kończą się żądaniem weryfikacji adresu lub żądaniem informacji o miejscu (nowym) z użyciem pól z informacji o miejscu w wersji 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.
-
Informacje o miejscu (nowe) lub żądanie weryfikacji adresu: opłata jest naliczana również za żądanie kończące w ramach odpowiedniego SKU:
- Żądania kończące informacje o miejscu (nowe) są rozliczane w ramach SKU: informacje o miejscu Enterprise + Atmosfera, niezależnie od żądanych pól.
- Żądania kończące weryfikację adresu są rozliczane według SKU: Weryfikacja adresu – wersja Enterprise.
Scenariusze cenowe sesji
3 najczęstsze scenariusze cenowe sesji to:
- Autouzupełnianie danych o lokalizacji
- Autouzupełnianie podczas wyszukiwania miejsc
- Autouzupełnianie danych podczas płatności i dostawy
W sekcjach poniżej opisujemy poszczególne opłaty za rozliczenia w każdym scenariuszu.
Autouzupełnianie danych o lokalizacji
W scenariuszu autouzupełniania danych o lokalizacji chcesz użyć funkcji Autouzupełnianie (nowa) i Szczegóły miejsca (nowe), aby uzyskać informacje o miejscu. 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 do usługi Informacje o miejscu (nowej), które żąda pól zdefiniowanych przez SKU: Informacje o miejscu Essentials.
Opłaty są naliczane 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 żadne opłaty.
- Żądanie informacji o miejscu (New) jest rozliczane według SKU: Places API Place Details Essentials.
Autouzupełnianie podczas wyszukiwania miejsc
W scenariuszu autouzupełniania w celu odkrywania miejsc interesuje Cię uzyskanie nie tylko danych o lokalizacji miejsca. Możesz na przykład poprosić o wykonanie tych czynności:
- Opcje ułatwień dostępu
- Obecne 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 Place Details (New) Pro, Enterprise lub Enterprise + Atmosphere.
Opłaty są naliczane w ten sposób:
- Wszystkie żądania autouzupełniania (nowe) są rozliczane według kodu SKU: wykorzystanie sesji autouzupełniania, co oznacza, że za te żądania nie są naliczane żadne 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łaty są naliczane w ten sposób:
- Wszystkie żądania autouzupełniania (nowe) są rozliczane według kodu SKU: wykorzystanie sesji autouzupełniania, co oznacza, że za te żądania nie są naliczane żadne 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 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 każde żądanie wysłane do usługi Autocomplete (New) według SKU: żądania autouzupełniania.
Ceny za niekompletne lub przerwane sesje
Jeśli sesja zostanie porzucona, czyli nie zostanie zakończona wywołaniem informacji o miejscu (New) lub Weryfikacja adresów, Autocomplete (New), żądania autouzupełniania (nowe) wracają do modelu cenowego za żądanie i są rozliczane zgodnie z SKU: Autocomplete Requests.