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: żądania autouzupełniania.
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: żądania autouzupełniania.
- W przypadku żądań autouzupełniania (New) od 13. w tej samej sesji: opłata jest naliczana według kodu SKU: wykorzystanie sesji autouzupełniania, 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 – informacje o miejscu – 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: wykorzystanie sesji autouzupełniania, 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: informacje o miejscu Enterprise + Atmosphere, niezależnie od żądanych pól.
- Żądania kończące sesję weryfikacji adresu są rozliczane według kodu SKU: weryfikacja adresu Enterprise.
Scenariusze cenowe sesji
3 najczęstsze scenariusze cenowe sesji to:
- Autouzupełnianie danych o lokalizacji
- Autouzupełnianie do odkrywania miejsc
- Autouzupełnianie do płatności i dostawy
W kolejnych sekcjach opisujemy poszczególne opłaty w każdym scenariuszu.
Autouzupełnianie danych o lokalizacji
W scenariuszu autouzupełniania 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 szerokości i długości geograficznej miejsca i wyświetlić je na mapie.
Informacje o lokalizacji mogą obejmować:
- Adres
- Lokalizacja jako współrzędne szerokości i długości geograficznej
- Plus Code
- Typy
- Widoczny obszar
Ta sesja jest zamykana przez pojedyncze żądanie informacji o miejscu (New), które żąda pól zdefiniowanych przez kod SKU: informacje o miejscu Essentials.
Opłata jest naliczana w ten sposób:
- Pierwsze 12 żądań autouzupełniania (New) jest rozliczanych według kodu SKU: żądania autouzupełniania.
- Wszystkie pozostałe żądania autouzupełniania (New) są rozliczane według kodu SKU: wykorzystanie sesji autouzupełniania, 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 – informacje o miejscu – Essentials.
Autouzupełnianie do odkrywania miejsc
W scenariuszu autouzupełniania do 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 zamykana przez pojedyncze żą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łata jest naliczana w ten sposób:
- Wszystkie żądania autouzupełniania (New) są rozliczane według kodu SKU: wykorzystanie sesji autouzupełniania, 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 – informacje o miejscu – 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 poczty i znajduje dla niego najlepiej dopasowane współrzędne szerokości i długości geograficznej.
W scenariuszu autouzupełniania do płatności i dostawy zamykasz sesję żądaniem do interfejsu Address Validation API aby zweryfikować wybrany adres.
Opłata jest naliczana w ten sposób:
- Wszystkie żądania autouzupełniania (New) są rozliczane według kodu SKU: wykorzystanie sesji autouzupełniania, 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: weryfikacja adresu Enterprise.
Ceny bez sesji
Jeśli nie używasz sesji, opłata jest naliczana za każde żądanie autouzupełniania (New) przy użyciu kodu SKU: żądania autouzupełniania.
Ceny za niepełne lub porzucone sesje
Jeśli sesja zostanie porzucona, czyli nie zostanie zakończona przez wywołanie informacji o miejscu (New) lub weryfikacji adresu, żądania autouzupełniania (New) wracają do modelu cenowego za żądanie i są rozliczane według kodu SKU: żądania autouzupełniania.