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

Выставление счетов и цены на Places API

Информацию о том, как Google рассчитывает ваши счета и цены, см. в прайс-листе платформы Google Maps или в прайс-листе платформы Google Maps – Индия .

Размещает (новые) артикулы продуктов

Щелкните значок информации , чтобы просмотреть содержание этой страницы. В следующих разделах приведены подробные сведения о каждом SKU:

О масках полей

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

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

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

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

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

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

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

Артикул: Автозаполнение запросов

Этот номер SKU взимает плату за запросы к API автозаполнения, которые не используют сеанс . Информацию об использовании сеанса для ограничения количества запросов, оплачиваемых в течение одного сеанса автозаполнения, см. в разделе Токены сеанса или SKU: использование сеанса автозаполнения .

	Категория	Основы
	Оплачиваемое мероприятие	Запрос
	Триггеры	Этот SKU активируется при следующих условиях: Ваш запрос не включает токен сеанса. Ваш запрос включает токен сеанса, но вы прекращаете сеанс. Ваш запрос включает токен сеанса, но вы завершаете сеанс при определенных условиях. Дополнительные сведения об использовании сеанса автозаполнения см. в разделе Токены сеанса или Использование сеанса автозаполнения .
	Цены	Основная таблица цен Таблица цен в Индии

Артикул: Использование сеанса автозаполнения

Этот номер SKU выставляет счет за каждый запрос к API автозаполнения (нового), который включает токен сеанса.

	Категория	Основы
	Оплачиваемое мероприятие	Запрос
	Триггеры	Этот номер SKU активируется, когда вы отправляете запрос к API автозаполнения (новый), который включает токен сеанса. Этот номер SKU действует как оболочка для SKU запросов автозаполнения (нового), который позволяет вам ограничить количество запросов, оплачиваемых в течение одного сеанса автозаполнения. Дополнительные сведения об использовании сеанса автозаполнения см. в разделе Токены сеанса . Дополнительные сведения см. в разделе «Автозаполнение (новое)» и цены на сеансы .
	Цены	Основная таблица цен Таблица цен в Индии

Артикул: Places API Essentials Place Details (только идентификаторы)

Этот номер SKU выставляет счет за запросы к сведениям о месте, которые возвращают только идентификатор места.

	Категория	Основы
	Оплачиваемое мероприятие	Запрос с указанными масками полей.
	Триггеры	Этот SKU активируется, когда вы запрашиваете следующие поля: Поля для веб-сервиса attributions id name * photos * Поле name содержит имя ресурса места в форме: places/ PLACE_ID . Используйте displayName для доступа к текстовому названию места.
	Биллинг по маске поля	Плата за ваш запрос выставляется на основе полей, указанных в маске полей. Например: Если ваша маска полей включает только поля из этого SKU : Запрос оплачивается по тарифу для этого SKU. Если ваша маска поля включает поля из других SKU : Запрос оплачивается по самой высокой ставке SKU для запрошенных полей. Например, если вы включаете поля как из номера SKU Essentials, так и из номера SKU Enterprise, то за запрос взимается плата по тарифу SKU Enterprise.
	Цены	Основная таблица цен Таблица цен в Индии

Артикул: Places API Основные сведения о местах

Этот номер SKU выставляет счета за запросы к API Place Details, которые извлекают поля из этого SKU.

	Категория	Основы
	Оплачиваемое мероприятие	Запрос с указанными масками полей.
	Триггеры	Этот SKU активируется, когда вы запрашиваете следующие поля местоположения: Поля для веб-сервиса addressComponents adrFormatAddress formattedAddress location plusCode postalAddress shortFormattedAddress types viewport
	Биллинг по маске поля	Плата за ваш запрос выставляется на основе полей, указанных в маске полей. Например: Если ваша маска полей включает только поля из этого SKU : Запрос оплачивается по тарифу для этого SKU. Если ваша маска поля включает поля из других SKU : Запрос оплачивается по самой высокой ставке SKU для запрошенных полей. Например, если вы включаете поля как из номера SKU Essentials, так и из номера SKU Enterprise, то за запрос взимается плата по тарифу SKU Enterprise.
	Цены	Основная таблица цен Таблица цен в Индии

Артикул: Places API Place Details Pro

Этот номер SKU выставляет счета за поля, которые вы указываете в запросе Place Details Pro .

	Категория	Про
	Оплачиваемое мероприятие	Запрос с указанными масками полей.
	Триггеры	Этот SKU активируется, когда вы запрашиваете только следующие поля или поля с более низкой ставкой: Поля для веб-сервиса accessibilityOptions businessStatus containingPlaces displayName googleMapsLinks * googleMapsUri iconBackgroundColor iconMaskBaseUri primaryType primaryTypeDisplayName pureServiceAreaBusiness subDestinations utcOffsetMinutes * Поле googleMapsLinks находится на стадии предварительной версии GA, и за нее не взимается плата, то есть оплата за использование во время предварительной версии составляет 0 долларов США.
	Биллинг по маске поля	Плата за ваш запрос выставляется на основе полей, указанных в маске полей. Например: Если ваша маска полей включает только поля из этого SKU : Запрос оплачивается по тарифу для этого SKU. Если ваша маска поля включает поля из других SKU : Запрос оплачивается по самой высокой ставке SKU для запрошенных полей. Например, если вы включаете поля как из номера SKU Essentials, так и из номера SKU Enterprise, то за запрос взимается плата по тарифу SKU Enterprise.
	Цены	Основная таблица цен Таблица цен в Индии

