В этом разделе описываются коды для основных продуктов платформы Google Карт: Maps, Routes и Places. Все эти продукты оплачиваются по мере использования и только по тем кодам, которые вы фактически используете.
По каждому из указанных здесь кодов приводится следующая информация:
- название кода, которое отображается в отчете по платежам;
- подробные сведения о типах использования, которые относятся к этому коду;
- стоимость использования для каждого из трех уровней, основанных на объемах использования;
- примечания, касающиеся цены.
Вы можете посмотреть коды отдельных продуктов в этой статье или воспользоваться калькулятором оплаты и использования, чтобы рассчитать стоимость использования для каждого API.
Продукты и коды
Коды продуктов Maps
В Maps входят следующие API: Maps SDK для Android, Maps SDK для iOS, Maps JavaScript API, Maps Static API, Street View Static API и Maps Embed API.
Код: Mobile Native Static Maps
Применяется в мобильных приложениях, использующих Maps SDK для Android, и позволяет добавить в упрощенном режиме объект карты Google, который не был загружен с помощью идентификатора карты.
МЕСЯЧНЫЙ ОБЪЕМ (цена за ЗАГРУЗКУ ОДНОЙ КАРТЫ) |
||
---|---|---|
0 долл. США | 0 долл. США | 0 долл. США |
Плата за одну загрузку карты начисляется за каждое создание экземпляра карты Google в упрощенном режиме в мобильном приложении, использующем Maps SDK для Android. Карты создаются через экземпляры классов MapFragment
, SupportMapFragment
и MapView
. Каждый вызов соответствующего метода onCreate()
учитывается как одна загрузка карты.
Mobile Native Dynamic Maps
Объект карты Google, не загруженный с помощью идентификатора карты, в мобильном приложении с использованием Maps SDK для Android или Maps SDK для iOS.
МЕСЯЧНЫЙ ОБЪЕМ (цена за ЗАГРУЗКУ ОДНОЙ КАРТЫ) |
||
---|---|---|
0 долл. США | 0 долл. США | 0 долл. США |
Плата за одну загрузку карты взимается за каждое создание экземпляра объекта карты Google в мобильном приложении с Maps SDK для Android или Maps SDK для iOS:
- В Android – класс
MapFragment
,SupportMapFragment
илиMapView
. Каждый вызов соответствующего методаonCreate()
учитывается как одна загрузка карты. - В iOS – объект
GMSMapView
.
Взаимодействие пользователя с картой (панорамирование, масштабирование, переключение между слоями) не считается загрузкой карты. При оплате по мере использования создание панорамы в Просмотре улиц больше не оплачивается как загрузка карты Mobile Native. К нему применяется ценообразование Dynamic Street View.
Коды: Embed и Embed Advanced
Все запросы к Maps Embed API обрабатываются бесплатно и без ограничений.
Код: Static Maps
Запрос к Maps Static API.
МЕСЯЧНЫЙ ОБЪЕМ (цена за ЗАГРУЗКУ ОДНОЙ КАРТЫ) |
||
---|---|---|
0,002 долл. США за ед. (2 долл. США за 1000) |
0,016 долл. США за ед. (1,60 долл. США за 1000) |
Цены для особо крупных объемов уточняйте в отделе продаж. |
Код: Dynamic Maps
Приложение, в котором показывается карта, загруженная с помощью идентификатора карты или без него, с использованием Maps JavaScript API или карта, загруженная с помощью идентификатора карты, которая использует Maps SDK для Android или Maps SDK для iOS.
МЕСЯЧНЫЙ ОБЪЕМ (цена за ЗАГРУЗКУ ОДНОЙ КАРТЫ) |
||
---|---|---|
0,007 долл. США за ед. (7 долл. США за 1000) |
0,0056 долл. США за ед. (5,60 долл. США за 1000) |
Цены для особо крупных объемов уточняйте в отделе продаж. |
Взаимодействие пользователя с картой (панорамирование, масштабирование, переключение между слоями) не считается загрузкой карты.
Код: Static Street View
Теперь панорамы в Просмотре улиц оплачиваются отдельно от загрузки карт. Статическая (не интерактивная) панорама в Просмотре улиц оплачивается за каждый запрос к Street View Static API на встраивание статической панорамы. За использование конечной точки метаданных изображения Просмотра улиц плата не начисляется.
МЕСЯЧНЫЙ ОБЪЕМ (цена за ОДНУ ПАНОРАМУ) |
||
---|---|---|
0,007 долл. США за ед. (7 долл. США за 1000) |
0,0056 долл. США за ед. (5,60 долл. США за 1000) |
Цены для особо крупных объемов уточняйте в отделе продаж. |
Код: Dynamic Street View
Теперь панорамы в Просмотре улиц оплачиваются отдельно от загрузки карт. Динамическая панорама в Просмотре улиц оплачивается за каждый экземпляр объекта панорамы в приложении с Maps JavaScript API, Maps SDK для Android или Maps SDK для iOS.
МЕСЯЧНЫЙ ОБЪЕМ (цена за ОДНУ ПАНОРАМУ) |
||
---|---|---|
0,014 долл. США за ед. (14 долл. США за 1000) |
0,0112 долл. США за ед. (11,20 долл. США за 1000) |
Цены для особо крупных объемов уточняйте в отделе продаж. |
Экземпляр объекта панорамы создается:
- В JavaScript – с помощью класса
google.maps.StreetViewPanorama()
или методаMap.getStreetView()
. За использование встроенной реализации Просмотра улиц (со стандартными элементами управления, такими как значок человечка) и классаStreetViewService()
не взимается плата. - В Android – с помощью класса
StreetViewPanoramaFragment
,SupportStreetViewPanoramaFragment
илиStreetViewPanoramaView
. Создание панорамы учитывается при каждом вызове соответствующего методаonCreate()
. - В iOS – с помощью объекта
GMSPanoramaView
.
Коды продуктов Routes
В Routes входят следующие API: Directions API, Distance Matrix API, Roads API.
Код: Directions
Запрос к сервису Directions в Maps JavaScript API (за исключением запросов, за которые взимается плата по коду Directions Advanced) или к Directions API.
МЕСЯЧНЫЙ ОБЪЕМ (цена за ОДИН ЗАПРОС) |
||
---|---|---|
0,005 долл. США за ед. (5 долл. США за 1000) |
0,004 долл. США за ед. (4 долл. США за 1000) |
Цены для особо крупных объемов уточняйте в отделе продаж. |
Код: Directions Advanced
Запрос к сервису Directions в Maps JavaScript API или к Directions API, в котором используется информация о загруженности дорог, больше 10 путевых точек, оптимизация путевых точек и/или модификаторы местоположения.
МЕСЯЧНЫЙ ОБЪЕМ (цена за ОДИН ЗАПРОС) |
||
---|---|---|
0,01 долл. США за ед. (10 долл. США за 1000) |
0,008 долл. США за ед. (8 долл. США за 1000) |
Цены для особо крупных объемов уточняйте в отделе продаж. |
Оплата по коду Directions Advanced начисляется за каждый запрос к сервису Directions в Maps JavaScript API или Directions API, в котором используется один или несколько из следующих элементов:
- Информация о загруженности дорог. Она используется, если соблюдаются перечисленные ниже условия (именно они позволяют получить поле
duration_in_traffic
в ответе от Directions).- Параметр
mode
для способа передвижения имеет значениеdriving
или не указан (driving
является значением по умолчанию). - Запрос содержит допустимое значение параметра
departure_time
. Дляdeparture_time
можно задать текущее время или произвольное время в будущем. Время в прошлом указать нельзя. - Запрос не содержит промежуточных путевых точек для остановок. Если запрос содержит путевые точки, добавьте к каждой из них префикс
via:
, чтобы построить по ним маршрут без остановок. Пример:&waypoints=via:San Francisco|via:Mountain View|...
- Параметр
- Более 10 путевых точек (от 11 до 25).
- Оптимизация путевых точек. Параметр
optimize
для путевых точек имеет значениеtrue
. Пример:&waypoints=optimize:true|San Francisco|Mountain View|...
- Модификаторы местоположения. При использовании указанных ниже модификаторов местоположения для обозначения того, как проехать к определенному месту.
side_of_road
heading
Код: Distance Matrix
Запрос к Distance Matrix API или сервису Distance Matrix в Maps JavaScript API (за исключением запросов, за которые взимается плата по коду Distance Matrix Advanced).
МЕСЯЧНЫЙ ОБЪЕМ (цена за ОДИН ЭЛЕМЕНТ) |
||
---|---|---|
0,005 долл. США за ед. (5 долл. США за 1000) |
0,004 долл. США за ед. (4 долл. США за 1000) |
Цены для особо крупных объемов уточняйте в отделе продаж. |
Каждый запрос, отправляемый в Distance Matrix API, создает некоторое количество элементов, которое определяется произведением значений origins
и destinations
.
Код: Distance Matrix Advanced
Запрос к Distance Matrix API или сервису Distance Matrix в Maps JavaScript API, в котором используется информация о загруженности дорог и/или модификаторы местоположения.
МЕСЯЧНЫЙ ОБЪЕМ (цена за ОДИН ЭЛЕМЕНТ) |
||
---|---|---|
0,01 долл. США за ед. (10 долл. США за 1000) |
0,008 долл. США за ед. (8 долл. США за 1000) |
Цены для особо крупных объемов уточняйте в отделе продаж. |
Каждый запрос, отправляемый в Distance Matrix API, создает некоторое количество элементов, которое определяется произведением значений origins
и destinations
.
Оплата по коду Distance Matrix Advanced начисляется за каждый запрос к Distance Matrix API или сервису Distance Matrix в Maps JavaScript API, в котором используется следующая информация:
- Информация о загруженности дорог. Она используется, если соблюдаются перечисленные ниже условия (именно они позволяют получить поле
duration_in_traffic
в ответе от Distance Matrix).- Параметр
mode
для способа передвижения имеет значениеdriving
или не указан (driving
является значением по умолчанию). - Запрос содержит допустимое значение параметра
departure_time
. Дляdeparture_time
можно задать текущее время или произвольное время в будущем. Время в прошлом указать нельзя.
- Параметр
- Модификаторы местоположения. При использовании указанных ниже модификаторов местоположения для обозначения того, как проехать к определенному месту.
side_of_road
heading
Код: Roads – Route Traveled
Запрос к сервису Snap to Roads в Roads API.
МЕСЯЧНЫЙ ОБЪЕМ (цена за ОДИН ЗАПРОС) |
||
---|---|---|
0,01 долл. США за ед. (10 долл. США за 1000) |
0,008 долл. США за ед. (8 долл. США за 1000) |
Цены для особо крупных объемов уточняйте в отделе продаж. |
Код: Roads – Nearest Road
Запрос к сервису Nearest Roads в Roads API.
МЕСЯЧНЫЙ ОБЪЕМ (цена за ОДИН ЗАПРОС) |
||
---|---|---|
0,01 долл. США за ед. (10 долл. США за 1000) |
0,008 долл. США за ед. (8 долл. США за 1000) |
Цены для особо крупных объемов уточняйте в отделе продаж. |
Код: Roads – Speed Limits
Запрос к сервису Speed Limits в Roads API.МЕСЯЧНЫЙ ОБЪЕМ (цена за ОДИН ЭЛЕМЕНТ) |
||
---|---|---|
0,02 долл. США за ед. (20 долл. США за 1000) |
0,016 долл. США за ед. (16 долл. США за 1000) |
Цены для особо крупных объемов уточняйте в отделе продаж. |
Запросы Speed Limit оплачиваются по количеству элементов ограничения скорости, возвращаемых в ответе API. Это количество всегда будет равно количеству точек, переданных в исходном запросе, или меньше него.
Коды продуктов Places
В Places входят следующие API: Places API, Places SDK для Android, Places SDK для iOS, библиотека Places, Maps JavaScript API, Geocoding API, Geolocation API, Time Zone API и Elevation API.
О сеансах Autocomplete
Сеанс Autocomplete включает несколько запросов Autocomplete (для получения подсказок места по мере ввода данных пользователем) и не более одного запроса Places Details (для получения сведений о выбранном пользователем месте). В эти запросы Autocomplete и Places Details передается один и тот же токен сеанса. Сеанс начинается с первого запроса Autocomplete (обычно при начале ввода данных пользователем). Вызов Places Details происходит, когда пользователь выбирает одну из подсказок, полученных от Autocomplete. Если пользователь не выбирает подсказку, вызов Places Details не выполняется.
После того как пользователь выберет место (то есть после вызова Places Details), необходимо начать новый сеанс с новым токеном сеанса.
Сеансы Autocomplete могут создаваться из следующих API:
- Сервис Place Autocomplete в Places API или сервис Places Autocomplete в Maps JavaScript API. Для их использования ваше приложение должно создавать токены сеансов (возможно, вам понадобится изменить его код).
- Виджет Autocomplete в Maps JavaScript API. Для таких виджетов оплата на основе сеансов включается автоматически и не требует изменений в коде.
Токен сеанса действует только в течение одного сеанса и не может использоваться для нескольких сеансов пользователя. Если вы используете токен сеанса повторно, такой сеанс будет считаться недействительным и оплата за запросы в нем будет взиматься так, как если бы токен сеанса не был предоставлен.
Оплата за сеансы с запросами Autocomplete и Places Details начисляется по разным кодам.
О кодах Places Data
Существует три типа кодов Places Data: Basic Data, Contact Data и Atmosphere Data.Оплата по одному или нескольким кодам Data начисляется:
- на устройствах Android – за каждый запрос
fetchPlace()
иfindCurrentPlace()
; - на устройствах iOS – за каждый вызов
fetchPlaceFromPlaceID:
иfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
; - в веб-сервисах – для каждого запроса Places в зависимости от того, какие поля указаны в этом запросе.
Коды Data всегда оплачиваются в дополнение к основным кодам с учетом запроса, по которому они сработали. Например, запрос Place Details с полями Basic Data будет оплачиваться и как код Basic Data SKU, и как код Place Details.
Следующие вызовы Places API для веб-сервисов поддерживают указание возвращаемых полей данных:
Приведенные ниже вызовы Places API для веб-сервисов НЕ ПОДДЕРЖИВАЮТ указание возвращаемых полей данных. Эти вызовы всегда возвращают полные данные Places, что приводит к начислению платы по трем кодам Places Data в дополнение к плате за запрос к API.
Код: Basic Data
С помощью параметра fields в запросе Place Details или Find Place вы можете указать, какие поля должны быть включены в ответ. Поля из категории Basic включаются в базовую стоимость запроса Places. Их использование не приводит к начислению дополнительной оплаты. Код Basic Data применяется при запросе любого из следующих полей:
-
на устройстве 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
; -
на устройстве iOS –
GMSPlaceFieldFormattedAddress
,GMSPlaceFieldBusinesssStatus
,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
.
МЕСЯЧНЫЙ ОБЪЕМ (цена за ОДИН ВЫЗОВ) |
||
---|---|---|
Цена запроса Places + 0,00 долл. США |
Цена запроса Places + 0,00 долл. США |
Цена запроса Places + 0,00 долл. США |
Код: Contact Data
С помощью параметра fields в запросе Place Details или Find Place для веб-сервиса, а также массива Place.Field
для Android или iOS, вы можете указать, какие поля должны быть включены в ответ. Использование полей из категории Contact оплачивается дополнительно. Код Contact Data применяется при запросе любого из следующих полей:
- на устройстве Android –
Place.Field.OPENING_HOURS
,Place.Field.PHONE_NUMBER
иPlace.Field.WEBSITE_URI
; - на устройстве iOS –
GMSPlaceFieldOpeningHours
,GMSPlaceFieldPhoneNumber
иGMSPlaceFieldWebsite
; - в веб-сервисе –
formatted_phone_number
,international_phone_number
,opening_hours
,current_opening_hours
,secondary_opening_hours
иwebsite
.
МЕСЯЧНЫЙ ОБЪЕМ (цена за ОДИН ВЫЗОВ) |
||
---|---|---|
Цена запроса Places + 0,003 долл. США за ед. (+ 3,00 долл. США за 1000) |
Цена запроса Places + 0,0024 долл. США за ед. (+ 2,40 долл. США за 1000) |
Цены для особо крупных объемов уточняйте в отделе продаж. |
Код: Atmosphere Data
С помощью параметра полей в запросе Place Details или Find Place вы можете указать, какие поля должны быть включены в ответ. Использование полей из категории Atmosphere оплачивается дополнительно. Код Atmosphere Data применяется при запросе любого из следующих полей:
- на устройстве Android –
Place.Field.CURBSIDE_PICKUP
,Place.Field.DELIVERY
,Place.Field.DINE_IN
,Place.Field.PRICE_LEVEL
,Place.Field.RATING
,Place.Field.TAKEOUT
иPlace.Field.USER_RATINGS_TOTAL
; - на устройстве iOS –
GMSPlaceFieldPriceLevel
,GMSPlaceFieldRating
,GMSPlaceFieldUserRatingsTotal
,GMSPlaceFieldTakeout
,GMSPlaceFieldDelivery
,GMSPlaceFieldDineIn
,GMSPlaceFieldCurbsidePickup
,GMSPlaceFieldReservable
,GMSPlaceFieldServesBreakfast
,GMSPlaceFieldServesLunch
,GMSPlaceFieldServesDinner
,GMSPlaceFieldServesBeer
,GMSPlaceFieldServesWine
,GMSPlaceFieldServesBrunch
иGMSPlaceFieldServesVegetarianFood
; - в JavaScript – Fields (описание места);
- в веб-сервисе –
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
.
МЕСЯЧНЫЙ ОБЪЕМ (цена за ОДИН ВЫЗОВ) |
||
---|---|---|
Цена запроса Places + 0,005 долл. США за ед. (+ 5,00 долл. США за 1000) |
Цена запроса Places + 0,004 долл. США за ед. (+ 4,00 долл. США за 1000) |
Цены для особо крупных объемов уточняйте в отделе продаж. |
Код: Autocomplete – Per Request
Оплата по коду Autocomplete – Per Request начисляется за следующие вызовы и запросы, которые не включают токен сеанса:
- Android –
findAutocompletePredictions()
; - iOS –
findAutocompletePredictionsFromQuery:
; - JavaScript – сервис Place Autocomplete в Maps JavaScript API;
- веб-сервис – сервис Place Autocomplete в Places API.
Все вызовы из недопустимого сеанса Autocomplete (например, с уже использованным ранее токеном сеанса) также оплачиваются по коду Autocomplete – Per Request.
Запросы Autocomplete из виджета Place Autocomplete в Maps JavaScript API могут оплачиваться по коду Autocomplete – Per Request, если вызовы выполнены из недопустимого сеанса Autocomplete. Это может происходить в тех случаях, когда пользователь в виджете вводит или вставляет несколько разных адресов, не каждый раз выбирая подсказку автозаполнения.
МЕСЯЧНЫЙ ОБЪЕМ (цена за ОДИН ЗАПРОС) |
||
---|---|---|
0,00283 долл. США за ед. (2,83 долл. США за 1000) |
0,00227 долл. США за ед. (2,27 долл. США за 1000) |
Цены для особо крупных объемов уточняйте в отделе продаж. |
Код: Autocomplete without Place Details – Per Session
Оплата по коду Autocomplete without Place Details – Per Session начисляется за каждый сеанс Autocomplete, который не содержит запроса Place Details (в течение нескольких минут после начала сеанса).
МЕСЯЧНЫЙ ОБЪЕМ (цена за ОДИН СЕАНС) |
||
---|---|---|
0,017 долл. США за ед. (17 долл. США за 1000) |
0,0136 долл. США за ед. (13,60 долл. США за 1000) |
Цены для особо крупных объемов уточняйте в отделе продаж. |
Пример
Предположим, приложение выполняет следующие два вызова за один сеанс:
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
Веб-сервис
- Запрос Place Autocomplete (input="par", session_token: XYZ)
- Запрос Place Autocomplete (input="paris", session_token: XYZ)
В счете вы увидите следующий список кодов (при просмотре счета по кодам):
- Autocomplete without Place Details – Per Session (цена от 0,017 долл. США за сеанс).
Код: Autocomplete (included with Place Details) – Per Session
Оплата по коду Autocomplete (included with Place Details) – Per Session начисляется за каждый сеанс Autocomplete, содержащий:
- на устройствах Android – вызов
fetchPlace()
; - на устройствах iOS – вызов
fetchPlaceFromPlaceID:
; - в веб-сервисах – запрос Place Details.
Запрос на автозаполнение (Autocomplete) выполняется бесплатно, а последующие вызовы Place Details оплачиваются по обычным тарифам для кода Place Details.
Для запроса Place Details оплата начисляется по кодам Data (Basic, Contact и/или Atmosphere) в зависимости от того, какие поля указаны в этом запросе.
Если вы не указываете поля для запроса Place Details, оплата начисляется по всем кодам Data (Basic, Contact и Atmosphere).
Запросы на обновление идентификатора Place Details (в которых указано только поле place_id
) во время сеанса Autocomplete оплачиваются по коду Autocomplete without Place Details – Per Session.
МЕСЯЧНЫЙ ОБЪЕМ (цена за ОДИН СЕАНС) |
||
---|---|---|
0 долл. США | 0 долл. США | 0 долл. США |
Пример
Предположим, приложение выполняет следующие три вызова за один сеанс:
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
- fetchPlace() (где
FetchPlaceRequest
содержит Place ID и поле ADDRESS)
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
- fetchPlaceFromPlaceID:
(включая Place ID и поле
GMSPlaceFieldFormattedAddress
)
Веб-сервис
- запрос Places Autocomplete (input="par", session_token: XYZ)
- запрос Places Autocomplete (input="paris", session_token: XYZ)
- Places Details (place_id, session_token: XYZ, fields:formatted_address)
В счете вы увидите следующий список кодов (при просмотре счета по кодам):
- Autocomplete (included with Place Details) – Per Session (оплата 0,00 долл. США);
- Place Details (цена от 0,017 долл. США за сеанс);
- Basic Data (оплата 0,00 долл. США).
Код: Query Autocomplete – Per Request
При использовании кода Query Autocomplete – Per Request оплачивается:
- для JavaScript – каждый запрос к сервису Places Autocomplete в Maps JavaScript API (
getQueryPredictions()
) и использование виджета SearchBox в Maps JavaScript API (запросы Query Autocomplete создаются при вводе данных пользователем); - в веб-сервисах – каждый запрос к сервису Query Autocomplete в Places API.
МЕСЯЧНЫЙ ОБЪЕМ (цена за ОДИН ЗАПРОС) |
||
---|---|---|
0,00283 долл. США за ед. (2,83 долл. США за 1000) |
0,00227 долл. США за ед. (2,27 долл. США за 1000) |
Цены для особо крупных объемов уточняйте в отделе продаж. |
При использовании запросов Query Autocomplete оплата по сеансам Autocomplete не поддерживается. Последующие вызовы Places Details оплачиваются по обычным тарифам для кода Places Details.
Код: Place Details
За вызовы Place Details оплата взимается следующим образом:
МЕСЯЧНЫЙ ОБЪЕМ (цена за ОДИН ВЫЗОВ) |
||
---|---|---|
0,017 долл. США за ед. (17 долл. США за 1000) |
0,0136 долл. США за ед. (13,60 долл. США за 1000) |
Цены для особо крупных объемов уточняйте в отделе продаж. |
Плата по коду Place Details начисляется при использовании следующих API:
- Android – Places SDK для Android
(
fetchPlace()
). - iOS – Places SDK для iOS
(
fetchPlaceFromPlaceID:
). - JavaScript –
сервис Place Details в Maps JavaScript API (
getDetails
). - JavaScript –
виджет Place Autocomplete в Maps JavaScript API (
getPlace
). - JavaScript – виджет Place SearchBox в Maps JavaScript API: метод
getPlaces()
, если пользователь выбирает подсказку места (значок: "маркер"), а *не* поисковый запрос (значок: "лупа"), как показано ниже.В результатах виджета окна поиска для запроса "pizza" рядом с Pizza Autentico показан значок маркера, который означает, что это подсказка места, а не поисковый запрос. - Веб-сервис – сервис Place Details в Places API.
В случае с веб-сервисами и API оплата по коду Place Details начисляется независимо от того, был ли предоставлен токен сеанса.
Для вызова или запроса Place Details также начисляется оплата по кодам Data (Basic, Contact и/или Atmosphere) в зависимости от того, какие поля в нем указаны. Если вы НЕ указываете поля в запросе Place Details, оплата начисляется по ВСЕМ кодам Data, то есть вы оплачиваете сам запрос Places Details и стоимость всех данных.
Примеры
- Выполните один из следующих вызовов или запросов:
- Мобильное устройство – вызовите
fetchPlace()
на Android илиfetchPlaceFromPlaceID:
на iOS. Достаточно указать только полеADDRESS
. - Веб-сервис или API – создайте запрос Place Details и укажите только поле адреса
getPlaceDetails(fields: formatted_address)
.
- Place Details (цена от 0,017 долл. США за сеанс);
- Basic Data (оплата 0,00 долл. США).
- Мобильное устройство – вызовите
- Выполните один из следующих вызовов или запросов:
- Мобильное устройство – вызовите
fetchPlace()
на Android илиfetchPlaceFromPlaceID:
на iOS. Достаточно указать только полеPHONE_NUMBER
. - Веб-сервис или API – создайте запрос Place Details и укажите только поле номера телефона
getPlaceDetails(fields: formatted_phone_number)
.
- Place Details (цена от 0,017 долл. США за сеанс);
- Contact Data (цена от 0,003 долл. США за запрос).
- Мобильное устройство – вызовите
- Выполните один из следующих вызовов или запросов:
- Мобильное устройство – вызовите
fetchPlace()
на Android илиfetchPlaceFromPlaceID:
на iOS. Укажите все поля. - Веб-сервис или API – создайте запрос Place Details и укажите все поля (этот же запрос используется по умолчанию, если поля не указаны):
getPlaceDetails()
.
- Place Details (цена от 0,017 долл. США за сеанс);
- Basic Data (оплата 0,00 долл. США);
- Contact Data (цена от 0,003 долл. США за запрос);
- Atmosphere Data (цена от 0,005 долл. США за запрос).
- Мобильное устройство – вызовите
Код: Place Details – ID Refresh
Запрос Place Details можно использовать для обновления неактивных идентификаторов мест. Такие типы запросов выполняются бесплатно.
МЕСЯЧНЫЙ ОБЪЕМ (цена за ОДИН ВЫЗОВ) |
||
---|---|---|
0 долл. США | 0 долл. США | 0 долл. США |
Пример
Вы создаете запрос Place Details, указывая только поле с идентификатором места: getPlaceDetails(fields: place_id)
.
В счете вы увидите следующий список кодов (при просмотре счета по кодам):
- Place Details – ID Refresh (оплата 0,00 долл. США).
Код: Find Place
Find Place оплачивается за запрос Find Place.
МЕСЯЧНЫЙ ОБЪЕМ (цена за ОДИН ВЫЗОВ) |
||
---|---|---|
0,017 долл. США за ед. (17 долл. США за 1000) |
0,0136 долл. США за ед. (13,60 долл. США за 1000) |
Цены для особо крупных объемов уточняйте в отделе продаж. |
Для запросов Find Place также начисляется оплата по кодам Data (Basic, Contact и/или Atmosphere) в зависимости от того, какие поля указаны в запросе. Как и для запросов Place Details, в запросе Find Place вы можете с помощью параметра fields указать, какие поля должны быть включены в ответ. Вы оплачиваете сам запрос Find Place и все полученные данные. По умолчанию, если в запросе не указаны поля, возвращается только идентификатор места, а значит дополнительная оплата за данные не взимается.
Примеры
- Вы создаете запрос Find Place и указываете только поле адреса:
FindPlace(fields: formatted_address)
. В счете вы увидите следующий список кодов (при просмотре счета по кодам):- Find Place (цена от 0,017 долл. США за вызов);
- Basic Data (оплата 0,00 долл. США).
- Вы создаете запрос Find Place и указываете поле номера телефона:
FindPlace(fields: formatted_phone_number)
. В счете вы увидите следующий список кодов (при просмотре счета по кодам):- Find Place (цена от 0,017 долл. США за вызов);
- Contact Data (цена от 0,003 долл. США за запрос).
- Вы создаете запрос Find Place и указываете поля из всех трех категорий данных:
FindPlace(fields: formatted_address, opening_hours, price_level)
. В счете вы увидите следующий список кодов (при просмотре счета по кодам):- Find Place (цена от 0,017 долл. США за вызов);
- Basic Data (оплата 0,00 долл. США);
- Contact Data (цена от 0,003 долл. США за запрос);
- Atmosphere Data (цена от 0,005 долл. США за запрос).
Код: Find Place – ID only
Код Find Place – ID only применяется к запросам Find Place, в которых запрашивается только идентификатор места. По умолчанию, если в запросе Find Place не указаны поля, возвращается только идентификатор места.
МЕСЯЧНЫЙ ОБЪЕМ (цена за ОДИН ВЫЗОВ) |
||
---|---|---|
0 долл. США | 0 долл. США | 0 долл. США |
Пример
Вы создаете запрос Find Place и указываете только поле place_id
: FindPlace(fields: place_id)
.
В счете вы увидите следующий список кодов (при просмотре счета по кодам):
- Find Place – ID only (оплата 0,00 долл. США).
Код: Find Current Place
Код Find Current Place применяется к вызовам findCurrentPlace()
(Android) или findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS).
МЕСЯЧНЫЙ ОБЪЕМ (цена за ОДИН ВЫЗОВ) |
||
---|---|---|
0,03 долл. США за ед. (30 долл. США за 1000) |
0,024 долл. США за ед. (24 долл. США за 1000) |
Цены для особо крупных объемов уточняйте в отделе продаж. |
Для вызовов findCurrentPlace()
(Android) и findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) также начисляется оплата по кодам Data (Basic, Contact и/или Atmosphere) в зависимости от того, какие поля указаны в вызове.
Вы можете указать определенные поля данных, чтобы в ответе получить только их. Вы оплачиваете сам вызов Find Current Place и все полученные данные.
Примеры
- Вы вызываете
findCurrentPlace()
(Android) илиfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) и указываете только полеADDRESS
. В счете вы увидите следующий список кодов (при просмотре счета по кодам):- Find Current Place (цена от 0,03 долл. США за запрос);
- Basic Data (оплата 0,00 долл. США).
- Вы вызываете
findCurrentPlace()
(Android) илиfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) и указываете полеPHONE_NUMBER
. В счете вы увидите следующий список кодов (при просмотре счета по кодам):- Find Current Place (цена от 0,03 долл. США за запрос);
- Contact Data (цена от 0,003 долл. США за запрос);
- Вы вызываете
findCurrentPlace()
(Android) илиfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) и указываете поля из всех трех категорий данных. В счете вы увидите следующий список кодов (при просмотре счета по кодам):- Find Current Place (цена от 0,03 долл. США за запрос);
- Basic Data (оплата 0,00 долл. США);
- Contact Data (цена от 0,003 долл. США за запрос);
- Atmosphere Data (цена от 0,005 долл. США за запрос).
Код: Place – Nearby Search
Оплата по коду Place – Nearby Search начисляется за запросы к сервису Place Nearby Search в Maps JavaScript API (nearbySearch()
) или к сервису Nearby Search в Places API.
МЕСЯЧНЫЙ ОБЪЕМ (цена за ОДИН ВЫЗОВ) |
||
---|---|---|
0,032 долл. США за ед. (32 долл. США за 1000) |
0,0256 долл. США за ед. (25,60 долл. США за 1000) |
Цены для особо крупных объемов уточняйте в отделе продаж. |
Запросы Nearby Search возвращают список мест, но не поддерживают указание конкретных полей, которые должны возвращаться в результатах. Запросы Nearby Search возвращают подмножество поддерживаемых полей данных. Вы оплачиваете каждый запрос Nearby Search по цене от 0,032 долл. США за запрос, а также все коды Data (Basic Data, Contact Data и Atmosphere Data).
Пример
Вы создаете запрос Nearby Search, например NearbySearch (San Francisco, 100 meters)
.
В счете вы увидите следующий список кодов (при просмотре счета по кодам):
- Place – Nearby Search (цена от 0,032 долл. США за вызов);
- Basic Data (оплата 0,00 долл. США);
- Contact Data (цена от 0,003 долл. США за запрос);
- Atmosphere Data (цена от 0,005 долл. США за запрос).
Код: Place – Text Search
Оплата по коду Place – Text Search начисляется за запросы к сервису Place Text Search в Maps JavaScript API (textSearch()
) или к сервису Text Search в Places API.
МЕСЯЧНЫЙ ОБЪЕМ (цена за ОДИН ВЫЗОВ) |
||
---|---|---|
0,032 долл. США за ед. (32 долл. США за 1000) |
0,0256 долл. США за ед. (25,60 долл. США за 1000) |
Цены для особо крупных объемов уточняйте в отделе продаж. |
Запросы Text Search возвращают список мест, но не поддерживают указание конкретных полей, которые должны возвращаться в результатах. Запросы Text Search возвращают подмножество поддерживаемых полей данных. Вы оплачиваете каждый запрос Text Search по цене от 0,032 долл. США за запрос, а также все коды Data (Basic Data, Contact Data и Atmosphere Data).
Код Place – Text Search также применяется для виджета Place SearchBox в Maps JavaScript API: метод getPlaces()
, если пользователь выбирает поисковой запрос места (значок "лупа"), а не подсказку (значок "маркер"), как показано ниже.

