Использование API Places и выставление счетов

О полевых масках

Для функций «Подробная информация о месте» (новая), «Поиск поблизости» (новая) и «Текстовый поиск» (новая) используйте заголовок FieldMask в запросах API, чтобы указать список полей, которые должны быть возвращены в ответе. В этом случае оплата будет производиться по самому высокому SKU, применимому к вашему запросу. Это означает, что если вы выберете поля как в Essentials, так и в Pro SKU, оплата будет производиться по Pro SKU.

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

О сессиях автозаполнения (новые)

Сессия автозаполнения (новая) включает один или несколько запросов автозаполнения (новые) и запрос сведений о месте (новый) или запрос проверки адреса. Один и тот же токен сессии передается как в запрос автозаполнения (новый), так и в последующий запрос сведений о месте (новый) или запрос проверки адреса.

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

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

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

Информация о артикулах и ценах для Places API

В таблице ниже представлены подробные сведения о товарных позициях (SKU) и ценах на API Places.

Категория Информация о SKU API Places (новое) Цены по артикулам
Основные сведения Артикул: Запросы автозаполнения Основной прайс-лист
Прайс-лист для Индии
Основные сведения Артикул: Использование сессии автозаполнения Основной прайс-лист
Прайс-лист для Индии
Основные сведения Артикул: Товары первой необходимости для оформления заказа (только для удостоверений личности) Основной прайс-лист
Прайс-лист для Индии
Основные сведения Артикул: Place Details Essentials Основной прайс-лист
Прайс-лист для Индии
Основные сведения Артикул: Text Search Essentials (только для идентификаторов) Основной прайс-лист
Прайс-лист для Индии
Про Артикул: Nearby Search Pro Основной прайс-лист
Прайс-лист для Индии
Про Артикул: Place Details Pro Основной прайс-лист
Прайс-лист для Индии
Про Артикул: Text Search Pro Основной прайс-лист
Прайс-лист для Индии
Предприятие Артикул: Nearby Search Enterprise Основной прайс-лист
Прайс-лист для Индии
Предприятие Артикул: Поиск поблизости Enterprise + Atmosphere Основной прайс-лист
Прайс-лист для Индии
Предприятие Артикул: Place Details Enterprise Основной прайс-лист
Прайс-лист для Индии
Предприятие Артикул: Place Details Enterprise + Atmosphere Основной прайс-лист
Прайс-лист для Индии
Предприятие Артикул: Text Search Enterprise Основной прайс-лист
Прайс-лист для Индии
Предприятие Артикул: Text Search Enterprise + Atmosphere Основной прайс-лист
Прайс-лист для Индии
Предприятие Артикул: Подробности о месте Фотографии Основной прайс-лист
Прайс-лист для Индии
Категория Информация о SKU API Places (устаревшая версия) Цены по артикулам
Основные сведения Артикул: Автозаполнение - По запросу Основной прайс-лист
Прайс-лист для Индии
Основные сведения Артикул: Автозаполнение (входит в комплект поставки информации о месте) - За сессию Основной прайс-лист
Прайс-лист для Индии
Основные сведения

Артикул: Основные данные

Дополнительные сборы:

Основной прайс-лист
Прайс-лист для Индии
Основные сведения Артикул: Find Place - только ID Основной прайс-лист
Прайс-лист для Индии
Основные сведения Артикул: Place Details Essentials - ID Refresh Основной прайс-лист
Прайс-лист для Индии
Основные сведения Артикул: Автозаполнение запросов - по запросу Основной прайс-лист
Прайс-лист для Индии
Про Артикул: Автозаполнение без указания деталей места - за сессию Основной прайс-лист
Прайс-лист для Индии
Про

Артикул: Find Place

Дополнительные сборы:

Основной прайс-лист
Прайс-лист для Индии
Про

Артикул: Места - Поиск поблизости

Дополнительные сборы:

Основной прайс-лист
Прайс-лист для Индии
Про

Артикул: Места - Текстовый поиск

Дополнительные сборы:

Основной прайс-лист
Прайс-лист для Индии
Про

Артикул: Places Details

Дополнительные сборы:

Основной прайс-лист
Прайс-лист для Индии
Предприятие

Артикул: Данные об атмосфере

Дополнительные сборы:

Основной прайс-лист
Прайс-лист для Индии
Предприятие

Артикул: Контактные данные

Дополнительные сборы:

Основной прайс-лист
Прайс-лист для Индии
Предприятие Артикул: Place Photos Основной прайс-лист
Прайс-лист для Индии

Ограничения на использование

Чтобы просмотреть и управлять своими квотами и лимитами использования, см. раздел «Квоты и оповещения о квотах» .

  • API для работы с местами (новый) : лимит запросов в минуту устанавливается для каждого метода API и каждого проекта. Это означает, что для каждого метода API существует отдельная квота.

  • API Places (устаревшая версия) : лимит запросов в минуту рассчитывается как сумма запросов на стороне клиента и на стороне сервера для всех приложений, использующих учетные данные одного и того же проекта.

Скорректировать квоту

Квотные лимиты определяют максимальное количество запросов, разрешенных для конкретного API или сервиса в течение заданного периода времени. Когда количество запросов в вашем проекте достигает квотного лимита, ваш сервис перестает отвечать на запросы.

Чтобы изменить значение квоты для вашего API, выполните следующие действия:

  1. В консоли Cloud перейдите в раздел Google Maps Platform > Quotas .
  2. Выберите API, для которого вы хотите изменить квоту.
  3. Укажите значение квоты, которое вы хотите изменить, и выберите его с помощью флажка.
  4. Нажмите «Редактировать» , введите новое значение квоты и нажмите «Отправить запрос» .

Просмотреть запросы на увеличение квоты

Чтобы просмотреть все запросы на увеличение квоты, включая прошлые и ожидающие рассмотрения:

  1. В консоли Cloud перейдите в раздел Google Maps Platform > Quotas .
  2. Выберите API, для которого вы хотите просмотреть запрос на увеличение квоты.
  3. Нажмите « Увеличить количество запросов» .

Ограничения условий использования

Информацию об условиях использования см. в правилах использования API Places и в разделе «Ограничения лицензии» Условий использования платформы Google Maps.