Артикул: API-интерфейс Places Details Enterprise

Этот номер SKU выставляет счет за запрос Places, включающий поля Enterprise.

	Категория	Предприятие
	Оплачиваемое мероприятие	Запрос с указанными масками полей.
	Триггеры	Этот SKU активируется, когда вы запрашиваете следующие поля: Поля для веб-сервиса currentOpeningHours currentSecondaryOpeningHours internationalPhoneNumber nationalPhoneNumber priceLevel priceRange rating regularOpeningHours regularSecondaryOpeningHours userRatingCount websiteUri Если вы завершаете сеанс автозаполнения с помощью вызова Place Details, который запрашивает любое поле из SKU: Place Details Essentials, Pro, Enterprise или Enterprise + AtmSphere , тогда вызов оплачивается по SKU: Place Details Enterprise + Atmосфере . Дополнительные сведения см. в разделе SKU: использование сеанса автозаполнения .
	Биллинг по маске поля	Плата за ваш запрос выставляется на основе полей, указанных в маске полей. Например: Если ваша маска полей включает только поля из этого SKU : Запрос оплачивается по тарифу для этого SKU. Если ваша маска поля включает поля из других SKU : Запрос оплачивается по самой высокой ставке SKU для запрошенных полей. Например, если вы включаете поля как из номера SKU Essentials, так и из номера SKU Enterprise, то за запрос взимается плата по тарифу SKU Enterprise.
	Цены	Основная таблица цен Таблица цен в Индии

Артикул: Places API Детали места Enterprise + Атмосфера

Этот номер SKU взимает плату за вызовы API сведений о месте, которые запрашивают указанные поля атмосферы.

	Категория	Предприятие
	Оплачиваемое мероприятие	Запрос
	Триггеры	Этот SKU активируется, когда вы запрашиваете следующие поля: Поля для веб-сервиса allowsDogs curbsidePickup delivery dineIn editorialSummary evChargeOptions fuelOptions goodForChildren goodForGroups goodForWatchingSports liveMusic menuForChildren parkingOptions paymentOptions outdoorSeating reservable restroom reviews routingSummaries * servesBeer servesBreakfast servesBrunch servesCocktails servesCoffee servesDessert servesDinner servesLunch servesVegetarianFood servesWine takeout * Только текстовый поиск и поиск поблизости. Если сеанс автозаполнения завершается вызовом Place Details, который запрашивает любое поле из SKU: Place Details Essentials, Pro, Enterprise или Enterprise + AtmSphere , то вызов оплачивается по SKU: Place Details Enterprise + Atmосфере . Дополнительные сведения см. в разделе SKU: использование сеанса автозаполнения .
	Биллинг по маске поля	Плата за ваш запрос выставляется на основе полей, указанных в маске полей. Например: Если ваша маска полей включает только поля из этого SKU : Запрос оплачивается по тарифу для этого SKU. Если ваша маска поля включает поля из других SKU : Запрос оплачивается по самой высокой ставке SKU для запрошенных полей. Например, если вы включаете поля как из номера SKU Essentials, так и из номера SKU Enterprise, то за запрос взимается плата по тарифу SKU Enterprise.
	Цены	Основная таблица цен Таблица цен в Индии

Артикул: Places API Nearby Search Pro

Этот номер SKU выставляет счета за поля, которые вы указываете в запросе Nearby Search Pro .

	Категория	Про
	Оплачиваемое мероприятие	Запрос с указанными масками полей.
	Триггеры	Этот SKU активируется, когда вы запрашиваете только следующие поля или поля с более низкой ставкой: Поля для веб-сервиса places.accessibilityOptions places.addressComponents places.adrFormatAddress places.attributions places.businessStatus places.containingPlaces places.displayName places.formattedAddress places.googleMapsLinks * places.googleMapsUri places.iconBackgroundColor places.iconMaskBaseUri places.id places.location places.name ** places.photos places.plusCode places.postalAddress places.primaryType places.primaryTypeDisplayName places.pureServiceAreaBusiness places.shortFormattedAddress places.subDestinations places.types places.utcOffsetMinutes places.viewport * Поле places.googleMapsLinks находится на стадии предварительной версии GA, и за нее не взимается плата, то есть оплата за использование во время предварительной версии составляет 0 долларов США. ** Поле places.name содержит название ресурса места в формате places/ PLACE_ID . Используйте places.displayName для доступа к текстовому названию места.
	Биллинг по маске поля	Плата за ваш запрос выставляется на основе полей, указанных в маске полей. Например: Если ваша маска полей включает только поля из этого SKU : Запрос оплачивается по тарифу для этого SKU. Если ваша маска поля включает поля из других SKU : Запрос оплачивается по самой высокой ставке SKU для запрошенных полей. Например, если вы включаете поля как из номера SKU Essentials, так и из номера SKU Enterprise, то за запрос взимается плата по тарифу SKU Enterprise.
	Цены	Основная таблица цен Таблица цен в Индии

