Google zaleca korzystanie z sesji z autouzupełnianiem (nowość). Sesje pomagają uprościć cennik i zapewnić spójny model cenowy do stosowania z funkcją autouzupełniania (nowość).
Ceny sesji rozpoczynają się od pierwszego żądania autouzupełniania (nowego) zawierającego token sesji, są kontynuowane przez każde kolejne żądanie autouzupełniania (nowe), a następnie zostają zakończone przez żądanie przesłania szczegółów nowego miejsca lub weryfikacji adresu korzystającego z tokena sesji.
Po zakończeniu sesji każde wywołanie autouzupełniania (Nowy), Szczegóły miejsca (Nowe) lub Weryfikacja adresu korzystające z nieaktualnego tokena sesji jest rozliczane tak, jakby nie było żadnego tokena sesji.
Niepełne sesje, czyli sesje, które nie zostały kończone żądaniem dodania informacji o miejscu (nowym) ani weryfikacji adresu, są rozliczane tylko za żądania autouzupełniania używane w ramach żądania SKU: Autocomplete Requests (SKU: żądania autouzupełniania).
3 najczęstsze scenariusze cenowe to:
- Autouzupełnianie danych o lokalizacji
- Autouzupełnianie przy wykrywaniu miejsc
- Autouzupełnianie podczas procesu płatności i dostawy
Autouzupełnianie danych o lokalizacji
W takiej sytuacji warto korzystać z autouzupełniania i szczegółów miejsca (nowego), aby uzyskać informacje o lokalizacji. Na przykład wybierasz sugestię z autouzupełniania, a następnie używasz Szczegóły miejsca (Nowe), aby uzyskać współrzędne szerokości i długości geograficznej miejsca, aby pokazać je na mapie.
Informacje o lokalizacji mogą obejmować:
- Adres
- Lokalizacja jako szerokość i długość geograficzna
- Plus Code
- Typy
- Widoczny obszar
Ta sesja kończy się pojedynczym żądaniem przesłania nowych informacji o miejscu, które wysyła żądanie informacji o dowolnych polach zdefiniowanych przez kod SKU: Place Details (Location Only).
Opłaty są naliczane w następujący sposób:
- Każde żądanie autouzupełniania (nowe) maksymalnie 12 żądań z użyciem SKU: prośby o autouzupełnianie.
- Stawka wynosi 2,83 USD za 1000 żądań do 100 000 żądań
- Stawka wynosi 2,27 USD za 1000 żądań do 500 000 żądań
- Żądania autouzupełniania (nowe) o numerze 13 i nowszym, gdy jesteś w aktywnej sesji, są rozliczane na podstawie SKU: Autocomplete Session Usage (Wykorzystanie autouzupełniania w sesji), co oznacza, że nie są za nie naliczane żadne opłaty.
- Prośba o dane o jednym miejscu z wykorzystaniem identyfikatora SKU: Place Details (Location only) (Tylko lokalizacja):
- Stawka 5 USD za 1000 żądań do 100 000 żądań
- Opłaty są naliczane w wysokości 4 USD za każde 1000 żądań do 500 000 żądań
Autouzupełnianie przy wykrywaniu miejsc
W scenariuszu z autouzupełnianiem do odkrywania miejsc chcesz uzyskać 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 takiej sytuacji sesja kończy się żądaniem przesłania informacji o miejscu (nowych) z żądaniem wszelkich pól zawartych w informacjach o miejscu (nowych), podstawowych, zaawansowanych lub preferowanych.
Opłaty są naliczane w następujący sposób:
- Wszystkie żądania autouzupełniania (nowe) są rozliczane na podstawie SKU: Autocomplete Session Usage (Wykorzystanie autouzupełniania w sesji), co oznacza, że nie są za nie pobierane żadne opłaty.
- 1 żądanie SKU: Szczegóły miejsca (preferowane):
- Stawka 25 USD za 1000 żądań do 100 000 żądań
- Stawka 20 USD za każde 1000 żądań do 500 tys.żądań
Autouzupełnianie podczas procesu płatności i dostawy
Interfejs Address Validation API to usługa, która akceptuje adres. Identyfikuje komponenty adresu i weryfikuje je. Standaryzuje też adres do wysyłki i znajduje najbardziej znane dla niego współrzędne szerokości i długości geograficznej.
W scenariuszu autouzupełniania przy finalizowaniu zakupu i dostawy kończysz sesję, przesyłając do interfejsu API do weryfikacji adresów żądanie weryfikacji wybranego adresu. Opłaty są naliczane w następujący sposób:
- Wszystkie żądania autouzupełniania (nowe) są rozliczane na podstawie SKU: Autocomplete Session Usage (Wykorzystanie autouzupełniania w sesji), co oznacza, że nie są za nie pobierane żadne opłaty.
- Jedna prośba w ramach funkcji SKU: Preferowana weryfikacja adresu:
- Stawka 25 USD za 1000 żądań do 100 000 żądań
- Stawka 20 USD za każde 1000 żądań do 500 tys.żądań
Przykładowe ceny
W tabeli poniżej znajdziesz przykłady cen w przypadku 3 głównych scenariuszy sesji. Ta tabela zawiera też listę kodów SKU, które pojawiają się na zestawieniu operacji w przypadku każdego scenariusza.
| Scenariusz | Przykład żądania | Płatne kody SKU | Cena za 1000 żądań |
|---|---|---|---|
| Dane o lokalizacji |
|
|
|
| Odkrywanie miejsc |
|
|
|
| Płatność i dostawa |
|
|
Przykład cen bez sesji
Jeśli nie używasz sesji, będziesz płacić za każde żądanie autouzupełniania (nowe) za każde żądanie autouzupełniania (SKU: autocomplete Requests) w wysokości 2,83 USD za każde 1000 żądań.
Cena zastępcza w przypadku nieukończonych lub porzuconych sesji
Jeśli sesja zostanie porzucona, czyli nie zostanie zakończona przez wywołanie szczegółów miejsca (Nowe) lub weryfikację adresu, żądania autouzupełniania (nowe) są przywracane do modelu cenowego opartego na żądaniach i są rozliczane na kwotę 2,83 USD za 1000 żądań zgodnie z definicją w SKU: żądania autouzupełniania.