Places SDK для использования Android и выставления счетов

Щелкните значок информации , чтобы просмотреть содержание этой страницы.

Выставление счетов и цены на Places SDK для Android

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

Детали SKU продукта Places SDK для Android

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

Используйте маски полей, также называемые списками полей , в своих запросах, чтобы указать список полей, возвращаемых в ответе. Затем вам будет выставлен счет по самому высокому номеру SKU, соответствующему вашему запросу. Это означает, что если вы выберете поля как в (Базовом), так и в (Расширенном) SKU, вам будет выставлен счет на основе (Расширенного) SKU.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • Андроид :
    Place.Field.DISPLAY_NAME
    Place.Field.ID
    Place.Field.PHOTO_METADATAS
    Place.Field.RESOURCE_NAME

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

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

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

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

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

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

  • Андроид :
    Place.Field.ADDRESS_COMPONENTS
    ADR_FORMAT_ADDRESS
    Place.Field.FORMATTED_ADDRESS
    Place.Field.LOCATION
    Place.Field.PLUS_CODE
    Place.Field.SHORT_FORMATTED_ADDRESS
    Place.Field.TYPES
    Place.Field.VIEWPORT

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

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

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

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

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

Категория Про
Оплачиваемое мероприятие Запрос с указанными масками полей.
Триггеры Этот SKU активируется, когда вы запрашиваете только следующие поля или поля с более низкой ставкой:
  • Андроид :
    Place.Field.ACCESSIBILITY_OPTIONS
    Place.Field.BUSINESS_STATUS
    Place.Field.GOOGLE_MAPS_URI
    Place.Field.ICON_BACKGROUND_COLOR
    Place.Field.ICON_MASK_URL
    Place.Field.PRIMARY_TYPE
    Place.Field.PRIMARY_TYPE_DISPLAY_NAME
    Place.Field.SUB_DESTINATIONS
    Place.Field.UTC_OFFSET

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

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

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

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

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

Категория Предприятие
Оплачиваемое мероприятие Запрос с указанными масками полей.
Триггеры Этот SKU активируется, когда вы запрашиваете следующие поля:
  • Android : Place.Field.CURRENT_OPENING_HOURS
    Place.Field.CURRENT_SECONDARY_OPENING_HOURS
    Place.Field.INTERNATIONAL_PHONE_NUMBER
    Place.Field.NATIONAL_PHONE_NUMBER
    Place.Field.OPENING_HOURS
    Place.Field.PRICE_LEVEL
    Place.Field.RATING
    Place.Field.SECONDARY_OPENING_HOURS
    Place.Field.USER_RATING_COUNT
    Place.Field.WEBSITE_URI