Артикул: Places API Near Search Enterprise

Этот номер SKU взимает плату за запросы поиска поблизости, которые включают любые поля Enterprise.

	Категория	Предприятие
	Оплачиваемое мероприятие	Запрос с указанными масками полей.
	Триггеры	Этот SKU активируется, когда вы запрашиваете следующие поля: Поля для веб-сервиса places.currentOpeningHours places.currentSecondaryOpeningHours places.internationalPhoneNumber places.nationalPhoneNumber places.priceLevel places.priceRange places.rating places.regularOpeningHours places.regularSecondaryOpeningHours places.userRatingCount places.websiteUri
	Биллинг по маске поля	Плата за ваш запрос выставляется на основе полей, указанных в маске полей. Например: Если ваша маска полей включает только поля из этого SKU : Запрос оплачивается по тарифу для этого SKU. Если ваша маска поля включает поля из других SKU : Запрос оплачивается по самой высокой ставке SKU для запрошенных полей. Например, если вы включаете поля как из номера SKU Essentials, так и из номера SKU Enterprise, то за запрос взимается плата по тарифу SKU Enterprise.
	Цены	Основная таблица цен Таблица цен в Индии

Артикул: Places API Поиск поблизости Enterprise + Атмосфера

Этот номер SKU взимает плату за поисковые запросы поблизости, которые включают указанные поля атмосферы.

	Категория	Предприятие
	Оплачиваемое мероприятие	Запрос
	Триггеры	Этот SKU активируется, когда вы запрашиваете следующие поля: Поля для веб-сервиса places.allowsDogs places.curbsidePickup places.delivery places.dineIn places.editorialSummary places.evChargeOptions places.fuelOptions places.goodForChildren places.goodForGroups places.goodForWatchingSports places.liveMusic places.menuForChildren places.parkingOptions places.paymentOptions places.outdoorSeating places.reservable places.restroom places.reviews places.routingSummaries * places.servesBeer places.servesBreakfast places.servesBrunch places.servesCocktails places.servesCoffee places.servesDessert places.servesDinner places.servesLunch places.servesVegetarianFood places.servesWine places.takeout * Только текстовый поиск и поиск поблизости.
	Биллинг по маске поля	Плата за ваш запрос выставляется на основе полей, указанных в маске полей. Например: Если ваша маска полей включает только поля из этого SKU : Запрос оплачивается по тарифу для этого SKU. Если ваша маска поля включает поля из других SKU : Запрос оплачивается по самой высокой ставке SKU для запрошенных полей. Например, если вы включаете поля как из номера SKU Essentials, так и из номера SKU Enterprise, то за запрос взимается плата по тарифу SKU Enterprise.
	Цены	Основная таблица цен Таблица цен в Индии

Артикул: Places API Essentials Text Search Search (только идентификаторы)

С этого номера SKU взимается плата за запросы к API текстового поиска, которые возвращают только идентификаторы.

	Категория	Основы
	Оплачиваемое мероприятие	Запрос с указанными масками полей.
	Триггеры	Этот SKU активируется, когда вы запрашиваете только следующие поля: Поля для веб-сервиса places.attributions places.id places.name * nextPageToken * Поле places.name содержит имя ресурса места в форме: places/ PLACE_ID . Используйте places.displayName для доступа к текстовому названию места.
	Биллинг по маске поля	Плата за ваш запрос выставляется на основе полей, указанных в маске полей. Например: Если ваша маска полей включает только поля из этого SKU : Запрос оплачивается по тарифу для этого SKU. Если ваша маска поля включает поля из других SKU : Запрос оплачивается по самой высокой ставке SKU для запрошенных полей. Например, если вы включаете поля как из номера SKU Essentials, так и из номера SKU Enterprise, то за запрос взимается плата по тарифу SKU Enterprise.
	Цены	Основная таблица цен Таблица цен в Индии

Артикул: Places API Text Search Pro

