Google zaleca używanie sesji z autouzupełnianiem (nowym). Sesje upraszczają cennik i zapewniają spójny model cenowy do użycia z funkcją Autocomplete (nowa).
Ceny sesji zaczynają się od pierwszego żądania Autocomplete (New), które zawiera token sesji, i są naliczane za każde kolejne żądanie Autocomplete (New). Sesja 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.
Niekompletne sesje, czyli sesje, które nie są kończone przez żądanie szczegółów miejsca (nowe) lub weryfikacji adresu, są rozliczane tylko za żądania autouzupełniania przy użyciu SKU: żądania autouzupełniania.
3 najczęstsze scenariusze cenowe to:
- Autouzupełnianie danych o lokalizacji
- Autouzupełnianie podczas odkrywania miejsc
- Autouzupełnianie podczas płatności i dostawy
Autouzupełnianie danych o lokalizacji
W tym scenariuszu chcesz użyć autouzupełniania i szczegółów miejsca (nowych), aby uzyskać informacje o lokalizacji miejsca. Na przykład wybierasz sugestię z autouzupełniania, a następnie 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 jest zamykana przez pojedyncze żądanie do usługi Szczegóły miejsca (nowa), które zawiera prośbę o dowolne pola zdefiniowane przez wersję: Szczegóły miejsca Essentials.
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. W przypadku sesji Autouzupełnianie (nowe) opłaty są naliczane w ten sposób:
- 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ń Autocomplete (New) o numerze 13 i wyższym w ramach tej samej sesji: opłata jest naliczana według SKU: Autocomplete Session Usage, co oznacza, że za te żądania nie są pobierane żadne opłaty.
- Prośba o szczegóły miejsca lub weryfikację adresu: opłata jest naliczana również za prośbę końcową przy użyciu tych kodów SKU.
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 tych czynności:
- Opcje ułatwień dostępu
- Aktualne godziny otwarcia
- Możliwości parkowania
- Opinie
- Oceny
W tym scenariuszu sesja jest zamykana przez żądanie szczegółów miejsca (nowe), które zawiera dowolne pola uwzględnione w pakietach szczegółów miejsca (nowe) Pro, Enterprise lub Enterprise + Atmosphere.
Opłata jest naliczana w ten sposób:
- Wszystkie żądania autouzupełniania (nowego) są rozliczane według SKU: Autocomplete Session Usage, co oznacza, że nie są one obciążane opłatą.
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 najlepsze znane współrzędne długości i szerokości geograficznej.
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 (nowego) są rozliczane według SKU: Autocomplete Session Usage, co oznacza, że nie są one obciążane opłatą.
- Opcjonalne żądanie SKU: Place Details Essentials.
- Jeden SKU: Address Validation Enterprise request.
Przykłady cen
W tabeli poniżej znajdziesz przykłady cen w 3 głównych scenariuszach sesji. W tabeli podane są też kody SKU, które pojawiają się na wyciągu z płatności w każdym scenariuszu.
| Scenariusz | Przykładowe żądanie | Kody SKU, za które naliczono opłaty | Żądania, za które naliczono opłaty |
|---|---|---|---|
| Dane o lokalizacji |
|
|
|
| Odkrywanie miejsc |
|
|
|
| Płatność i dostawa |
|
|
Przykład cen bez sesji
Jeśli nie używasz sesji, opłaty są naliczane za każde żądanie wysłane do interfejsu Autocomplete (New) zgodnie z SKU: żądania Autocomplete.
Ceny rezerwowe w przypadku niekompletnych lub porzuconych sesji
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.