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

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

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

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

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

Категория Подпадает ли номер SKU к категории SKU Essentials, Pro или Enterprise.
Оплачиваемое мероприятие За какое событие выставляется счет для SKU.
Триггеры Какие элементы кода вызывают оплачиваемые события.
Цены Ссылки на таблицу цен для этой группы SKU.

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

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

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

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

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

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

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

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

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

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

Категория Основы
Оплачиваемое мероприятие Запрос
Триггеры

Этот SKU активируется при следующих условиях:

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

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

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

Категория Основы
Оплачиваемое мероприятие Запрос
Триггеры

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

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

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

Дополнительные сведения см. в разделе «Автозаполнение (новое)» и цены на сеансы .

Цены Основная таблица цен
Таблица цен в Индии

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

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

Категория Основы
Оплачиваемое мероприятие Запрос с указанными масками полей.
Триггеры

Этот SKU активируется, когда вы запрашиваете следующие поля:

  • Веб-сервис :
    attributions
    id
    name *
    photos

    * Поле name содержит имя ресурса места в форме: places/ PLACE_ID . Используйте displayName для доступа к текстовому названию места.

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

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

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

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

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

Этот SKU активируется, когда вы запрашиваете следующие поля местоположения:

  • Веб-сервис :
    addressComponents
    adrFormatAddress
    formattedAddress
    location
    plusCode
    shortFormattedAddress
    types
    viewport

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

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

  • Если маска поля запроса включает только поля из этого SKU : Запрос оплачивается по тарифу этого SKU. Например, вы можете запросить одно или несколько полей из этого SKU, и вам будет выставлен счет по этому тарифу 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 : Запрос оплачивается по самой высокой ставке 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 (Basic, Advanced или Preferred) , то вызов будет выставлен счет по SKU: Place Details (Preferred) . Дополнительные сведения см. в разделе SKU: использование сеанса автозаполнения .

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

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

  • Если маска поля запроса включает только поля из этого SKU : Запрос оплачивается по тарифу этого SKU. Например, вы можете запросить одно или несколько полей из этого 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 (Basic, Advanced или Preferred) , то вызов оплачивается по SKU: Place Details (Preferred) . Дополнительные сведения см. в разделе SKU: использование сеанса автозаполнения .

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

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

  • Если маска поля запроса включает только поля из этого SKU : Запрос оплачивается по тарифу этого SKU. Например, вы можете запросить одно или несколько полей из этого 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.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 : Запрос оплачивается по самой высокой ставке 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 : Запрос оплачивается по самой высокой ставке 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 : Запрос оплачивается по самой высокой ставке 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 : Запрос оплачивается по самой высокой ставке 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.primaryType
    places.primaryTypeDisplayName
    places.pureServiceAreaBusiness
    places.shortFormattedAddress
    places.subDestinations
    places.types
    places.utcOffsetMinutes
    places.viewport

    * Поле places.googleMapsLinks находится на стадии предварительной версии GA, и за нее не взимается плата, то есть оплата за использование во время предварительной версии составляет 0 долларов США.

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

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

  • Если маска поля запроса включает только поля из этого SKU : Запрос оплачивается по тарифу этого SKU. Например, вы можете запросить одно или несколько полей из этого SKU, и вам будет выставлен счет по этому тарифу 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 : Запрос оплачивается по самой высокой ставке 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 : Запрос оплачивается по самой высокой ставке SKU для запрошенных полей. Например, если вы включаете поля из нескольких SKU, таких как SKU Essentials и SKU Enterprise, то за запрос взимается плата по тарифу SKU Enterprise.
Цены Основная таблица цен
Таблица цен в Индии

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Категория Основы
Оплачиваемое мероприятие Запрос с указанными масками полей.
Триггеры Артикул базовых данных активируется, когда вы запрашиваете любое из этих полей:
  • Андроид:
    Place.Field.ACCESSIBILITY_OPTIONS
    Place.Field.ADDRESS_COMPONENTS
    Place.Field.BUSINESS_STATUS
    Place.Field.DISPLAY_NAME
    Place.Field.FORMATTED_ADDRESS
    Place.Field.ICON_BACKGROUND_COLOR
    Place.Field.ICON_MASK_URL
    Place.Field.ID
    Place.Field.LOCATION
    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 : Запрос оплачивается по самой высокой ставке SKU для запрошенных полей. Например, если вы включаете поля из нескольких SKU, таких как SKU Essentials и SKU Enterprise, то за запрос взимается плата по тарифу SKU Enterprise.
Цены Основная таблица цен
Таблица цен в Индии

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

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

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