Этот номер SKU представляет собой номер SKU данных , за который взимается плата за поля, указанные вами в запросе Text Search Pro .

	Категория	Про
	Оплачиваемое мероприятие	Запрос с указанными масками полей.
	Триггеры	Этот SKU активируется, когда вы запрашиваете только следующие поля или поля с более низкой ставкой: Поля для веб-сервиса places.accessibilityOptions places.addressComponents places.adrFormatAddress places.businessStatus places.containingPlaces places.displayName places.formattedAddress places.googleMapsLinks * places.googleMapsUri places.iconBackgroundColor places.iconMaskBaseUri places.location places.photos places.plusCode places.postalAddress places.primaryType places.primaryTypeDisplayName places.pureServiceAreaBusiness places.shortFormattedAddress places.subDestinations places.types places.utcOffsetMinutes places.viewport * Поле places.googleMapsLinks находится на стадии предварительной версии GA, и за нее не взимается плата, то есть оплата за использование во время предварительной версии составляет 0 долларов США.
	Биллинг по маске поля	Плата за ваш запрос выставляется на основе полей, указанных в маске полей. Например: Если ваша маска полей включает только поля из этого SKU : Запрос оплачивается по тарифу для этого SKU. Если ваша маска поля включает поля из других SKU : Запрос оплачивается по самой высокой ставке SKU для запрошенных полей. Например, если вы включаете поля как из номера SKU Essentials, так и из номера SKU Enterprise, то за запрос взимается плата по тарифу SKU Enterprise.
	Цены	Основная таблица цен Таблица цен в Индии

Артикул: Places API Текстовый поиск Enterprise

Этот номер SKU выставляет счет за запросы текстового поиска, которые включают любые поля Enterprise.

	Категория	Предприятие
	Оплачиваемое мероприятие	Запрос с указанными масками полей.
	Триггеры	Этот SKU активируется, когда вы запрашиваете следующие поля: Поля для веб-сервиса places.currentOpeningHours places.currentSecondaryOpeningHours places.internationalPhoneNumber places.nationalPhoneNumber places.priceLevel places.priceRange places.rating places.regularOpeningHours places.regularSecondaryOpeningHours places.userRatingCount places.websiteUri
	Биллинг по маске поля	Плата за ваш запрос выставляется на основе полей, указанных в маске полей. Например: Если ваша маска полей включает только поля из этого SKU : Запрос оплачивается по тарифу для этого SKU. Если ваша маска поля включает поля из других SKU : Запрос оплачивается по самой высокой ставке SKU для запрошенных полей. Например, если вы включаете поля как из номера SKU Essentials, так и из номера SKU Enterprise, то за запрос взимается плата по тарифу SKU Enterprise.
	Цены	Основная таблица цен Таблица цен в Индии

Артикул: Places API Текстовый поиск Enterprise + Атмосфера

Этот номер SKU выставляет счет за запросы текстового поиска, которые включают любые поля атмосферы.

	Категория	Предприятие
	Оплачиваемое мероприятие	Запрос
	Триггеры	Этот SKU активируется, когда вы запрашиваете следующие поля: Поля для веб-сервиса places.allowsDogs places.curbsidePickup places.delivery places.dineIn places.editorialSummary places.evChargeOptions places.fuelOptions places.goodForChildren places.goodForGroups places.goodForWatchingSports places.liveMusic places.menuForChildren places.parkingOptions places.paymentOptions places.outdoorSeating places.reservable places.restroom places.reviews places.routingSummaries * places.servesBeer places.servesBreakfast places.servesBrunch places.servesCocktails places.servesCoffee places.servesDessert places.servesDinner places.servesLunch places.servesVegetarianFood places.servesWine places.takeout * Только текстовый поиск и поиск поблизости.
	Биллинг по маске поля	Плата за ваш запрос выставляется на основе полей, указанных в маске полей. Например: Если ваша маска полей включает только поля из этого SKU : Запрос оплачивается по тарифу для этого SKU. Если ваша маска поля включает поля из других SKU : Запрос оплачивается по самой высокой ставке SKU для запрошенных полей. Например, если вы включаете поля как из номера SKU Essentials, так и из номера SKU Enterprise, то за запрос взимается плата по тарифу SKU Enterprise.
	Цены	Основная таблица цен Таблица цен в Индии

Артикул: Детали места Фотографии

Для этого SKU выставляются счета за запросы фотографий с описанием места.

	Категория	Предприятие
	Оплачиваемое мероприятие	Запрос
	Триггеры	Платежи срабатывают, когда вы запрашиваете фотографию у Place Details API.
	Цены	Основная таблица цен Таблица цен в Индии

Артикул продуктов Legacy Places

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

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

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

Сеансы автозаполнения могут быть созданы с помощью следующих API:

• Служба автозаполнения мест Places API или служба автозаполнения мест Maps JavaScript API . Вам необходимо разработать приложение для предоставления токенов сеанса (возможно, вам придется изменить существующий код).
• Виджет автозаполнения Maps JavaScript API . Биллинг на основе сеанса автоматически включается для этих виджетов без необходимости изменения кода.

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

Запросы автозаполнения и запросы сведений о местах с использованием сеансов оплачиваются для разных номеров SKU.

О кодах данных Places Data

Три SKU данных о местах: базовые данные , контактные данные и данные об атмосфере .

Один или несколько номеров SKU данных активируются для:

• Android: каждый запрос к fetchPlace() или findCurrentPlace()
• iOS: каждый вызов fetchPlaceFromPlaceID: или findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
• Веб-сервис: каждый запрос Places в зависимости от полей, указанных в запросе.

