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

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

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

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

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

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

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

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

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

Подробности о товарных позициях и ценах на API Places

В следующей таблице приведены сведения об артикулах и ценах для API Places.

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

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

Для просмотра и управления квотами и лимитами использования см. раздел Квоты и оповещения о квотах .

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

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

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

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

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

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

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

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

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

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

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