Autouzupełnianie miejsc (starsza wersja) używa tokenów sesji do grupowania etapów zapytania i wyboru wyszukiwania z autouzupełnianiem przez użytkownika w osobną sesję na potrzeby rozliczeń. Sesja rozpoczyna się, gdy użytkownik zaczyna wpisywać zapytanie, a kończy, gdy wybiera miejsce i wywoływana jest usługa informacje o miejscu (starsza wersja). Każda sesja może zawierać wiele zapytań autouzupełniania, po których następuje wybór jednego miejsca. Klucze interfejsu API używane w przypadku każdego żądania w ramach sesji muszą należeć do tego samego projektu w konsoli Google Cloud. Po zakończeniu sesji token traci ważność. Aplikacja musi wygenerować nowy token dla każdej sesji. Jeśli parametr sessiontoken zostanie pominięty lub jeśli użyjesz ponownie tokena sesji, sesja zostanie rozliczona tak, jakby nie podano tokena sesji (każde żądanie jest rozliczane osobno).
Zalecamy stosowanie się do tych wskazówek:
- Używaj tokenów sesji we wszystkich sesjach autouzupełniania.
- Wygeneruj nowy token dla każdej sesji.
- Upewnij się, że klucze interfejsu API używane we wszystkich żądaniach Autouzupełniania miejsc (starsza wersja) i informacji o miejscu (starsza wersja) w ramach sesji należą do tego samego projektu w konsoli Google Cloud.
- Pamiętaj, aby przekazywać unikalny token sesji dla każdej nowej sesji. Użycie tego samego tokena w więcej niż 1 sesji spowoduje, że każde żądanie będzie rozliczane osobno.
Możesz opcjonalnie pominąć token sesji autouzupełniania w żądaniu. Jeśli token sesji zostanie pominięty, każde żądanie będzie rozliczane osobno, co spowoduje naliczenie opłaty za kod SKU Autouzupełnianie – za żądanie. Jeśli użyjesz ponownie tokena sesji, sesja zostanie uznana za nieprawidłową, a żądania zostaną rozliczone tak, jakby nie podano tokena sesji.
Przykład
Gdy użytkownik wpisuje zapytanie, żądanie autouzupełniania jest wywoływane co kilka naciśnięć klawiszy (nie dla każdego znaku) i zwracana jest lista możliwych wyników. Gdy użytkownik wybierze coś z listy wyników, wybór ten jest liczony jako żądanie, a wszystkie żądania wysłane podczas wyszukiwania są grupowane i liczone jako jedno żądanie. Jeśli użytkownik wybierze miejsce, zapytanie jest dostępne bezpłatnie, a opłata jest naliczana tylko za żądanie danych o miejscu. Jeśli użytkownik nie dokona wyboru w ciągu kilku minut od rozpoczęcia sesji, zostanie naliczona opłata tylko za wyszukiwane hasło.
Rozważ ten przepływ zdarzeń z perspektywy aplikacji:
- Użytkownik zaczyna wpisywać zapytanie, aby wyszukać „Paryż, Francja”.
- Po wykryciu danych wejściowych użytkownika aplikacja tworzy nowy token sesji, „Token A”.
- Gdy użytkownik wpisuje tekst, interfejs API co kilka znaków wysyła żądanie autouzupełniania, wyświetlając nową listę potencjalnych wyników dla każdego z nich:
„P”
„Par”
„Paris,”
„Paris, Fr”
- Gdy użytkownik dokona wyboru:
- Wszystkie żądania wynikające z zapytania są grupowane i dodawane do sesji reprezentowanej przez „Token A” jako jedno żądanie.
- Wybór użytkownika jest liczony jako żądanie informacji o miejscu i dodawany do sesji reprezentowanej przez „Token A”.
- Sesja zostaje zakończona, a aplikacja odrzuca „Token A”.
Więcej informacji o tym, jak rozliczane są żądania autouzupełniania miejsc (starsza wersja), znajdziesz w artykule Użycie i rozliczenia.
Tworzenie tokenów sesji
Aby utworzyć token sesji, wywołaj GMSAutocompleteSessionToken.init().