Google рекомендует использовать сеансы с функцией Autocomplete (New) . Сеансы помогают упростить ценообразование и обеспечивают согласованную модель ценообразования для использования с функцией Autocomplete (New).
Ценообразование сеанса начинается с первого запроса Autocomplete (New), который включает токен сеанса, продолжается для каждого последующего запроса Autocomplete (New), а затем завершается запросом Place Details (New) или Address Validation, который использует токен сеанса.
После завершения сеанса любой вызов Autocomplete (новый), Place Details (новый) или Address Validation, использующий просроченный токен сеанса, тарифицируется так, как если бы токена сеанса не было.
Незавершенные сеансы, то есть сеансы, которые не были завершены запросом на получение сведений о месте (новых) или проверку адреса, оплачиваются только за запросы на автозаполнение с использованием артикула: Запросы на автозаполнение .
Три наиболее распространенных сценария ценообразования:
- Автозаполнение данных о местоположении
- Автозаполнение для поиска места
- Автозаполнение для оформления заказа и доставки
Автозаполнение данных о местоположении
В этом сценарии вы заинтересованы в использовании Autocomplete и Place Details (New) для получения информации о местоположении места. Например, вы выбираете предложение из autocomplete, а затем используете Place Details (New) для получения координат широты и долготы места, чтобы показать это место на карте.
Информация о местоположении может включать в себя:
- Адрес
- Местоположение в виде координат широты и долготы
- Плюс Код
- Типы
- Видовой порт
Этот сеанс завершается одним запросом к Place Details (New), который запрашивает все поля, определенные в SKU: Place Details Essentials .
Сеанс начинается с первого запроса Autocomplete (New), который включает токен сеанса, продолжается через каждый последующий запрос Autocomplete (New), а затем завершается запросом Place Details (New) или Address Validation, который использует токен сеанса. Для сеанса Autocomplete (New) счет выставляется следующим образом:
- Первые 12 запросов автозаполнения (новых) : счет выставляется за каждый запрос автозаполнения (новый), максимум до 12 запросов, с использованием артикула: Запросы автозаполнения .
- Для запросов автозаполнения (новых) 13 и более в одном сеансе : счет выставляется по артикулу: «Использование сеанса автозаполнения» , то есть плата за эти запросы не взимается.
- Запрос на проверку сведений о местах или адреса: вам также будет выставлен счет за завершение запроса с использованием этих артикулов.
Автозаполнение для поиска места
В сценарии Autocomplete for place discovery вы заинтересованы в получении большего, чем просто данных о местоположении. Например, вы можете запросить что-либо из следующего:
- Параметры доступности
- Текущие часы работы
- Варианты парковки
- Обзоры
- Рейтинги
В этом сценарии ваш сеанс завершается запросом к Place Details (New), который запрашивает все поля, включенные в SKU Place Details (New) Pro , Enterprise или Enterprise + Atmosphere .
Затем вам будет выставлен счет следующим образом:
- Все запросы автозаполнения (новые) тарифицируются по SKU: Autocomplete Session Usage , то есть плата за эти запросы не взимается.
Автозаполнение для оформления заказа и доставки
API проверки адреса — это сервис, который принимает адрес. Он идентифицирует компоненты адреса и проверяет их. Он также стандартизирует адрес для почтовой рассылки и находит для него самые известные координаты широты и долготы.
В сценарии автозаполнения для оформления заказа и доставки вы завершаете сеанс запросом к API проверки адреса для проверки выбранного адреса. Затем вам выставляется счет следующим образом:
- Все запросы автозаполнения (новые) тарифицируются по SKU: Autocomplete Session Usage , то есть плата за эти запросы не взимается.
- Необязательный запрос SKU: Place Details Essentials .
- Один артикул: запрос предприятия на проверку адреса .
Примеры ценообразования
В следующей таблице показаны примеры ценообразования для трех основных сценариев сеанса. В этой таблице также перечислены SKU, которые отображаются в вашем счете для каждого сценария.
| Сценарий | Запросить пример | SKU выставлены счета | Запросы выставлены счетом |
|---|---|---|---|
| Данные о местоположении |
|
| |
| Место обнаружения |
|
| |
| Оформление заказа и доставка |
|
|
Пример расчета цены без учета сессий
Если вы не используете сеансы, вам будет выставлен счет за каждый запрос к Autocomplete (New) с использованием SKU: Autocomplete Requests .
Резервное ценообразование для незавершенных или прерванных сеансов
Если сеанс прерван, то есть не завершен вызовом Place Details (New) или Address Validation, запросы Autocomplete (New) возвращаются к модели ценообразования на основе запроса и оплачиваются в соответствии с артикулом: Autocomplete Requests .