За номера SKU данных всегда взимается плата в дополнение к базовому SKU за запрос, инициировавший их. Например, за запрос сведений о месте, включающий поля основных данных, будет взиматься плата как за SKU основных данных , так и за SKU сведений о месте.

Для веб-службы эти запросы API-интерфейсов Places позволяют указать возвращаемые поля данных:

• Детали мест Pro
• Найти место

Для веб-службы эти вызовы API-интерфейсов Places НЕ поддерживают указание возвращаемых полей. Эти вызовы всегда возвращают все данные Places, взимая плату за три SKU данных Places в дополнение к плате за каждый запрос API:

• Места – Поиск поблизости
• Места – текстовый поиск

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

Этот номер SKU представляет собой номер SKU данных , который выставляет счета за поля основных данных в запросе «Сведения о месте» или «Найти место». За этот номер SKU взимается плата в дополнение к базовому SKU за запрос, вызвавший его.

Поля категории «Базовый» включены в базовую стоимость запроса мест и не требуют дополнительной оплаты.

	Категория	Основы
	Оплачиваемое мероприятие	Запрос с указанными масками полей.
	Триггеры	Артикул базовых данных активируется, когда вы запрашиваете любое из этих полей: Поля для Android SDK Place.Field.ACCESSIBILITY_OPTIONS * * Используйте вместо Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE (устарело). Place.Field.ADDRESS_COMPONENTS Place.Field.BUSINESS_STATUS Place.Field.DISPLAY_NAME * * Используйте вместо Place.Field.NAME (устарело). Place.Field.FORMATTED_ADDRESS * * Используйте вместо Place.Field.ADDRESS (устарело). Place.Field.ICON_BACKGROUND_COLOR Place.Field.ICON_MASK_URL * * Используйте вместо Place.Field.ICON_URL (устарело). Place.Field.ID Place.Field.LOCATION * * Используйте вместо Place.Field.LAT_LNG (устарело). Place.Field.PHOTO_METADATAS Place.Field.PLUS_CODE Place.Field.TYPES Place.Field.VIEWPORT Place.Field.UTC_OFFSET . Поля для iOS GMSPlaceFieldFormattedAddress GMSPlaceFieldBusinessStatus GMSPlaceFieldID GMSPlaceFieldCoordinate GMSPlaceFieldName GMSPlaceFieldPhotos GMSPlaceFieldPlusCode GMSPlaceFieldTypes GMSPlaceFieldViewport Поля для веб-сервиса address_component adr_address business_status formatted_address geometry icon name permanently_closed photo place_id plus_code type url utc_offset vicinity wheelchair_accessible_entrance
	Биллинг по маске поля	Плата за ваш запрос выставляется на основе полей, указанных в маске полей. Например: Если ваша маска полей включает только поля из этого SKU : Запрос оплачивается по тарифу для этого SKU. Если ваша маска поля включает поля из других SKU : Запрос оплачивается по самой высокой ставке SKU для запрошенных полей. Например, если вы включаете поля как из номера SKU Essentials, так и из номера SKU Enterprise, то за запрос взимается плата по тарифу SKU Enterprise.
	Цены	Основная таблица цен Таблица цен в Индии

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

Этот номер SKU представляет собой номер SKU данных , который выставляет счета за поля контактных данных в запросе «Сведения о месте» или «Найти место». За этот номер SKU взимается плата в дополнение к базовому SKU за запрос, вызвавший его.

Используя параметр полей в запросе Place Details или Find Place для веб-служб или массив Place.Field для Android или iOS, вы можете ограничить ответ только указанными полями. Поля в категории «Контакты» требуют дополнительной оплаты.

	Категория	Предприятие
	Оплачиваемое мероприятие	Запрос с указанными масками полей.
	Триггеры	Артикул контактных данных активируется при запросе любого из этих полей: Поля для Android SDK Place.Field.CURRENT_OPENING_HOURS Place.Field.INTERNATIONAL_PHONE_NUMBER * * Используйте вместо Place.Field.PHONE_NUMBER (устарело). Place.Field.OPENING_HOURS Place.Field.SECONDARY_OPENING_HOURS Place.Field.WEBSITE_URI Поля для iOS SDK GMSPlaceFieldOpeningHours GMSPlaceFieldPhoneNumber GMSPlaceFieldWebsite Поля для веб-сервиса formatted_phone_number international_phone_number opening_hours current_opening_hours secondary_opening_hours website
	Биллинг по маске поля	Плата за ваш запрос выставляется на основе полей, указанных в маске полей. Например: Если ваша маска полей включает только поля из этого SKU : Запрос оплачивается по тарифу для этого SKU. Если ваша маска поля включает поля из других SKU : Запрос оплачивается по самой высокой ставке SKU для запрошенных полей. Например, если вы включаете поля как из номера SKU Essentials, так и из номера SKU Enterprise, то за запрос взимается плата по тарифу SKU Enterprise.
	Цены	Основная таблица цен Таблица цен в Индии

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

