Google zaleca korzystanie z sesji z Autouzupełnianiem (New). Sesje upraszczają rozliczenia i zapewniają spójny model cenowy do użycia z Autouzupełnianiem (New).
Sesja rozpoczyna się od pierwszego żądania Autouzupełniania (New), które zawiera token sesji, trwa przez każde kolejne żądanie Autouzupełniania (New), a następnie jest zamykana przez żądanie Informacji o miejscu (New) lub Weryfikacji adresu, które używa tokena sesji.
Po zakończeniu sesji każde wywołanie Autouzupełniania (New), Informacji o miejscu (New) lub Weryfikacji adresu , które używa wygasłego tokena sesji, jest rozliczane tak, jakby nie było tokena sesji.
Niepełne sesje, czyli sesje, które nie są zamykane przez żądanie Informacji o miejscu (New) lub Weryfikacji adresu, są rozliczane tylko za żądania Autouzupełniania (New) przy użyciu kodu SKU: Autocomplete Requests.
Rozliczenia za sesje
Sesje kończące się żądaniem Informacji o miejscu (New) Essentials
W przypadku sesji Autouzupełniania (New), które kończą się żądaniem używającym pól z kodu SKU: Places API informacje o miejscu Essentials:
- Pierwsze 12 żądań Autouzupełniania (New): opłata jest naliczana za każde żądanie Autouzupełniania (New) do maksymalnie 12 żądań przy użyciu kodu SKU: Autocomplete Requests.
- Żądania Autouzupełniania (New) od 13. w tej samej sesji: opłata jest naliczana według kodu SKU: Autocomplete Session Usage, co oznacza, że te żądania są bezpłatne.
- Informacje o miejscu (New) Essentials: opłata jest też naliczana za żądanie kończące sesję według kodu SKU: Places API Place Details Essentials.
Sesje kończące się żądaniami Weryfikacji adresu lub Informacji o miejscu (New) (nie Essentials)
W przypadku sesji Autouzupełniania (New), które kończą się żądaniem Weryfikacji adresu lub żądaniem Informacji o miejscu (New) używającym pól z Informacji o miejscu Pro, Enterprise lub Enterprise + Atmosphere:
- Żądania Autouzupełniania (New): wszystkie żądania Autouzupełniania (New) są rozliczane według kodu SKU: Autocomplete Session Usage, co oznacza, że te żądania są bezpłatne.
-
Żądanie Informacji o miejscu (New) lub Weryfikacji adresu: opłata jest też naliczana za żądanie kończące sesję według odpowiedniego kodu SKU:
- Żądania kończące sesję Informacji o miejscu (New) są rozliczane według kodu SKU: Place Details Enterprise + Atmosphere, niezależnie od żądanych pól.
- Żądania kończące sesję Weryfikacji adresu są rozliczane według kodu SKU: Address Validation Enterprise.
Scenariusze rozliczeń za sesje
3 najczęstsze scenariusze rozliczeń za sesje to:
- Autouzupełnianie danych o lokalizacji
- Autouzupełnianie do wyszukiwania miejsc
- Autouzupełnianie do płatności i dostawy
W kolejnych sekcjach opisujemy poszczególne opłaty za każdy scenariusz.
Autouzupełnianie danych o lokalizacji
W scenariuszu Autouzupełnianie danych o lokalizacji chcesz używać Autouzupełniania (New) i Informacji o miejscu (New), aby uzyskać informacje o lokalizacji miejsca. Na przykład wybierasz sugestię z Autouzupełniania (New), a następnie używasz Informacji o miejscu (New), 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
Ta sesja jest zamykana przez jedno żądanie Informacji o miejscu (New), które żąda pól zdefiniowanych przez kod SKU: Place Details Essentials.
Opłaty są naliczane w ten sposób:
- Pierwsze 12 żądań Autouzupełniania (New) jest rozliczanych według kodu SKU: Autocomplete Requests.
- Pozostałe żądania Autouzupełniania (New) są rozliczane według kodu SKU: Autocomplete Session Usage, co oznacza, że te żądania są bezpłatne.
- Żądanie Informacji o miejscu (New) kończące sesję jest rozliczane według kodu SKU: Places API Place Details Essentials.
Autouzupełnianie do wyszukiwania miejsc
W scenariuszu Autouzupełnianie do wyszukiwania 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 zamykana przez jedno żądanie Informacji o miejscu (New), które żąda dowolnych pól zawartych w kodach SKU Informacji o miejscu (New) Pro, Enterprise lub Enterprise + Atmosphere.
Opłaty są naliczane w ten sposób:
- Wszystkie żądania Autouzupełniania (New) są rozliczane według kodu SKU: Autocomplete Session Usage, co oznacza, że te żądania są bezpłatne.
- Żądanie Informacji o miejscu (New) kończące sesję jest rozliczane według kodu SKU: Places API Place Details Enterprise + Atmosphere.
Autouzupełnianie do płatności i dostawy
Interfejs Address Validation API to usługa, która akceptuje adres. Identyfikuje i weryfikuje komponenty adresu. Standaryzuje też adres na potrzeby wysyłki pocztą i znajduje dla niego najlepiej dopasowane współrzędne geograficzne.
W scenariuszu Autouzupełnianie do płatności i dostawy zamykasz sesję żądaniem do interfejsu Address Validation API aby zweryfikować wybrany adres.
Opłaty są naliczane w ten sposób:
- Wszystkie żądania Autouzupełniania (New) są rozliczane według kodu SKU: Autocomplete Session Usage, co oznacza, że te żądania są bezpłatne.
- Opcjonalne żądanie Informacji o miejscu Essentials jest bezpłatne, jeśli zostanie wysłane przed żądaniem Weryfikacji adresu kończącym sesję.
- Żądanie Weryfikacji adresu kończące sesję jest rozliczane według kodu SKU: Address Validation Enterprise.
Ceny bez sesji
Jeśli nie używasz sesji, opłata jest naliczana za każde żądanie Autouzupełniania (New) według kodu SKU: Autocomplete Requests.
Ceny za niepełne lub porzucone sesje
Jeśli sesja zostanie porzucona, czyli nie zostanie zamknięta przez wywołanie Informacji o miejscu (New) lub Weryfikacji adresu, żądania Autouzupełniania (New) wracają do modelu rozliczeń za żądanie i są rozliczane według kodu SKU: Autocomplete Requests.