Пример
Вы создаете запрос Text Search, например TextSearch(123 Main Street)
. В счете вы увидите следующий список кодов (при просмотре счета по кодам):
- Place – Text Search (цена от 0,032 долл. США за вызов);
- Basic Data (оплата 0,00 долл. США);
- Contact Data (цена от 0,003 долл. США за запрос);
- Atmosphere Data (цена от 0,005 долл. США за запрос).
Код: Place Photo
Оплата по коду Place Photo начисляется в следующих случаях:
- Android – вызовы
fetchPhoto()
. - iOS – вызовы
loadPlacePhoto:
. - JavaScript – запросы к сервису Place Photos в библиотеке Places, Maps JavaScript API при запросе данных по URL, возвращенному методом
PlacePhoto.getUrl()
, для загрузки данных пикселей изображения. - Веб-сервис – запросы к сервису Place Photos в Places API.
В случае с сервисом JavaScript при использовании метода PlacePhoto.getUrl()
оплата не осуществляется, пока URL используется для получения данных пикселей.
МЕСЯЧНЫЙ ОБЪЕМ (цена за ОДИН ВЫЗОВ) |
||
---|---|---|
0,007 долл. США за ед. (7 долл. США за 1000) |
0,0056 долл. США за ед. (5,60 долл. США за 1000) |
Цены для особо крупных объемов уточняйте в отделе продаж. |
Код: Geocoding
Оплата по коду Geocoding начисляется за каждый запрос к сервису Geocoding в Maps JavaScript API или к Geocoding API.
В JavaScript метод Geocoder.geocode()
инициирует запрос в сервис Geocoding.
МЕСЯЧНЫЙ ОБЪЕМ (цена за ОДИН ЗАПРОС) |
||
---|---|---|
0,005 долл. США за ед. (5 долл. США за 1000) |
0,004 долл. США за ед. (4 долл. США за 1000) |
Цены для особо крупных объемов уточняйте в отделе продаж. |
Код: Geolocation
Оплата по коду Geolocation начисляется за каждый запрос к Geolocation API.
МЕСЯЧНЫЙ ОБЪЕМ (цена за ОДИН ЗАПРОС) |
||
---|---|---|
0,005 долл. США за ед. (5 долл. США за 1000) |
0,004 долл. США за ед. (4 долл. США за 1000) |
Цены для особо крупных объемов уточняйте в отделе продаж. |
Код: Time Zone
Оплата по коду Time Zone начисляется за каждый запрос к Time Zone API.
МЕСЯЧНЫЙ ОБЪЕМ (цена за ОДИН ЗАПРОС) |
||
---|---|---|
0,005 долл. США за ед. (5 долл. США за 1000) |
0,004 долл. США за ед. (4 долл. США за 1000) |
Цены для особо крупных объемов уточняйте в отделе продаж. |
Код: Elevation
Оплата по коду Elevation начисляется за каждый запрос к сервису Elevation в Maps JavaScript API или к Elevation API.
МЕСЯЧНЫЙ ОБЪЕМ (цена за ОДИН ЗАПРОС) |
||
---|---|---|
0,005 долл. США за ед. (5 долл. США за 1000) |
0,004 долл. США за ед. (4 долл. США за 1000) |
Цены для особо крупных объемов уточняйте в отделе продаж. |
Код: Address Validation
Вызов метода validateAddress (REST) или ValidateAddress (gRPC) в Address Validation API.
МЕСЯЧНЫЙ ОБЪЕМ (цена за ОДИН ЗАПРОС) |
||
---|---|---|
0,017 долл. США за ед. (17 долл. США за 1000) |
0,0136 долл. США за ед. (13,60 долл. США за 1000) |
Цены для особо крупных объемов уточняйте в отделе продаж. |