Этот номер SKU выставляет счета за запросы к API данных об атмосфере, в которых указаны поля этого SKU.

	Категория	Предприятие
	Оплачиваемое мероприятие	Запрос с указанными масками полей.
	Триггеры	Биллинг активируется, когда вы запрашиваете любое из этих полей:
	Примеры выставления счетов по маске поля	Плата за ваш запрос выставляется на основе полей, указанных в маске полей. Например: Если ваша маска полей включает только поля из этого SKU : Запрос оплачивается по тарифу для этого SKU. Если ваша маска поля включает поля из других SKU : Запрос оплачивается по самой высокой ставке SKU для запрошенных полей. Например, если вы включаете поля как из номера SKU Essentials, так и из номера SKU Enterprise, то за запрос взимается плата по тарифу SKU Enterprise.
	Цены	Основная таблица цен Таблица цен в Индии

Артикул: Автозаполнение – по запросу

Этот счет за номер SKU для запросов, не включающих токен сеанса.

Если вы делаете запрос из недействительного сеанса автозаполнения (например, сеанса, в котором повторно используется токен сеанса), с вас также взимается плата за автозаполнение — номер SKU по запросу.

За запросы автозаполнения от Maps JavaScript API Виджет автозаполнения мест может взиматься плата за автозаполнение — номер SKU за запрос, если вы делаете запросы из недействительного сеанса автозаполнения. Такая ситуация может возникнуть, когда пользователь вводит или копирует/вставляет в виджет несколько разных адресов и не всегда выбирает подсказку автозаполнения.

	Категория	Основы
	Оплачиваемое мероприятие	Запрос
	Триггеры	Выставление счетов происходит за: Андроид: findAutocompletePredictions() iOS: findAutocompletePredictionsFromQuery: JavaScript: Служба автозаполнения мест Maps JavaScript API Веб-сервис: Служба автозаполнения мест Places API
	Цены	Основная таблица цен Таблица цен в Индии