Категория Предприятие
Оплачиваемое мероприятие Запрос с указанными масками полей.
Триггеры Артикул контактных данных активируется при запросе любого из этих полей:
  • Android: Place.Field.CURRENT_OPENING_HOURS , Place.Field.INTERNATIONAL_PHONE_NUMBER , Place.Field.OPENING_HOURS , Place.Field.SECONDARY_OPENING_HOURS или Place.Field.WEBSITE_URI
  • iOS: GMSPlaceFieldOpeningHours , GMSPlaceFieldPhoneNumber или GMSPlaceFieldWebsite
  • Веб-служба: formatted_phone_number , international_phone_number , opening_hours , current_opening_hours , secondary_opening_hours или website
Примеры выставления счетов по маске поля

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

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

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

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

Категория Предприятие
Оплачиваемое мероприятие Запрос с указанными масками полей.
Триггеры Биллинг активируется, когда вы запрашиваете любое из этих полей:
Place.Field.CURBSIDE_PICKUP
Place.Field.DELIVERY
Place.Field.EDITORIAL_SUMMARY
Place.Field.DINE_IN
Place.Field.PRICE_LEVEL
Place.Field.RATING
Place.Field.RESERVABLE
Place.Field.SERVES_BEER
Place.Field.SERVES_BREAKFAST
Place.Field.SERVES_BRUNCH
Place.Field.SERVES_DINNER
Place.Field.SERVES_LUNCH
Place.Field.SERVES_VEGETARIAN_FOOD
Place.Field.SERVES_WINE
Place.Field.TAKEOUT
Place.Field.USER_RATING_COUNT
GMSPlaceFieldPriceLevel
GMSPlaceFieldRating
GMSPlaceFieldUserRatingsTotal
GMSPlaceFieldTakeout
GMSPlaceFieldDelivery
GMSPlaceFieldDineIn
GMSPlaceFieldCurbsidePickup
GMSPlaceFieldReservable
GMSPlaceFieldServesBreakfast
GMSPlaceFieldServesLunch
GMSPlaceFieldServesDinner
GMSPlaceFieldServesBeer
GMSPlaceFieldServesWine
GMSPlaceFieldServesBrunch
GMSPlaceFieldServesVegetarianFood .
См. поля (детали места).
curbside_pickup
delivery
dine_in , editorial_summary
price_level
rating
reservable
reviews
serves_beer
serves_breakfast
serves_brunch
serves_dinner
serves_lunch ,
serves_vegetarian_food
serves_wine
takeout
user_ratings_total .
Примеры выставления счетов по маске поля

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

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

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

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

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

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

Категория Основы
Оплачиваемое мероприятие Запрос
Триггеры Выставление счетов происходит за:
Цены Основная таблица цен
Таблица цен в Индии

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

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

Категория Про
Оплачиваемое мероприятие Сессия
Триггеры Биллинг активируется, если ваше приложение отправляет эти два запроса за один сеанс:

При просмотре счета по SKU вы видите в списке следующий SKU:

  • Автозаполнение без сведений о месте – за сеанс
Цены Основная таблица цен
Таблица цен в Индии

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

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

Категория Основы
Оплачиваемое событие Сессия
Триггеры Автозаполнение (включено в информацию о месте) - за сеанс SKU взимается за сеанс автозаполнения , который включает любой из следующих запросов:
  • Android: вызов fetchPlace()
  • iOS: звонок к fetchPlaceFromPlaceID:
  • Веб -сервис: запрос сведений о местах

Запрос сведений о местах генерирует данные SKU ( базовый , контактный и/или атмосфера ) - в зависимости от поля, которые вы указываете в запросе.

Если вы не запрашиваете конкретные поля в запросе сведений о месте, запускается все данные данных (Essentials, Pro, Enterprise и Enterprise + Attosphere). Укажите только те поля, которые необходимы, чтобы избежать ненужных зарядов.

Если вы запрашиваете только обновление идентификатора сведений о месте (ваш запрос только указывает поле place_id ) во время сеанса автозаполнения, сеанс объявляется SKU: AutoComplete без деталей места - за сеанс .

Примеры

Если ваше приложение выдает следующие три вызова за один сеанс:

Веб -сервис

На вашем счете вы увидите эти перечисленные SKU (при просмотре вашего счета от SKU ):

  • Автозаполнение (включены с подробностями места) - за сеанс
  • Поместите детали
  • Основные данные
Цены Основная ценовая таблица
Ценовой стол Индии

SKU: QUERY AUTOCOMPLITE - по запросу

Это наследие SKU выставляет запросы на автозаполнение запросов.

Категория Основы
Оплачиваемое событие Запрос
Триггеры

Этот SKU запускается, когда вы делаете запрос на автозаполнение запроса, используя следующие службы:

Цены на сеанс автозаполнения не поддерживаются с использованием автозаполнения запроса. Последующие запросы сведений о местах взимаются на основе деталей места Pro Sku .

Цены Основная ценовая таблица
Ценовой стол Индии

SKU: Поместите детали Pro

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

Категория Про
Оплачиваемое событие Запрос
Триггеры Счета запрашивается для запросов из следующих API:

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

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

