Как оплачивается Places API
API Places (новый) и API Places используют модель ценообразования с оплатой по мере использования. Плата за API и SDK платформы Google Maps выставляется по SKU. Использование отслеживается для каждого SKU, и любой API или SDK может иметь более одного SKU продукта . Стоимость рассчитывается по:
Воспользуйтесь нашим калькулятором цен и использования , чтобы оценить стоимость использования API или SDK. Для соответствующих SKU платформы Google Карт ежемесячно для каждого платежного аккаунта предоставляется кредит платформы Google Maps в размере 200 долларов США. Этот кредит автоматически применяется к соответствующим SKU.
Цены на Places API (новинка)
О масках полей
Для сведений о месте (новое), поиска поблизости (новое) и текстового поиска (новое) используйте заголовок FieldMask
в запросах API, чтобы указать список полей, возвращаемых в ответе. Затем вам будет выставлен счет по самому высокому номеру SKU, соответствующему вашему запросу. Это означает, что если вы выберете поля как в (Базовом), так и в (Расширенном) SKU, вам будет выставлен счет на основе (Расширенного) SKU.
Использование маскировки полей — это хорошая практика проектирования, позволяющая гарантировать, что вы не запрашиваете ненужные данные, что помогает избежать ненужного времени обработки и затрат на выставление счетов.
О сеансах автозаполнения (новых)
Сеанс автозаполнения (новый) включает в себя один или несколько запросов автозаполнения (новый), а также запрос сведений о месте (новый) или запрос проверки адреса. Один и тот же токен сеанса передается в запрос автозаполнения (новый) и в последующий запрос сведений о месте (новый) или запрос проверки адреса.
Сеанс начинается с первого запроса автозаполнения (нового). Запрос сведений о месте (новый) или запрос проверки адреса выполняется, когда пользователь выбирает одно из предложений автозаполнения (новый). Если сеанс прерывается, то есть не выполняется запрос сведений о месте (новый) или запрос на проверку адреса, за запросы автозаполнения (новый) взимается плата, как если бы токен сеанса не был предоставлен.
После того, как пользователь выбрал место (то есть был сделан запрос сведений о месте (новое) или запрос проверки адреса), вы должны начать новый сеанс, используя новый токен сеанса.
Токен сеанса подходит для одного сеанса и не может использоваться более чем для одного сеанса. Если вы повторно используете токен сеанса, сеанс считается недействительным, а за запросы взимается плата, как если бы токен сеанса не был предоставлен.
Артикул: Автозаполнение запросов
SKU запросов автозаполнения взимается за каждый запрос к API автозаполнения (нового), который не включает токен сеанса.
Также взимается плата, если вы используете токены сеанса и:
- Завершите сеансы одним запросом к Place Details (New), который запрашивает любые поля, определенные SKU: Place Details (только местоположение) .
- Каждый запрос автозаполнения (новый) (до 12 запросов) оплачивается с использованием SKU: Запросы автозаполнения .
- Каждый последующий запрос автозаполнения (новый) оплачивается с использованием SKU: Использование сеанса автозаполнения .
- Откажитесь от сеанса или завершите его, выполнив вызов SKU: Place Details (только идентификаторы) . Все запросы автозаполнения (новые) затем оплачиваются с использованием SKU: Запросы автозаполнения .
ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за ЗВОНОК) | ||
---|---|---|
| | |
0,00283 доллара США за каждого (2,83 доллара США за 1000) | 0,00227 долларов США за каждого (2,27 доллара США за 1000) | Свяжитесь с отделом продаж для уточнения оптовых цен. |
Артикул: Использование сеанса автозаполнения
Артикул использования сеанса автозаполнения взимается за каждый запрос к API автозаполнения (нового), который включает токен сеанса.
Плата за этот номер SKU взимается в следующих случаях:
Сеанс автозаполнения прерван вызовом SKU: Place Details (только местоположение) :
- Каждый запрос автозаполнения (новый) (до 12 запросов) оплачивается с использованием SKU: Запросы автозаполнения .
- Каждый последующий запрос автозаполнения (новый) оплачивается с использованием SKU: Использование сеанса автозаполнения .
Сеанс автозаполнения завершился вызовом SKU: Place Details (Basic, Advanced или Preferred) .
Вызов Place Details, который запрашивает любое поле из SKU: Place Details (Basic, Advanced или Preferred), оплачивается по SKU: Place Details (Preferred) .
Сеанс автозаполнения завершился вызовом SKU: Предпочтительная проверка адреса .
Дополнительные сведения см. в разделе «Автозаполнение (новое)» и цены на сеансы .
ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за ЗВОНОК) | ||
---|---|---|
| | |
0,00 доллара США за каждого (0,00 доллара США за 1000) | 0,00 доллара США за каждого (0,00 доллара США за 1000) | 0,00 доллара США за каждого (0,00 доллара США за 1000) |
Артикул: Сведения о месте (только идентификаторы)
Используя маску полей или список полей в запросе сведений о месте (новое), вы можете ограничить ответ только указанными полями. Этот SKU активируется, когда вы запрашиваете только следующие поля:
Веб-сервис : attributions
, id
, name
* , photos
* Поле name
содержит название ресурса места в виде places/ PLACE_ID
. Используйте displayName
для доступа к текстовому названию места.
ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за ЗВОНОК) | ||
---|---|---|
| | |
0,0 доллара США за каждого (0,00 доллара США за 1000) | 0,0 доллара США за каждого (0,00 доллара США за 1000) | 0,0 доллара США за каждого (0,00 доллара США за 1000) |
Артикул: Подробности о месте (только местоположение)
Используя маску полей или список полей в запросе сведений о месте (новое), вы можете ограничить ответ только указанными полями. Этот SKU активируется, когда вы запрашиваете только следующие поля:
Веб-сервис : addressComponents
, adrFormatAddress
, formattedAddress
, location
, plusCode
, shortFormattedAddress
, types
, viewport
ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за ЗВОНОК) | ||
---|---|---|
| | |
0,005 доллара США за каждого (5,00 долларов США за 1000) | 0,004 доллара США за каждого (4,00 доллара США за 1000) | Свяжитесь с отделом продаж для уточнения оптовых цен. |
Артикул: Детали места (базовый)
Используя маску полей или список полей в запросе сведений о месте (новое), вы можете ограничить ответ только указанными полями. Этот SKU активируется, когда вы запрашиваете только следующие поля:
Веб-сервис : accessibilityOptions
, businessStatus
, displayName
, googleMapsUri
, iconBackgroundColor
, iconMaskBaseUri
, primaryType
, primaryTypeDisplayName
, subDestinations
, utcOffsetMinutes
Если сеанс автозаполнения завершается вызовом Place Details, который запрашивает любое поле из SKU: Place Details (Basic, Advanced или Preferred) , то вызов оплачивается по SKU: Place Details (Preferred) . Дополнительные сведения см. в разделе SKU: использование сеанса автозаполнения .
ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за ЗВОНОК) | ||
---|---|---|
| | |
0,0170 долларов США за каждого (17,00 долларов США за 1000) | 0,0136 доллара США за каждого (13,60 долларов США за 1000) | Свяжитесь с отделом продаж для уточнения оптовых цен. |
Артикул: Сведения о месте (расширенный)
Используя маску полей или список полей в запросе сведений о месте (новое), вы можете ограничить ответ только указанными полями. Этот SKU активируется, когда вы запрашиваете только следующие поля:
Веб-сервис : currentOpeningHours
, currentSecondaryOpeningHours
, internationalPhoneNumber
, nationalPhoneNumber
, priceLevel
, rating
, regularOpeningHours
, regularSecondaryOpeningHours
, userRatingCount
, websiteUri
Если сеанс автозаполнения завершается вызовом Place Details, который запрашивает любое поле из SKU: Place Details (Basic, Advanced или Preferred) , то вызов оплачивается по SKU: Place Details (Preferred) . Дополнительные сведения см. в разделе SKU: использование сеанса автозаполнения .
ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за ЗВОНОК) | ||
---|---|---|
| | |
0,020 доллара США за каждого (20,00 долларов США за 1000) | 0,016 доллара США за каждого (16,00 долларов США за 1000) | Свяжитесь с отделом продаж для уточнения оптовых цен. |
Артикул: Подробности о месте (предпочтительно)
Используя маску полей или список полей в запросе «Сведения о месте (новое)», вы можете ограничить ответ только указанными полями. Этот SKU активируется, когда вы запрашиваете только следующие поля:
Веб-сервис : allowsDogs
, curbsidePickup
, delivery
, dineIn
, editorialSummary
, evChargeOptions
, fuelOptions
, goodForChildren
, goodForGroups
, goodForWatchingSports
, liveMusic
, menuForChildren
детей, parkingOptions
, paymentOptions
, outdoorSeating
, reservable
, restroom
, reviews
, servesBeer
, servesBreakfast
, servesCoffee
, servesBrunch
, servesCocktails
, servesDessert
, servesDinner
, servesLunch
, servesVegetarianFood
, servesWine
, takeout
Если сеанс автозаполнения завершается вызовом Place Details, который запрашивает любое поле из SKU: Place Details (Basic, Advanced или Preferred) , то вызов оплачивается по SKU: Place Details (Preferred) . Дополнительные сведения см. в разделе SKU: использование сеанса автозаполнения .
ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за ЗВОНОК) | ||
---|---|---|
| | |
0,025 доллара США за каждого (25,00 долларов США за 1000) | 0,020 доллара США за каждого (20,00 долларов США за 1000) | Свяжитесь с отделом продаж для уточнения оптовых цен. |
Артикул: Поиск поблизости (базовый)
Используя маску полей или список полей в запросе «Поиск поблизости (новый)», вы можете ограничить ответ только указанными полями. Этот SKU активируется, когда вы запрашиваете только следующие поля:
Веб-сервис : places.accessibilityOptions
, places.addressComponents
, places.adrFormatAddress
, places.attributions
, places.businessStatus
, places.displayName
, places.formattedAddress
, places.googleMapsUri
, places.iconBackgroundColor
, places.iconMaskBaseUri
, places.id
, places.location
, places.name
* , places.photos
, places.plusCode
, places.primaryType
, places.primaryTypeDisplayName
, places.shortFormattedAddress
, places.subDestinations
, places.types
, places.utcOffsetMinutes
, places.viewport
* Поле places.name
содержит имя ресурса места в форме: places/ PLACE_ID
. Используйте places.displayName
для доступа к текстовому названию места.
ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за ЗВОНОК) | ||
---|---|---|
| | |
0,032 доллара США за каждого (32,00 долларов США за 1000) | 0,0256 долларов США за каждого (25,60 долларов США за 1000) | Свяжитесь с отделом продаж для уточнения оптовых цен. |
Артикул: Поиск поблизости (расширенный)
Используя маску полей или список полей в запросе «Поиск поблизости (новый)», вы можете ограничить ответ только указанными полями. Этот SKU активируется, когда вы запрашиваете только следующие поля:
Веб-сервис : places.currentOpeningHours
, places.currentSecondaryOpeningHours
, places.internationalPhoneNumber
, places.nationalPhoneNumber
, places.priceLevel
, places.rating
, places.regularOpeningHours
, places.regularSecondaryOpeningHours
, places.userRatingCount
, places.websiteUri
ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за ЗВОНОК) | ||
---|---|---|
| | |
0,035 доллара США за каждого (35,00 долларов США за 1000) | 0,028 доллара США за каждого (28,00 долларов США за 1000) | Свяжитесь с отделом продаж для уточнения оптовых цен. |
Артикул: Поиск поблизости (предпочтительно)
Используя маску полей или список полей в запросе «Поиск поблизости (новый)», вы можете ограничить ответ только указанными полями. Этот 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.servesCoffee
, места.резервируемый , places.reservable
, places.restroom
, places.reviews
, places.servesBeer
, places.servesBreakfast
, places.servesBrunch
, places.servesCocktails
, places.servesDessert
, places.servesDinner
, places.servesLunch
, places.servesVegetarianFood
, places.servesWine
, places.takeout
ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за ЗВОНОК) | ||
---|---|---|
| | |
0,040 доллара США за каждого (40,00 долларов США за 1000) | 0,032 доллара США за каждого (32,00 долларов США за 1000) | Свяжитесь с отделом продаж для уточнения оптовых цен. |
Артикул: Текстовый поиск (только идентификатор)
Используя маску полей или список полей в запросе «Текстовый поиск (новый)», вы можете ограничить ответ только указанными полями. Этот SKU активируется, когда вы запрашиваете только следующие поля:
Веб-сервис : places.attributions
, places.id
, places.name
* , nextPageToken
* Поле places.name
содержит имя ресурса места в форме: places/ PLACE_ID
. Используйте places.displayName
для доступа к текстовому названию места.
ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за ЗВОНОК) | ||
---|---|---|
| | |
0,0 доллара США за каждого (0,00 доллара США за 1000) | 0,0 доллара США за каждого (0,00 доллара США за 1000) | 0,0 доллара США за каждого (0,00 доллара США за 1000) |
Артикул: Текстовый поиск (базовый)
Используя маску полей или список полей в запросе «Текстовый поиск (новый)», вы можете ограничить ответ только указанными полями. Этот SKU активируется, когда вы запрашиваете только следующие поля:
Веб-сервис : places.accessibilityOptions
, places.addressComponents
, places.adrFormatAddress
, places.businessStatus
, places.displayName
, places.formattedAddress
, places.googleMapsUri
, places.iconBackgroundColor
, places.iconMaskBaseUri
, places.location
, places.photos
, places.plusCode
, places.primaryType
, places.primaryTypeDisplayName
, places.shortFormattedAddress
, places.subDestinations
, places.types
, places.utcOffsetMinutes
, places.viewport
ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за ЗВОНОК) | ||
---|---|---|
| | |
0,032 доллара США за каждого (32,00 долларов США за 1000) | 0,0256 долларов США за каждого (25,60 долларов США за 1000) | Свяжитесь с отделом продаж для уточнения оптовых цен. |
Артикул: Текстовый поиск (расширенный)
Используя маску полей или список полей в запросе «Текстовый поиск (новый)», вы можете ограничить ответ только указанными полями. Этот SKU активируется, когда вы запрашиваете только следующие поля:
Веб-сервис : places.currentOpeningHours
, places.currentSecondaryOpeningHours
, places.internationalPhoneNumber
, places.nationalPhoneNumber
, places.priceLevel
, places.rating
, places.regularOpeningHours
, places.regularSecondaryOpeningHours
, places.userRatingCount
, places.websiteUri
ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за ЗВОНОК) | ||
---|---|---|
| | |
0,035 доллара США за каждого (35,00 долларов США за 1000) | 0,028 доллара США за каждого (28,00 долларов США за 1000) | Свяжитесь с отделом продаж для уточнения оптовых цен. |
Артикул: Текстовый поиск (предпочтительно)
Используя маску полей или список полей в запросе «Текстовый поиск (новый)», вы можете ограничить ответ только указанными полями. Этот 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.servesCoffee
places.reservable
, places.restroom
, places.reviews
, places.servesBeer
, места.сервыЗавтрак , places.servesBreakfast
, places.servesBrunch
, places.servesCocktails
, places.servesDessert
, places.servesDinner
, places.servesLunch
, places.servesVegetarianFood
, places.servesWine
, places.takeout
ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за ЗВОНОК) | ||
---|---|---|
| | |
0,040 доллара США за каждого (40,00 долларов США за 1000) | 0,032 доллара США за каждого (32,00 долларов США за 1000) | Свяжитесь с отделом продаж для уточнения оптовых цен. |
Артикул: Разместить фото
За каждый запрос к API взимается SKU Place Photo .
ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за ЗВОНОК) | ||
---|---|---|
| | |
0,007 доллара США за каждого (7,00 долларов США за 1000) | 0,0056 доллара США за каждого (5,60 долларов США за 1000) | Свяжитесь с отделом продаж для уточнения оптовых цен. |
Цены на Places API
О сеансах автозаполнения
Сеанс автозаполнения включает в себя несколько запросов автозаполнения (для получения предложений о месте по мере ввода пользователем) и не более одного запроса сведений о местах (для получения сведений о месте, выбранном пользователем). Один и тот же токен сеанса передается при автозаполнении и последующем запросе сведений о месте. Сеанс начинается с первого запроса автозаполнения (который обычно происходит, когда пользователь начинает печатать). Вызов Place Details выполняется, когда пользователь выбирает одно из предложений автозаполнения. Если пользователь не выбирает предложение, вызов Place 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 поддерживают указание возвращаемых полей данных:
Для веб-службы эти вызовы API-интерфейсов Places НЕ поддерживают указание возвращаемых полей. Эти вызовы всегда возвращают все данные Places, взимая плату за три SKU данных Places в дополнение к плате за каждый запрос API:
Артикул: Основные данные
Используя параметр полей в запросе «Сведения о месте» или «Найти место», вы можете ограничить ответ только указанными полями. Поля категории «Базовый » включены в базовую стоимость запроса мест и не требуют дополнительной оплаты. Артикул базовых данных активируется при запросе любого из этих полей:
- Android:
Place.Field.ADDRESS
,Place.Field.ADDRESS_COMPONENTS
,Place.Field.BUSINESS_STATUS
,Place.Field.ICON_BACKGROUND_COLOR
,Place.Field.ICON_URL
,Place.Field.ID
,Place.Field.LAT_LNG
,Place.Field.NAME
,Place.Field.PHOTO_METADATAS
,Place.Field.PLUS_CODE
,Place.Field.TYPES
,Place.Field.VIEWPORT
,Place.Field.UTC_OFFSET
илиPlace.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
- 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
ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за ЗВОНОК) | ||
---|---|---|
| | |
Стоимость запроса мест + 0,00 долларов США | Стоимость запроса мест + 0,00 долларов США | Стоимость запроса мест + 0,00 долларов США |
Артикул: Контактные данные
Используя параметр полей в запросе Place Details или Find Place для веб-служб или массив Place.Field
для Android или iOS, вы можете ограничить ответ только указанными полями. Поля в категории «Контакты» требуют дополнительной оплаты. Артикул контактных данных активируется при запросе любого из этих полей:
- Android:
Place.Field.CURRENT_OPENING_HOURS
,Place.Field.OPENING_HOURS
,Place.Field.PHONE_NUMBER
,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
ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за ЗВОНОК) | ||
---|---|---|
| | |
Стоимость запроса мест + 0,003 доллара США за каждого (+ 3,00 доллара США за 1000) | Стоимость запроса мест + 0,0024 доллара США за каждого (+ 2,40 доллара США за 1000) | Свяжитесь с отделом продаж для уточнения оптовых цен. |
Артикул: Данные об атмосфере
Используя параметр полей в запросе «Сведения о месте» или «Найти место», вы можете ограничить ответ только указанными полями. За поля в категории «Атмосфера» взимается дополнительная плата. Артикул данных об атмосфере активируется при запросе любого из этих полей:
- Android:
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_RATINGS_TOTAL
- iOS:
GMSPlaceFieldPriceLevel
,GMSPlaceFieldRating
,GMSPlaceFieldUserRatingsTotal
,GMSPlaceFieldTakeout
,GMSPlaceFieldDelivery
,GMSPlaceFieldDineIn
,GMSPlaceFieldCurbsidePickup
,GMSPlaceFieldReservable
,GMSPlaceFieldServesLunch
GMSPlaceFieldServesVegetarianFood
GMSPlaceFieldServesBreakfast
GMSPlaceFieldServesDinner
GMSPlaceFieldServesBeer
GMSPlaceFieldServesBrunch
илиGMSPlaceFieldServesWine
. - JavaScript : см. поля (детали места).
- Веб-сервис :
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
.
ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за ЗВОНОК) | ||
---|---|---|
| | |
Стоимость запроса мест + 0,005 доллара США за каждого (+ 5,00 долларов США за 1000) | Стоимость запроса мест + 0,004 доллара США за каждого (+ 4,00 долларов США за 1000) | Свяжитесь с отделом продаж для уточнения оптовых цен. |
Артикул: Автозаполнение – по запросу
Артикул «Автозаполнение — по запросу» взимается за любой из этих вызовов или запросов, которые не включают токен сеанса:
- Android:
findAutocompletePredictions()
- iOS:
findAutocompletePredictionsFromQuery:
- JavaScript: служба автозаполнения мест Maps JavaScript API
- Веб-сервис: служба автозаполнения мест Places API.
За вызовы, сделанные из недействительного сеанса автозаполнения (например, сеанса, в котором повторно используется токен сеанса), также взимается плата за номер SKU «Автозаполнение — по запросу».
За запросы автозаполнения из виджета автозаполнения мест Maps JavaScript API может взиматься плата за автозаполнение — номер SKU за запрос, если вызовы выполняются из недействительного сеанса автозаполнения. Это может произойти, когда пользователь вводит несколько разных адресов или копирует/вставляет разные адреса в виджет и не всегда выбирает подсказку автозаполнения.
ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за ЗАПРОС) | ||
---|---|---|
| | |
0,00283 доллара США за каждого (2,83 доллара США за 1000) | 0,00227 долларов США за каждого (2,27 доллара США за 1000) | Свяжитесь с отделом продаж для уточнения оптовых цен. |
Артикул: автозаполнение без сведений о месте – за сеанс
За автозаполнение без сведений о месте — SKU за сеанс взимается плата за сеанс автозаполнения , который не включает запрос сведений о месте (в течение нескольких минут после начала сеанса).
ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за СЕАНС) | ||
---|---|---|
| | |
0,017 доллара США за каждого (17,00 долларов США за 1000) | 0,0136 доллара США за каждого (13,60 долларов США за 1000) | Свяжитесь с отделом продаж для уточнения оптовых цен. |
Пример
Если ваше приложение выполняет эти два вызова за один сеанс:
Андроид
- 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 ):
- Автозаполнение без сведений о месте — за сеанс (цена от 0,017 доллара США за сеанс)
Артикул: автозаполнение (входит в состав сведений о месте) — за сеанс.
Автозаполнение (входит в состав сведений о месте) — SKU за сеанс взимается за сеанс автозаполнения , который включает в себя любое из:
- Android: вызов
fetchPlace()
- iOS: вызов
fetchPlaceFromPlaceID:
- Веб-сервис: запрос сведений о месте
Запрос на автозаполнение доступен бесплатно, а последующий вызов Place Details оплачивается по обычным ценам Place Details .
Запрос сведений о месте генерирует SKU данных ( Базовый , Контакт и/или Атмосфера ) — в зависимости от полей, указанных в запросе.
Если вы не укажете поля в запросе сведений о месте, активируются все SKU данных (Базовый, Контакт и Атмосфера).
Запросы на обновление идентификатора места (запросы, в которых указано только поле place_id
) во время сеанса автозаполнения тарифицируются как SKU: автозаполнение без сведений о месте — за сеанс .
ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за СЕАНС) | ||
---|---|---|
| | |
0,00 долларов США | 0,00 долларов США | 0,00 долларов США |
Пример
Если ваше приложение выполняет следующие три вызова за один сеанс:
Андроид
- 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 ):
- Автозаполнение (входит в состав сведений о месте) — за сеанс (оплачивается 0,00 долларов США).
- Детали места (цена от 0,017 доллара США за сеанс)
- Базовые данные (оплачивается по цене 0,00 долларов США)
Артикул: Автозаполнение запроса – по запросу
За автозаполнение запроса (SKU по запросу) взимается плата за каждый запрос на:
- JavaScript: служба автозаполнения мест API JavaScript Карт (
getQueryPredictions()
) и использование виджета SearchBox API JavaScript Карт (запросы автозаполнения запросов генерируются по мере ввода пользователем текста). - Веб-служба: служба автозаполнения запросов Places API.
ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за ЗАПРОС) | ||
---|---|---|
| | |
0,00283 доллара США за каждого (2,83 доллара США за 1000) | 0,00227 долларов США за каждого (2,27 доллара США за 1000) | Свяжитесь с отделом продаж для уточнения оптовых цен. |
Цены на основе сеанса автозаполнения не поддерживаются при использовании автозаполнения запросов. Последующие звонки Places Details оплачиваются по обычным ценам Places Details .
Артикул: Детали места
За вызовы Place Details взимается следующая плата:
ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за ЗВОНОК) | ||
---|---|---|
| | |
0,017 доллара США за каждого (17,00 долларов США за 1000) | 0,0136 доллара США за каждого (13,60 долларов США за 1000) | Свяжитесь с отделом продаж для уточнения оптовых цен. |
SKU Place Details создается на основе следующих API:
- Android: Places SDK для Android (
fetchPlace()
) - iOS: Places SDK для iOS (
fetchPlaceFromPlaceID:
) - JavaScript: служба сведений о местах Maps JavaScript API (
getDetails
). - JavaScript: виджет автозаполнения мест Maps JavaScript API (
getPlace
) - JavaScript: виджет Place SearchBox Maps JavaScript API : метод
getPlaces()
после того, как пользователь выбирает результат размещения (значок: булавка), *а не* запрос (значок: лупа), как показано здесь: - Веб-сервис: Служба Place Details API Places
При использовании веб-API и служб за номер SKU Place Details взимается плата независимо от того, предоставлен ли токен сеанса или нет.
Вызов или запрос сведений о месте также генерирует номера SKU данных ( Basic , Contact и/или AtmSphere ) в зависимости от полей, указанных в вызове или запросе. Если в вызове или запросе сведений о месте НЕ указаны поля, активируются ВСЕ SKU данных, и с вас взимается плата за вызов или запрос сведений о местах плюс стоимость всех данных.
Примеры
- Сделайте один из этих звонков или запросов:
- Мобильное устройство: вызовите
fetchPlace()
на Android илиfetchPlaceFromPlaceID:
на iOS и укажите только полеADDRESS
- Веб-API или служба: сделайте запрос сведений о месте и укажите только поле адреса:
getPlaceDetails(fields: formatted_address)
- Детали места (цена от 0,017 доллара США за сеанс)
- Базовые данные (оплачивается по цене 0,00 долларов США)
- Мобильное устройство: вызовите
- Сделайте один из этих звонков или запросов:
- Mobile: Call
fetchPlace()
на Android илиfetchPlaceFromPlaceID:
на iOS и укажите только полеPHONE_NUMBER
- Веб -API или служба: сделайте запрос на информацию о месте и укажите поле номера телефона:
getPlaceDetails(fields: formatted_phone_number)
- Разместите детали (цена, начиная с 0,017 долларов США за сеанс)
- Контактные данные (цена, начинающаяся с 0,003 доллара США за запрос)
- Mobile: Call
- Сделайте один из этих звонков или запросов:
- Mobile: Call
fetchPlace()
на Android илиfetchPlaceFromPlaceID:
на iOS и укажите все поля - Веб -API или Сервис: сделайте запрос на информацию о месте и укажите все поля (этот тип запроса является по умолчанию, если вы не указываете какие -либо поля):
getPlaceDetails()
.
- Разместите детали (цена, начиная с 0,017 долларов США за сеанс)
- Основные данные (выставлены на 0,00 доллара США)
- Контактные данные (цена, начинающаяся с 0,003 доллара США за запрос)
- Данные атмосферы (цена, начинающаяся с 0,005 доллара США за запрос)
- Mobile: Call
SKU: Разместите детали - ID обновление
Используйте запрос на детали места, чтобы обновить идентификаторы устаревших мест . Эти типы запросов доступны бесплатно.
ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за звонок) | ||
---|---|---|
| | |
0,00 долларов США | 0,00 долларов США | 0,00 долларов США |
Пример
Сделайте запрос на детали места, указав только место для идентификатора места: getPlaceDetails(fields: place_id)
. На вашем счете вы увидите этот список SKU (при просмотре вашего счета от SKU ):
- Разместите детали - ID обновление (выставлено 0,00 доллара США)
SKU: найти место
Найти место взимается за запрос на поиск места.
ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за звонок) | ||
---|---|---|
| | |
0,017 долларов США за каждый (17,00 доллара США на 1000) | 0,0136 долларов США за каждый (13,60 доллара США на 1000) | Свяжитесь с продажами по цене объема |
Найдите запросы на место также генерируют данные SKU ( базовый , контактный и/или атмосфера ), в зависимости от полей, указанных в запросе. Как и запросы с подробностями места, вы можете использовать параметр поля в своем запросе Find Place, чтобы ограничить ответ только на указанные поля. Вам выставлено счета за запрос на поиск места, а также запрошенные данные. По умолчанию, если поля не запрашиваются, возвращается только идентификатор места, поэтому никаких дополнительных расходов на данные не понесены.
Примеры
- Вы делаете запрос Find Place и указываете только поле адреса:
FindPlace(fields: formatted_address)
. На вашем счете вы увидите эти перечисленные SKU (при просмотре вашего счета от SKU ):- Найдите место (цена, начиная с 0,017 долларов США за звонок)
- Основные данные (выставлены на 0,00 доллара США)
- Вы делаете запрос Find Place и указываете поле номера телефона:
FindPlace(fields: formatted_phone_number)
. На вашем счете вы увидите эти перечисленные SKU (при просмотре вашего счета от SKU ):- Найдите место (цена, начиная с 0,017 долларов США за звонок)
- Контактные данные (цена, начинающаяся с 0,003 доллара США за запрос)
- Вы делаете запрос Find Place и указываете поля из всех трех ведер типа данных:
FindPlace(fields: formatted_address, opening_hours, price_level)
. На вашем счете вы увидите эти перечисленные SKU (при просмотре вашего счета от SKU ):- Найдите место (цена, начиная с 0,017 долларов США за звонок)
- Основные данные (выставлены на 0,00 доллара США)
- Контактные данные (цена, начинающаяся с 0,003 доллара США за запрос)
- Данные атмосферы (цена, начинающаяся с 0,005 доллара США за запрос)
SKU: найти место - только удостоверение личности
Найти место - только удостоверение личности взимается только за запросы на поиск места, которые указывают только идентификатор места, который будет возвращен. По умолчанию, если поля не указаны в запросе Find Place, возвращается только идентификатор места.
ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за звонок) | ||
---|---|---|
| | |
0,00 долларов США | 0,00 долларов США | 0,00 долларов США |
Пример
Вы делаете запрос Find Place и указываете только поле place_id
: FindPlace(fields: place_id)
. На вашем счете вы увидите этот список SKU (при просмотре вашего счета от SKU ):
- Найдите место - только удостоверение личности (выставлено 0,00 доллара США)
SKU: место - близлежащий поиск
Место - близлежащий поиск взимается за запросы на Maps JavaScript API место рядом с службой поиска ( nearbySearch()
) или в API API рядом с службой поиска
ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за звонок) | ||
---|---|---|
| | |
0,032 доллара США за каждый (32,00 доллара США на 1000) | 0,0256 доллара США за каждый (25,60 доллара США на 1000) | Свяжитесь с продажами по цене объема |
Близлежащие запросы на поиск возвращают список мест, но не поддерживают указание, какие поля возвращаются. Близлежащие запросы на поиск возвращают подмножество поддерживаемых полей данных . У вас взимается плата за близлежащий запрос на поиск, начиная с 0,032 доллара США за каждый, а также для всех SKU типа данных ( основные данные , контактные данные и данные атмосферы ).
Пример
Вы делаете ближайший запрос на поиск, такой как NearbySearch (San Francisco, 100 meters)
. На вашем счете вы увидите эти перечисленные SKU (при просмотре вашего счета от SKU ):
- Место - близлежащий поиск (цена, начиная с 0,032 доллара США за звонок)
- Основные данные (выставлены на 0,00 доллара США)
- Контактные данные (цена, начинающаяся с 0,003 доллара США за запрос)
- Данные атмосферы (цена, начинающаяся с 0,005 доллара США за запрос)
SKU: место - Поиск текста
Место - Поиск текста взимается за запросы на Maps JavaScript API Service Service ( textSearch()
) или в службу поиска текстового поиска API .
ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за звонок) | ||
---|---|---|
| | |
0,032 доллара США за каждый (32,00 доллара США на 1000) | 0,0256 доллара США за каждый (25,60 доллара США на 1000) | Свяжитесь с продажами по цене объема |
Запросы на текстовый поиск возвращают список мест, но не поддерживают указание, какие поля возвращаются. Запросы на текстовый поиск возвращает подмножество поддерживаемых полей данных . У вас взимается плата за запрос на поиск текстового поиска, начиная с 0,032 доллара США за каждый, а также все SKU типа данных ( основные данные , контактные данные и данные атмосферы ).
Место - Text Search SKU также генерируется методом Maps JavaScript API Videbox Widget : getPlaces()
после того, как пользователь выбирает запрос «Место» (значок: увеличение), а не результат (значок: PIN -код), как показано здесь:
Пример
Вы делаете запрос на текстовый поиск, такой как TextSearch(123 Main Street)
. На вашем счете вы увидите эти перечисленные SKU (при просмотре вашего счета от SKU ):
- Место - Поиск текста (цена, начиная с 0,032 доллара США за звонок)
- Основные данные (выставлены на 0,00 доллара США)
- Контактные данные (цена, начинающаяся с 0,003 доллара США за запрос)
- Данные атмосферы (цена, начинающаяся с 0,005 доллара США за запрос)
SKU: разместить фото
Место фото SKU заряжено:
- Android: вызовы на
fetchPhoto()
- iOS: звонки в
loadPlacePhoto:
- JavaScript: чтобы поместить библиотеку, карты JavaScript API Photo Photos Service при запросе данных
PlacePhoto.getUrl()
URL - Веб -сервис: запросы на места API Place Service Service
Для службы JavaScript, вызывая метод PlacePhoto.getUrl()
не вызывает выставления счетов до тех пор, пока URL фактически не будет использован для получения данных пикселей.
ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за звонок) | ||
---|---|---|
| | |
0,007 доллара США за каждый (7,00 доллара США за 1000) | 0,0056 долл. США за каждый (5,60 доллара США на 1000) | Свяжитесь с продажами по цене объема |
Другие ограничения использования
Хотя максимального количества запросов в день не существует, следующие пределы использования все еще применяются:
Размещает API (новый) : предел ставки составляет 600 QPM (запросы в минуту) на метод API по проекту. Это означает, что каждый метод API имеет отдельную квоту.
МАЛАКИ API : Предел ставки составляет 6000 QPM (запросы в минуту). Он рассчитывается как сумма запросов на стороне клиента и на стороне сервера для всех приложений, использующих учетные данные того же проекта.
Условия ограничений использования
Для получения информации об Условиях использования см. Политики для API Place и раздел ограничений лицензий в Условиях обслуживания платформы Google Maps.
Управляйте своей стоимостью использования
Чтобы управлять вашей стоимостью использования API мест или для удовлетворения требований вашего производственного трафика, установите ежедневные ограничения квот на все запросы на любой API. Ежедневные квоты сбрасываются в полночь Тихоокеанское время.
Чтобы просмотреть или изменить пределы квот для API Place:
- В облачной консоли откройте страницу квот платформы Google Maps .
- Нажмите на раскрывающую очередь APIS и выберите API Places .
- Чтобы просмотреть пределы квоты, прокрутите вниз до карты запросов .
В таблице перечислены имена квот и ограничения. - Чтобы изменить предел квоты, щелкните значок «Редактировать этот предел».
В диалоговом окне, который появляется в поле ограничения квоты , введите предпочтительный счет в ежедневной квоте (до предела квоты, если таковые имеются, указано Google) и выберите «Сохранить» .
Если ваше использование API достигнет вашего оплачиваемого предела квоты в любой день, ваше заявление не сможет получить доступ к API на оставшуюся часть этого дня.