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

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

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

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

Пример

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

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

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

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