Статистика использования и оплата Places API

Маски полей

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

Маски полей помогут вам не запрашивать ненужные данные и тем самым сократить время обработки и снизить расходы.

О сеансах Autocomplete (New)

Сеанс Autocomplete (New) включает один или несколько запросов Autocomplete (New) и запрос информации о местах (New) или Address Validation. В эти запросы Autocomplete (New) и Places Details (New) или Address Validation передается один и тот же токен сеанса.

Сеанс начинается с первого запроса Autocomplete (New). Запрос Place Details (New) или Address Validation выполняется, когда пользователь выбирает одну из подсказок Autocomplete (New). Если сеанс прерван, то есть не было запроса информации о местах (New) или Address Validation, запросы Autocomplete (New) оплачиваются так, как если бы токен сеанса не был предоставлен.

После того как пользователь выберет место (то есть после вызова Place Details (New) или Address Validation), необходимо начать новый сеанс с новым токеном сеанса.

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

Сведения о SKU и ценах для Places API

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

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

Код: Basic Data

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

Глобальный прейскурант
Прейскурант для Индии
Essentials Код: Find Place – ID only Глобальный прейскурант
Прейскурант для Индии
Essentials Код: Place Details Essentials – ID Refresh Глобальный прейскурант
Прейскурант для Индии
Essentials SKU: Автозаполнение запросов – по запросу Глобальный прейскурант
Прейскурант для Индии
Pro Код: Autocomplete without Place Details – Per Session Глобальный прейскурант
Прейскурант для Индии
Pro

SKU: найти место

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

Глобальный прейскурант
Прейскурант для Индии
Pro

SKU: Places – поиск поблизости

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

Глобальный прейскурант
Прейскурант для Индии
Pro

SKU: Places – текстовый поиск

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

Глобальный прейскурант
Прейскурант для Индии
Pro

SKU: информация о местах

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

Глобальный прейскурант
Прейскурант для Индии
Enterprise

Код: Atmosphere Data

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

Глобальный прейскурант
Прейскурант для Индии
Enterprise

Код: Contact Data

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

Глобальный прейскурант
Прейскурант для Индии
Enterprise SKU: фотографии мест Глобальный прейскурант
Прейскурант для Индии

Лимиты на использование

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

  • Places API (New). Ограничение частоты запросов в минуту применяется к каждому методу API в проекте. Другими словами, для каждого метода API предусмотрена отдельная квота.

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

Экономически эффективные стратегии для Places API

В этом разделе описаны способы оптимизации использования Places API и снижения связанных с ним расходов.

Используйте маски полей

Маски полей помогут вам не запрашивать ненужные данные и тем самым сократить время обработки и снизить расходы.

Для запросов информации о местах (New), поиска поблизости (New) и текстового поиска (New) используйте маску полей, чтобы указать список полей, которые нужно вернуть в ответе.

Вам будет выставлен счет по самому высокому из применимых SKU. Например, если вы выберете поля, относящиеся к кодам Essentials и Pro, счет будет выставлен по коду Pro.

Как использовать цены за сеанс с информацией о местах (New)

Если в ваших приложениях ежемесячно выполняется от 100 001 до 500 000 вызовов или больше, или если пользователи выполняют более 12 запросов автозаполнения за сеанс, Google рекомендует использовать сеансы с Autocomplete (New). Сеансы упрощают ценообразование и обеспечивают единую модель оплаты при использовании Autocomplete (New).

Подробнее о ценах на Autocomplete (New) и сеансы…

Изменить квоту

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

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

  1. В Cloud Console выберите Платформа Google Карт > Квоты.
  2. Выберите API, для которого нужно изменить квоту.
  3. Найдите квоту, которую нужно изменить, и установите флажок рядом с ней.
  4. Нажмите Изменить, введите новое значение квоты и нажмите Отправить запрос.

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

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

  1. В Cloud Console выберите Платформа Google Карт > Квоты.
  2. Выберите API, для которого вы хотите посмотреть запрос на увеличение квоты.
  3. Нажмите Запросы на увеличение.

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

Дополнительную информацию об условиях использования можно найти в правилах Places API и разделе Лицензионные ограничения Условий использования платформы Google Карт.