Если вы завершаете сеанс автозаполнения с помощью вызова 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 активируется, когда вы запрашиваете следующие поля:

  • Андроид :
    Place.Field.ALLOWS_DOGS
    Place.Field.CURBSIDE_PICKUP
    Place.Field.DELIVERY
    Place.Field.DINE_IN
    Place.Field.EDITORIAL_SUMMARY
    Place.Field.EV_CHARGE_OPTIONS
    Place.Field.FUEL_OPTIONS
    Place.Field.GOOD_FOR_CHILDREN
    Place.Field.GOOD_FOR_GROUPS
    Place.Field.GOOD_FOR_WATCHING_SPORTS
    Place.Field.LIVE_MUSIC
    Place.Field.MENU_FOR_CHILDREN
    Place.Field.OUTDOOR_SEATING
    Place.Field.PARKING_OPTIONS
    Place.Field.PAYMENT_OPTIONS
    Place.Field.RESERVABLE
    Place.Field.RESTROOM
    Place.Field.REVIEWS
    Place.Field.SERVES_BEER
    Place.Field.SERVES_BREAKFAST
    Place.Field.SERVES_BRUNCH
    Place.Field.SERVES_COCKTAILS
    Place.Field.SERVES_COFFEE
    Place.Field.SERVES_DESSERT
    Place.Field.SERVES_DINNER
    Place.Field.SERVES_LUNCH
    Place.Field.SERVES_VEGETARIAN_FOOD
    Place.Field.SERVES_WINE
    Place.Field.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 активируется, когда вы запрашиваете только следующие поля или поля с более низкой ставкой:
  • Андроид :
    Place.Field.ADDRESS_COMPONENTS
    Place.Field.BUSINESS_STATUS
    Place.Field.ADDRESS
    Place.Field.ICON_BACKGROUND_COLOR
    Place.Field.ICON_URL
    Place.Field.LAT_LNG
    Place.Field.PHOTO_METADATAS
    Place.Field.PLUS_CODE
    Place.Field.PRIMARY_TYPE
    Place.Field.PRIMARY_TYPE_DISPLAY_NAME
    Place.Field.ID
    Place.Field.NAME
    Place.Field.TYPES
    Place.Field.UTC_OFFSET
    Place.Field.VIEWPORT
    Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE

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

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

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

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

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

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

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

  • Андроид :
    Place.Field.CURRENT_OPENING_HOURS
    Place.Field.CURRENT_SECONDARY_OPENING_HOURS
    Place.Field.INTERNATIONAL_PHONE_NUMBER
    Place.Field.NATIONAL_PHONE_NUMBER
    Place.Field.OPENING_HOURS
    Place.Field.PRICE_LEVEL
    Place.Field.RATING
    Place.Field.SECONDARY_OPENING_HOURS
    Place.Field.USER_RATING_COUNT
    Place.Field.WEBSITE_URI

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

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

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

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

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

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

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

  • Андроид :
    Place.Field.ALLOWS_DOGS
    Place.Field.CURBSIDE_PICKUP
    Place.Field.DELIVERY
    Place.Field.DINE_IN
    Place.Field.EDITORIAL_SUMMARY
    Place.Field.EV_CHARGE_OPTIONS
    Place.Field.FUEL_OPTIONS
    Place.Field.GOOD_FOR_CHILDREN
    Place.Field.GOOD_FOR_GROUPS
    Place.Field.GOOD_FOR_WATCHING_SPORTS
    Place.Field.LIVE_MUSIC
    Place.Field.MENU_FOR_CHILDREN
    Place.Field.OUTDOOR_SEATING
    Place.Field.PARKING_OPTIONS
    Place.Field.PAYMENT_OPTIONS
    Place.Field.RESERVABLE
    Place.Field.RESTROOM
    Place.Field.REVIEWS
    Place.Field.SERVES_BEER
    Place.Field.SERVES_BREAKFAST
    Place.Field.SERVES_BRUNCH
    Place.Field.SERVES_COCKTAILS
    Place.Field.SERVES_COFFEE
    Place.Field.SERVES_DESSERT
    Place.Field.SERVES_DINNER
    Place.Field.SERVES_LUNCH
    Place.Field.SERVES_VEGETARIAN_FOOD
    Place.Field.SERVES_WINE
    Place.Field.TAKEOUT

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

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

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

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

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

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

  • Андроид :
    Place.Field.DISPLAY_NAME
    Place.Field.ID
    Place.Field.RESOURCE_NAME

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

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

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

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

Этот номер SKU представляет собой номер SKU данных , за который взимается плата за поля, указанные вами в запросе Text Search Pro .
Категория Про
Оплачиваемое мероприятие Запрос с указанными масками полей.
Триггеры Этот SKU активируется, когда вы запрашиваете только следующие поля или поля с более низкой ставкой:
  • Андроид :
    Place.Field.ACCESSIBILITY_OPTIONS
    Place.Field.ADDRESS_COMPONENTS
    Place.Field.ADR_FORMAT_ADDRESS
    Place.Field.BUSINESS_STATUS
    Place.Field.FORMATTED_ADDRESS
    Place.Field.GOOGLE_MAPS_URI
    Place.Field.ICON_BACKGROUND_COLOR
    Place.Field.ICON_MASK_URL
    Place.Field.LOCATION
    Place.Field.PHOTO_METADATAS
    Place.Field.PLUS_CODE
    Place.Field.PRIMARY_TYPE
    Place.Field.PRIMARY_TYPE_DISPLAY_NAME
    Place.Field.SHORT_FORMATTED_ADDRESS
    Place.Field.SUB_DESTINATIONS
    Place.Field.TYPES
    Place.Field.UTC_OFFSET
    Place.Field.VIEWPORT

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

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

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

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

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

