Google zaleca korzystanie z sesji z autouzupełnianiem (nowa wersja). Sesje ułatwiają uproszczenie cen i zapewniają spójny model cenowy do wykorzystania z Autouzupełnianiem (nowy).
Stawki sesji zaczynają się od pierwszego zapytania Autocomplete (Nowe), które zawiera token sesji, kontynuują się w każdym kolejnym zapytaniu Autocomplete (Nowe), a następnie są zakończone zapytaniem do funkcji Szczegóły miejsca (Nowe) lub Walidacja adresu, które używają tokenu sesji.
Po zakończeniu sesji każde wywołanie funkcji Autouzupełnianie (Nowa), Szczegóły miejsca (Nowa) lub Weryfikacja adresu, które korzysta z wygasłego tokena sesji, jest rozliczane tak, jakby nie było tokena sesji.
Niepełne sesje, czyli sesje, które nie zostały zakończone przez żądanie dotyczące szczegółów miejsca docelowego (nowego) lub weryfikację adresu, są rozliczane tylko za żądania autouzupełniania za pomocą SKU: żądania autouzupełniania.
3 najczęstsze scenariusze ustalania cen:
- Autouzupełnianie danych o lokalizacji
- Autouzupełnianie w przypadku wykrywania miejsc
- Autouzupełnianie danych podczas płatności i dostawy
Autouzupełnianie danych o lokalizacji
W tym scenariuszu chcesz użyć autouzupełniania i Szczegółów miejsca (Nowe), aby uzyskać informacje o lokalizacji danego miejsca. Na przykład wybierasz sugestię z autouzupełniania, a potem używasz szczegółów miejsca (Nowe), aby uzyskać współrzędne geograficzne szerokości i długości tego miejsca i wyświetlić je na mapie.
Informacje o lokalizacji mogą obejmować:
- Adres
- lokalizacja podana jako współrzędne szerokości i długości geograficznej;
- Plus Code
- Typy
- Widoczny obszar
Ta sesja jest zamykana przez pojedyncze żądanie dotyczące szczegółów miejsca (nowe), które zawiera żądanie dowolnych pól zdefiniowanych przez SKU: podstawowe informacje o miejscu.
Sesja rozpoczyna się od pierwszego żądania Autocomplete (New), które zawiera token sesji, trwa przez kolejne żądania Autocomplete (New) i kończy się żądaniem Details (New) lub Validation (New), które używa tokenu sesji. W przypadku sesji autouzupełniania (nowej) opłata jest naliczana w ten sposób:
- Pierwsze 12 żądań autouzupełniania (nowe): za każde żądanie autouzupełniania (nowe) do maksymalnej liczby 12 żądań naliczamy opłatę za pomocą kodu SKU: Autouzupełnianie (nowe).
- W przypadku żądań Autocomplete (New) 13 i wyższych w tej samej sesji: za te żądania nie są naliczane opłaty.
- Prośba o szczegóły miejsc lub weryfikację adresu: płacisz też za zakończenie prośby za pomocą tych kodów SKU.
Autouzupełnianie w przypadku wykrywania miejsc
W sytuacji autouzupełniania danych o miejscach interesuje Cię więcej niż tylko dane o lokalizacji. 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 zostaje zakończona przez żądanie wysłane do usługi Szczegóły miejsca (nowa), które zawiera dowolne pola z poziomu SKU Pro, Enterprise lub Enterprise + Atmosphere usługi Szczegóły miejsca (nowa).
Następnie naliczane są opłaty w ten sposób:
- Wszystkie żądania autouzupełniania (nowe) są rozliczane zgodnie z SKU: Autocomplete Session Usage, co oznacza, że te żądania są bezpłatne.
Autouzupełnianie danych podczas płatności i dostawy
Interfejs Address Validation API to usługa, która akceptuje adres. Identyfikuje komponenty adresu i je weryfikuje. Standardyzuje też adres na potrzeby wysyłki pocztą i znajduje dla niego najlepsze znane współrzędne szerokości i długości geograficznej.
W sytuacji autouzupełniania danych do płatności i dostawy sesja kończy się żądaniem wysłanym do interfejsu Address Validation API w celu zweryfikowania wybranego adresu. Następnie naliczane są opłaty w ten sposób:
- Wszystkie żądania autouzupełniania (nowe) są rozliczane zgodnie z SKU: Autocomplete Session Usage, co oznacza, że te żądania są bezpłatne.
- Opcjonalne żądanie SKU: podstawowe informacje o miejscu.
- Jedna prośba o SKU: Enterprise – weryfikacja adresu.
Przykłady cen
Poniższa tabela zawiera przykłady cen w przypadku 3 głównych scenariuszy sesji. Tabela zawiera też listę kodów SKU, które pojawiają się w Twoim wyciągu z konta w przypadku każdego scenariusza.
| Scenariusz | Przykład żądania | Zafakturowane jednostki magazynowe | Opłacone prośby |
|---|---|---|---|
| Dane o lokalizacji |
|
|
|
| Odkrywanie miejsc |
|
|
|
| Płatność i dostawa |
|
|
Przykład cen bez sesji
Jeśli nie korzystasz z sesji, płacisz za każdą prośbę o wypełnienie automatycznie (nowa) za pomocą atrybutu SKU: żądania dotyczące wypełniania automatycznie.
ceny zastępcze w przypadku niekompletnych lub przerwanych sesji,
Jeśli sesja zostanie przerwana, czyli nie zostanie zakończona przez wywołanie funkcji szczegółów miejsca docelowego (nowej) lub walidacji adresu, żądania funkcji Autocomplete (nowej) powracają do modelu cenowego za żądanie i są rozliczane zgodnie z SKU: żądania funkcji Autocomplete.