Токены сеанса

Выберите платформу: Android iOS Веб-служба JavaScript

Поместите автозаполнение использования токенов сеанса для сгруппирования этапов запроса и выбора пользователя, автозаполненного поиском в дискретный сеанс для выставления счетов. Сеанс начинается, когда пользователь начинает печатать запрос, и завершается, когда он выбирает место, и призыв к размещению. Каждый сеанс может иметь несколько автозаполненных запросов, за которыми следуют один выбор. Ключ (ы) API, используемый для каждого запроса в сеансе, должен принадлежать к одному и тому же проекту Google Cloud Console. Как только сессия завершится, токен больше не является действительным; Ваше приложение должно генерировать свежий токен для каждого сеанса. Если параметр sessiontoken опущен, или если вы повторно используете токен сеанса, сеанс взимается так, как если бы токен сеанса не был предоставлен (каждый запрос выставлен отдельно).

Мы рекомендуем следующие рекомендации:

  • Используйте токены сеанса для всех сеансов автозаполнения.
  • Создайте свежий токен для каждого сеанса.
  • Убедитесь, что ключ (ы) API, используемые для всех автозаполнения места, и поместите запросы сведений в рамках сеанса, принадлежат к одному и тому же проекту Cloud Console Google.
  • Обязательно пройдите уникальный токен сеанса для каждого нового сеанса. Использование одного и того же ближеств для более чем одного сеанса приведет к тому, что каждый запрос будет выставлен индивидуально.

При желании вы можете опустить токен сеанса автозаполнения из запроса. Если токен сеанса опущен, каждый запрос выставлен отдельно, запуская автозаполнение - по запросу SKU. Если вы повторно используете токен сессии, сеанс считается недействительным, а запросы взимаются так, как если бы токен сеанса не был предоставлен.

Пример

Поскольку пользователь вводит запрос, запрос на автозаполнение называется каждые несколько нажатий клавиш (не на символ), и возвращается список возможных результатов. Когда пользователь делает выбор из списка результатов, выбор считается запросом, и все запросы, сделанные во время поиска, связаны и считаются как единый запрос. Если пользователь выбирает место, поисковый запрос доступен бесплатно, и заряжен только запрос на данные места. Если пользователь не делает выбор в течение нескольких минут после начала сеанса, заряжается только поисковый запрос.

Давайте рассмотрим этот поток событий с точки зрения приложения.

  1. Пользователь начинает печатать запрос для поиска «Париж, Франция».
  2. После обнаружения пользовательского ввода приложение создает новый токен сеанса «Токен A».
  3. Как типы пользователей, API делает запрос на автозаполнение каждые несколько символов, отображая новый список потенциальных результатов для каждого:
    "П"
    "PAR"
    "Париж,"
    "Париж, фр"
  4. Когда пользователь делает выбор:
    • Все запросы, полученные в результате запроса, сгруппированы и добавляются в сеанс, представленную «токеном A», в качестве единого запроса.
    • Выбор пользователя считается запросом на подробную информацию и добавляется в сеанс, представленную «токеном A».
  5. Сессия завершается, и приложение отбрасывает «токен A».

Для получения дополнительной информации о том, как выставляются счета за запросы на автозаполнение, см. Использование и выставление счетов .

Создать токены сеанса

Чтобы создать токен сеанса, позвоните GMSAutocompleteSessionToken.init() .