Категория Предприятие
Оплачиваемое мероприятие Запрос с указанными масками полей.
Триггеры Этот SKU активируется, когда вы запрашиваете следующие поля:
  • Андроид :
    Place.Field.CURRENT_OPENING_HOURS
    Place.Field.CURRENT_SECONDARY_OPENING_HOURS
    Place.Field.INTERNATIONAL_PHONE_NUMBER
    Place.Field.NATIONAL_PHONE_NUMBER
    Place.Field.OPENING_HOURS
    Place.Field.PRICE_LEVEL
    Place.Field.RATING
    Place.Field.SECONDARY_OPENING_HOURS
    Place.Field.USER_RATING_COUNT
    Place.Field.WEBSITE_URI

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

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

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

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

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

Категория Предприятие
Оплачиваемое мероприятие Запрос
Триггеры Этот SKU активируется, когда вы запрашиваете следующие поля:
  • Андроид :
    Place.Field.ALLOWS_DOGS
    Place.Field.CURBSIDE_PICKUP
    Place.Field.DELIVERY
    Place.Field.DINE_IN
    Place.Field.EDITORIAL_SUMMARY
    Place.Field.EV_CHARGE_OPTIONS
    Place.Field.FUEL_OPTIONS
    Place.Field.GOOD_FOR_CHILDREN
    Place.Field.GOOD_FOR_GROUPS
    Place.Field.GOOD_FOR_WATCHING_SPORTS
    Place.Field.LIVE_MUSIC
    Place.Field.MENU_FOR_CHILDREN
    Place.Field.OUTDOOR_SEATING
    Place.Field.PARKING_OPTIONS
    Place.Field.PAYMENT_OPTIONS
    Place.Field.RESERVABLE
    Place.Field.RESTROOM
    Place.Field.REVIEWS
    Place.Field.SERVES_BEER
    Place.Field.SERVES_BREAKFAST
    Place.Field.SERVES_BRUNCH
    Place.Field.SERVES_COCKTAILS
    Place.Field.SERVES_COFFEE
    Place.Field.SERVES_DESSERT
    Place.Field.SERVES_DINNER
    Place.Field.SERVES_LUNCH
    Place.Field.SERVES_VEGETARIAN_FOOD
    Place.Field.SERVES_WINE
    Place.Field.TAKEOUT

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

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

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

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

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

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

Подробности о устаревшем коде Places SDK для Android

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

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

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

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

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

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

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

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

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

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

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

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

Этот номер 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
Примеры выставления счетов по маске поля

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

  • Если маска поля запроса включает только поля из этого 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 данных ( Базовый , Контакт и/или Атмосфера ) — в зависимости от полей, которые вы указываете в запросе.

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

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

Примеры

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

Веб-сервис

В вашем счете вы увидите следующие SKU (при просмотре счета по SKU ):

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

Артикул: Place Details Pro

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

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

При использовании веб-API и служб за номер SKU Place Details взимается плата независимо от того, предоставляете ли вы токен сеанса или нет.

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

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

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

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

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

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

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

Примеры

В следующих примерах показано, за какие SKU вам выставляется счет при отправке запроса «Найти текущее место» и указании полей из SKU «Базовые», «Контактные данные» и «Атмосфера». Чтобы увидеть номера SKU в своем счете, просмотрите счет по SKU, как описано в разделе Анализ использования и стоимости каждого SKU .

  1. Вы делаете запрос findCurrentPlace() (Android) или findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) и указываете только поле ADDRESS . В вашем счете указаны следующие SKU:
    • Найти текущее место
    • Основные данные
  2. Вы делаете запрос findCurrentPlace() (Android) или findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) и указываете поле PHONE_NUMBER . В вашем счете указаны следующие SKU:
    • Найти текущее место
    • Контактные данные
  3. Вы делаете запрос findCurrentPlace() (Android) или findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) и указываете поля из всех трех сегментов типов данных. В вашем счете указаны следующие SKU:
    • Найти текущее место
    • Основные данные
    • Контактные данные
    • Данные об атмосфере
Цены Основная таблица цен
Таблица цен в Индии

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

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

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

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

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