Артикул: автозаполнение без сведений о месте – за сеанс

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

	Категория	Про
	Оплачиваемое мероприятие	Сессия
	Триггеры	Биллинг активируется, если ваше приложение отправляет эти два запроса за один сеанс: Андроид findAutocompletePredictions() (.setQuery("par"), .setSessionToken(XYZ)) findAutocompletePredictions() (.setQuery("Париж"), .setSessionToken(XYZ)) iOS PlacesClient?.findAutocompletePredictions(fromQuery: "par" ... PlacesClient?.findAutocompletePredictions(fromQuery: "paris" ... Веб-сервис Разместить запрос автозаполнения (input="par", session_token: XYZ) Разместить запрос автозаполнения (input="paris", session_token: XYZ) При просмотре счета по SKU вы видите в списке следующий SKU: Автозаполнение без сведений о месте – за сеанс
	Цены	Основная таблица цен Таблица цен в Индии

Артикул: автозаполнение (входит в состав сведений о месте) — за сеанс.

Запросы на автозаполнение доступны бесплатно. Оплата за этот номер SKU выставляется при последующем запросе информации о месте на основе обычных цен на информацию о месте .

	Категория	Основы
	Оплачиваемое мероприятие	Сессия
	Триггеры	Автозаполнение (входит в состав сведений о месте) — SKU за сеанс взимается за сеанс автозаполнения , который запрашивает сведения о месте. Конкретно: Android: вызов fetchPlace() iOS: вызов fetchPlaceFromPlaceID: Веб-сервис: запрос сведений о месте Поля в запросе: Обязательно указывайте нужные поля в запросе, чтобы избежать ненужных расходов. В зависимости от того, какие поля вы указываете, запрос сведений о месте также генерирует следующие номера SKU данных: Основные данные (основное) Места – контактные данные (предприятие) Места – Атмосфера (Предприятие) Если вы не укажете поля в запросе сведений о месте, активируются все SKU данных. Если вы запрашиваете только обновление идентификатора сведений о месте (ваш запрос указывает только поле place_id ) во время сеанса автозаполнения, сеанс оплачивается как SKU: Автозаполнение без сведений о месте — за сеанс .
	Примеры	В этом примере показана серия запросов по платформам, в результате которых в вашем счете будут указаны следующие SKU при просмотре счета по SKU : Автозаполнение (входит в состав сведений о месте) — за сеанс Детали места Основные данные Пример запроса по платформе: Android-запросы findAutocompletePredictions() (.setQuery("par"), .setSessionToken(XYZ)) findAutocompletePredictions() (.setQuery("Париж"), .setSessionToken(XYZ)) fetchPlace() (с FetchPlaceRequest , включая идентификатор места и поле АДРЕС) iOS-запросы placesClient?.findAutocompletePredictions(fromQuery: "par" ... placesClient?.findAutocompletePredictions(fromQuery: "paris" ... fetchPlaceFromPlaceID: (включая идентификатор места и поле GMSPlaceFieldFormattedAddress ) Запросы веб-сервиса Размещает запрос автозаполнения (input="par", session_token: XYZ) Размещает запрос автозаполнения (input="paris", session_token: XYZ) Подробности о местах (place_id, session_token: XYZ, поля: formatted_address)
	Цены	Основная таблица цен Таблица цен в Индии

Артикул: Автозаполнение запроса – по запросу

Этот устаревший номер SKU выставляет счета за запросы автозаполнения запросов.

	Категория	Основы
	Оплачиваемое мероприятие	Запрос
	Триггеры	Этот номер SKU активируется, когда вы делаете запрос автозаполнения запроса с помощью следующих служб: JavaScript: служба автозаполнения мест Maps JavaScript API ( getQueryPredictions() ) и использование виджета Maps JavaScript API SearchBox (запросы автозаполнения запросов генерируются по мере ввода пользователем текста). Веб-служба: служба автозаполнения запросов Places API. Цены на основе сеанса автозаполнения не поддерживаются при использовании автозаполнения запросов. За последующие запросы Place Details взимается плата в зависимости от SKU Place Details Pro .
	Цены	Основная таблица цен Таблица цен в Индии

Артикул: Place Details Pro

Для этого SKU выставляются счета за устаревшие запросы сведений о месте.

	Категория	Про
	Оплачиваемое мероприятие	Запрос
	Триггеры	Биллинг активируется для запросов от следующих API: Android: Places SDK для Android ( fetchPlace() ) iOS: Places SDK для iOS ( fetchPlaceFromPlaceID: ) JavaScript: Maps JavaScript API Служба сведений о местах ( getDetails ) JavaScript: Maps JavaScript API Виджет автозаполнения мест ( getPlace ) JavaScript: Maps JavaScript API Размещение виджета SearchBox : метод getPlaces() после того, как пользователь выбирает результат размещения (значок: булавка), *а не* запрос (значок: лупа), как показано здесь: Веб-сервис: Служба Place Details API Places При использовании веб-API и служб за номер SKU Place Details взимается плата независимо от того, предоставляете ли вы токен сеанса или нет. Этот номер SKU также вызывает выставление счетов за номера SKU данных . Если вы включаете поля данных в свой запрос, это может привести к дополнительному выставлению счетов за номера SKU данных: Basic , Contact и Atmосфера . Укажите только те поля данных, которые вы хотите избежать ненужных затрат. Вам выставляется счет за этот номер SKU, а также за запрашиваемые вами данные.
	Примеры	Сделайте один из этих звонков или запросов: Мобильное устройство: вызовите fetchPlace() на Android или fetchPlaceFromPlaceID: на iOS и укажите только поле ADDRESS Веб-API или служба: сделайте запрос сведений о месте и укажите только поле адреса: getPlaceDetails(fields: formatted_address) В вашем счете вы увидите следующие SKU (при просмотре счета по SKU ): Детали места Основные данные Сделайте один из этих звонков или запросов: Мобильное устройство: вызовите fetchPlace() на Android или fetchPlaceFromPlaceID: на iOS и укажите только поле PHONE_NUMBER Веб-API или служба: сделайте запрос сведений о месте и укажите поле номера телефона: getPlaceDetails(fields: formatted_phone_number) В вашем счете вы увидите следующие SKU (при просмотре счета по SKU ): Детали места Контактные данные Сделайте один из этих звонков или запросов: Мобильное устройство: вызовите fetchPlace() на Android или fetchPlaceFromPlaceID: на iOS и укажите все поля. Веб-API или служба: сделайте запрос сведений о месте и укажите все поля (этот тип запроса используется по умолчанию, если вы не указываете какие-либо поля): getPlaceDetails() . В вашем счете вы увидите следующие SKU (при просмотре счета по SKU ): Детали места Основные данные Контактные данные Данные об атмосфере
	Цены	Основная таблица цен Таблица цен в Индии

Артикул: Информация о месте – Обновление идентификатора

Этот номер SKU взимает плату за запросы к API сведений о местах, которые обновляют устаревшие идентификаторы мест .

	Категория	Основы
	Оплачиваемое мероприятие	Запрос
	Триггеры	Выставление счетов активируется, когда вы отправляете запрос сведений о месте, указав только поле идентификатора места: getPlaceDetails(fields: place_id) .
	Цены	Основная таблица цен Таблица цен в Индии

Артикул: Найти место

Этот номер SKU выставляет счет за запросы к функции «Найти место», которые возвращают больше полей, чем просто идентификатор места.

Этот номер SKU также вызывает выставление счетов за номера SKU данных . Если вы включаете поля данных в свой запрос, это может привести к дополнительному выставлению счетов за номера SKU данных: Basic , Contact и Atmосфера . Укажите только те поля данных, которые вы хотите избежать ненужных затрат. Вам выставляется счет за этот номер SKU, а также за запрашиваемые вами данные.

	Категория	Про
	Оплачиваемое мероприятие	Запрос
	Триггеры	В этом SKU выставляются счета за запросы к следующим методам: Найти текущее место Этот номер SKU также вызывает выставление счетов за номера SKU данных . Если вы включаете поля данных в свой запрос, это может привести к дополнительному выставлению счетов за номера SKU данных: Basic , Contact и Atmосфера . Укажите только те поля данных, которые вы хотите избежать ненужных затрат. Вам выставляется счет за этот номер SKU, а также за запрашиваемые вами данные.
	Примеры	В следующих примерах показано, за какие SKU вам выставляется счет при отправке запроса «Найти текущее место» и указании полей из SKU «Базовые», «Контактные данные» и «Атмосфера». Чтобы увидеть номера SKU в своем счете, просмотрите счет по SKU, как описано в разделе Анализ использования и стоимости каждого SKU . Вы делаете запрос «Найти место», используя только поле ADDRESS : В вашем счете указаны следующие SKU: Найти текущее место Основные данные Вы делаете запрос «Найти место», используя только поле PHONE_NUMBER : В вашем счете указаны следующие SKU: Найти текущее место Контактные данные Вы делаете запрос Find Place со всеми тремя полями типов данных : В вашем счете указаны следующие SKU: Найти текущее место Основные данные Контактные данные Данные об атмосфере
	Цены	Основная таблица цен Таблица цен в Индии

Артикул: Найти место – только идентификатор

Этот номер SKU выставляет счет за запросы Find Place, которые возвращают только идентификатор места. По умолчанию, если вы не укажете никаких полей в запросе «Найти место», возвращается только идентификатор места.

	Категория	Основы
	Оплачиваемое мероприятие	Запрос
	Триггеры	Вы делаете запрос Find Place без указания каких-либо полей или указываете только поле place_id : FindPlace(fields: place_id) .
	Цены	Основная таблица цен Таблица цен в Индии

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

Этот номер SKU выставляет счета за устаревшие запросы поиска поблизости.

	Категория	Про
	Оплачиваемое мероприятие	Запрос
	Триггеры	Этот SKU активируется, когда вы отправляете запрос на поиск поблизости с помощью одного из следующих API: Карты JavaScript API Служба поиска мест поблизости ( nearbySearch() ) Places API Служба поиска поблизости Этот запрос не поддерживает указание возвращаемых полей. Ответ возвращает список мест и подмножество поддерживаемых полей данных . Этот номер SKU также вызывает выставление счетов за номера SKU данных . Если вы включаете поля данных в свой запрос, это может привести к дополнительному выставлению счетов за номера SKU данных: Basic , Contact и Atmосфера . Укажите только те поля данных, которые вы хотите избежать ненужных затрат. Вам выставляется счет за этот номер SKU, а также за запрашиваемые вами данные.
	Примеры	Вы делаете запрос на поиск поблизости, например NearbySearch (San Francisco, 100 meters) . В вашем счете отображаются следующие SKU при просмотре счета по SKU : Место Основные данные Контактные данные Данные об атмосфере
	Цены	Основная таблица цен Таблица цен в Индии

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

Этот номер SKU выставляет счета за запросы к устаревшей службе текстового поиска мест.

	Категория	Про
	Оплачиваемое мероприятие	Запрос
	Триггеры	Тарификация производится за запросы к следующим сервисам: Maps JavaScript API Place Служба текстового поиска ( textSearch() ). Служба текстового поиска Places API Запросы текстового поиска возвращают список мест, но не поддерживают указание возвращаемых полей. Запросы текстового поиска возвращают подмножество поддерживаемых полей данных . С вас взимается плата за запрос текстового поиска, а также за все SKU типов данных: «Базовые данные» , «Контактные данные» и «Данные об атмосфере» . SKU «Место — текстовый поиск» также запускается виджетом Maps JavaScript API Place SearchBox : метод getPlaces() после того, как пользователь выбирает запрос места (значок: лупа), а не результат (значок: булавка), как показано здесь:
	Пример	Если вы делаете запрос текстового поиска, например TextSearch(123 Main Street) , в вашем счете отображаются следующие SKU при просмотре счета по SKU : Место – текстовый поиск Основные данные Контактные данные Данные об атмосфере
	Цены	Основная таблица цен Таблица цен в Индии

Артикул: Places API Подробности о местах Фотографии

Этот номер SKU выставляет счета за устаревшую службу Places Photo.

	Категория	Предприятие
	Оплачиваемое мероприятие	Запрос
	Триггеры	Выставление счетов происходит за: Android: вызовы fetchPhoto() iOS: вызовы loadPlacePhoto: JavaScript: в библиотеку Places, службу Place Photos API JavaScript Карт при запросе данных из URL-адресов, возвращаемых PlacePhoto.getUrl() , для загрузки данных пикселей изображения. Плата не взимается до тех пор, пока URL-адрес не будет фактически использован для получения данных пикселей. Веб-сервис: запросы к сервису Place Photos API Places.
	Цены	Основная таблица цен Таблица цен в Индии

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

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

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

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

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

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