Примеры
  1. Сделайте один из этих звонков или запросов:
    • Mobile: Call fetchPlace() на Android или fetchPlaceFromPlaceID: на iOS и укажите только поле ADDRESS
    • Веб -API или сервис: сделайте запрос на информацию о местах и ​​укажите только поле адреса: getPlaceDetails(fields: formatted_address)
    На вашем счете вы увидите эти перечисленные SKU (при просмотре вашего счета от SKU ):
    • Поместите детали
    • Основные данные
  2. Сделайте один из этих звонков или запросов:
    • Mobile: Call fetchPlace() на Android или fetchPlaceFromPlaceID: на iOS и укажите только поле PHONE_NUMBER
    • Веб -API или служба: сделайте запрос на информацию о месте и укажите поле номера телефона: getPlaceDetails(fields: formatted_phone_number)
    На вашем счете вы увидите эти перечисленные SKU (при просмотре вашего счета от SKU ):
    • Поместите детали
    • Контактные данные
  3. Сделайте один из этих звонков или запросов:
    • Mobile: Call fetchPlace() на Android или fetchPlaceFromPlaceID: на iOS и укажите все поля
    • Веб -API или служба: сделайте запрос сведений о местах и ​​укажите все поля (этот тип запроса является по умолчанию, если вы не указываете никаких полей): getPlaceDetails() .
    На вашем счете вы увидите эти перечисленные SKU (при просмотре вашего счета от SKU ):
    • Поместите детали
    • Основные данные
    • Контактные данные
    • Данные атмосферы
Цены Основная ценовая таблица
Ценовой стол Индии

SKU: Разместите детали - ID обновление

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

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

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

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

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

Категория Про
Оплачиваемое событие Запрос
Триггеры Этот SKU выставляет счет за запросы на следующие методы:
  • Найдите текущее место

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

Примеры

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

  1. Вы делаете запрос Find Place и указываете только поле адреса: FindPlace(fields: formatted_address) . Ваш счет показывает эти Skus:
    • Найти место
    • Основные данные
  2. Вы делаете запрос Find Place и указываете поле номера телефона: FindPlace(fields: formatted_phone_number) . Ваш счет показывает эти Skus:
    • Найти место
    • Контактные данные
  3. Вы делаете запрос Find Place и указываете поля из всех трех ведер типа данных: FindPlace(fields: formatted_address, opening_hours, price_level) . Ваш счет показывает эти Skus:
    • Найти место
    • Основные данные
    • Контактные данные
    • Данные атмосферы
Цены Основная ценовая таблица
Ценовой стол Индии

SKU: найти место - только удостоверение личности

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

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

SKU: места - близлежащий поиск

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

Категория Про
Оплачиваемое событие Запрос
Триггеры Этот SKU запускается, когда вы делаете ближайший запрос на поиск, используя один из следующих API:

Этот запрос не подтверждает указание того, какие поля вернуть. Ответ возвращает список мест и подмножество поддерживаемых полей данных .

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

Примеры

Вы делаете ближайший запрос на поиск, такой как NearbySearch (San Francisco, 100 meters) . Ваш счет показывает эти Skus при просмотре вашего счета от SKU :

  • Место
  • Основные данные
  • Контактные данные
  • Данные атмосферы
Цены Основная ценовая таблица
Ценовой стол Индии

SKU: места - Поиск текста

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

Категория Про
Оплачиваемое событие Запрос
Триггеры Биллинг запускается для запросов на следующие услуги:

Запросы на текстовый поиск возвращают список мест, но не поддерживают указание, какие поля возвращаются. Запросы на текстовый поиск возвращает подмножество поддерживаемых полей данных . У вас взимается плата за запрос на поиск текста, а также все SKU типа данных: основные данные , контактные данные и данные атмосферы .

Место - Text Search Sku также запускается методом Maps JavaScript Place Videbox Widget : getPlaces() после того, как пользователь выбирает запрос «Место» (значок: увеличение), а не результат (значок: PIN -код), как показано здесь:

Размещение сведений о поиске в поле поиска запрашивания запроса
В результатах виджета поиска, после ввода «Пиццы» в поле поиска, обратите внимание, что доставка пиццы имеет значок увеличения рядом с ней, что указывает на то, что это запрашивание места (а не результат).
Пример

Если вы делаете запрос на поиск текстового поиска, такой как TextSearch(123 Main Street) , ваш счет показывает эти Skus при просмотре вашего счета от SKU :

  • Место - Поиск текста
  • Основные данные
  • Контактные данные
  • Данные атмосферы
Цены Основная ценовая таблица
Ценовой стол Индии

SKU: места API размещает детали фотографий

Этот SKU выставляет платеж за Photo Service Photo Service.

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

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

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

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

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

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

Для получения информации об Условиях использования см. Политики для API Place и раздел ограничений лицензий в Условиях обслуживания платформы Google Maps.