Как использовать токены сеансов

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

Токены сеансов группируют этапы запроса и выбора выполняемого пользователем поиска с функцией автозаполнения в отдельный сеанс для выставления счетов.

Как создать токен сеанса

Пользователи должны генерировать уникальные токены для каждого сеанса. Google рекомендует использовать UUID версии 4.

Пример

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

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

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

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