Токены сессии объединяют этапы запроса и выбора в поиске с автозаполнением в отдельную сессию для целей выставления счетов.
Создайте токен сессии
Пользователи несут ответственность за генерацию уникальных токенов сессии для каждой сессии. Google рекомендует использовать UUID версии 4 .
Пример
По мере ввода пользователем запроса, запрос автозаполнения вызывается каждые несколько нажатий клавиш (не для каждого символа), и возвращается список возможных результатов. Когда пользователь выбирает что-либо из списка результатов, выбор считается запросом, и все запросы, сделанные во время поиска, объединяются и учитываются как один запрос. Если пользователь выбирает место, поисковый запрос доступен бесплатно, и оплачивается только запрос данных о месте. Если пользователь не делает выбор в течение нескольких минут с начала сессии, оплачивается только поисковый запрос.
Давайте рассмотрим эту последовательность событий с точки зрения приложения.
Пользователь начинает вводить поисковый запрос, чтобы найти "Париж, Франция".
После получения ввода от пользователя приложение создает новый токен сессии, "Токен А".
По мере ввода пользователем текста API отправляет запрос автозаполнения каждые несколько символов, отображая для каждого из них новый список возможных результатов: "П" "Пар" "Париж," "Париж, Франция"
Когда пользователь делает выбор:
Все запросы, возникающие в результате выполнения запроса, группируются и добавляются к сессии, представленной "Токеном А", как единый запрос.
Выбор пользователя учитывается как запрос сведений о месте и добавляется в сессию, представленную "токеном A".
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-12-16 UTC."],[],["This document details the use of session tokens with the Places API. A session token groups a user's autocomplete search into a single session for billing. Users must create unique session tokens (version 4 UUIDs recommended) for each session, ensuring uniqueness within a project. Requests are bundled into a session. If a user selects a place, only the place details are charged; otherwise, only the search query is charged. Each session ends after a user's selection or inactivity, at which point the token is discarded.\n"]]