Сведения об устаревших кодах Places и Routes

На этой странице вы найдете информацию о кодах продуктов, их идентификаторах, оплачиваемых событиях и триггерах оплаты для устаревших версий Places API, Directions API и Distance Matrix API. Информацию о текущих версиях этих сервисов можно найти в статьях Сведения о SKU Places (New) и Сведения о SKU Routes and Navigation. Каталог всех категорий товаров приведен в обзоре сведений об использовании API.

О таблицах SKU

В следующих разделах приведены подробные сведения о каждом SKU:

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

Устаревшие коды продуктов Places

Последние версии см. в разделе Коды продуктов Places (New).

О кодах Places Data

Существует три типа кодов Places Data: Basic Data, Contact Data и Atmosphere Data.

Оплата по одному или нескольким кодам Data начисляется:

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

Коды Data всегда оплачиваются в дополнение к основным кодам с учетом запроса, по которому они сработали. Например, запрос информации о местах с полями данных Basic Data будет оплачиваться и как SKU Basic Data, и как SKU информации о местах.

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

Приведенные ниже вызовы Places API для веб-сервисов НЕ ПОДДЕРЖИВАЮТ указание возвращаемых полей данных. Эти вызовы всегда возвращают полные данные Places, что приводит к начислению платы по трем кодам Places Data в дополнение к плате за запрос к API.

[ Essentials: Places Legacy ]

Код: Autocomplete – Per Request

  Категория Essentials
  Идентификатор SKU

7384-2DE4-D388 (все страны)

2164-BC00-53DC (Индия)
  API Place Autocomplete (Legacy) Android,
Place Autocomplete (Legacy) iOS,
Place Autocomplete (Legacy) Web
  Оплачиваемое событие Запрос, не содержащий токен сеанса
  Триггеры
  Примеры

Если вы отправляете запрос из недопустимого сеанса Autocomplete (например, с уже использованным ранее токеном сеанса), плата также начисляется по коду Autocomplete – Per Request.

Запросы Autocomplete из виджета Place Autocomplete в Maps JavaScript API могут оплачиваться по коду Autocomplete – Per Request, если вызовы выполнены из недопустимого сеанса Autocomplete. Это может происходить в тех случаях, когда пользователь в виджете вводит или вставляет несколько разных адресов, не каждый раз выбирая подсказку автозаполнения.
  Цены Прейскурант (все страны)
Прейскурант (Индия)

Код: Autocomplete (включен в Place Details) – Per Session

  Категория Essentials
  Идентификатор SKU

E9C9-934B-DDB1 (все страны)
  API Place Autocomplete (Legacy) Android,
Place Autocomplete (Legacy) iOS,
Place Autocomplete (Legacy) Web
  Оплачиваемое событие Сеанс
  Триггеры
  • на устройствах Android – вызов fetchPlace();
  • на устройствах iOS – вызов fetchPlaceFromPlaceID:;
  • в веб-сервисах – запрос Place Details.

Поля в запросе:

Чтобы избежать лишних расходов, обязательно укажите в запросе нужные поля. В зависимости от того, какие поля вы указываете, запрос информации о местах также генерирует следующие коды Data SKU:

Если вы не указываете поля в запросе информации о местах, оплата начисляется по всем кодам Data.

Если во время сеанса автозаполнения вы запрашиваете только обновление идентификатора информации о местах (в запросе указано только поле place_id), сеанс оплачивается по коду SKU: Autocomplete without Place Details – Per Session.
  Примеры

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

В этом примере показана серия запросов по платформам, которые приведут к появлению в счете следующих кодов (при просмотре счета по кодам):

  • Автозаполнение (включая информацию о местах) – за сеанс
  • Информация о месте
  • Основные данные

Пример запроса по платформе:

Запросы 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: (включая идентификатор места и поле GMSPlaceFieldFormattedAddress)

Запросы к веб-сервисам

запрос автозаполнения мест (input="par", session_token: XYZ);
запрос автозаполнения мест (input="paris", session_token: XYZ);
информация о местах (place_id, session_token: XYZ, fields:formatted_address).

  Цены Прейскурант (все страны)
Прейскурант (Индия)

О сеансах Autocomplete

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

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

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

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

Оплата за сеансы с запросами Autocomplete и Places Details начисляется по разным кодам.

Код: Basic Data

Код Data, по которому оплачиваются поля Basic Data в запросе Places Details или Find Place.

  Категория Essentials
  Идентификатор SKU

75D4-C522-326B (все страны)

5D7B-1F7B-395E (Индия)
  API Информация о местах (устаревшее) с базовыми полями
Найти место (устаревшее) с базовыми полями
  Оплачиваемое событие Успешный запрос полей данных Basic Data
  Триггеры

Поля для Android SDK

Place.Field.ACCESSIBILITY_OPTIONS*
   * Используйте вместо Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE (поддержка прекращена)
Place.Field.ADDRESS_COMPONENTS
Place.Field.BUSINESS_STATUS
Place.Field.DISPLAY_NAME*
   * Используйте вместо Place.Field.NAME (поддержка прекращена)
Place.Field.FORMATTED_ADDRESS*
   * Используйте вместо Place.Field.ADDRESS (поддержка прекращена)
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL*
   * Используйте вместо Place.Field.ICON_URL (поддержка прекращена)
Place.Field.ID
Place.Field.LOCATION*
   * Используйте вместо Place.Field.LAT_LNG (поддержка прекращена)
Place.Field.PHOTO_METADATAS
Place.Field.PLUS_CODE
Place.Field.TYPES
Place.Field.VIEWPORT
Place.Field.UTC_OFFSET.

Поля для iOS

GMSPlaceFieldFormattedAddress
GMSPlaceFieldBusinessStatus
GMSPlaceFieldID
GMSPlaceFieldCoordinate
GMSPlaceFieldName
GMSPlaceFieldPhotos
GMSPlaceFieldPlusCode
GMSPlaceFieldTypes
GMSPlaceFieldViewport

Поля для веб-сервиса

address_component
adr_address
business_status
formatted_address
geometry
icon
name
permanently_closed
photo
place_id
plus_code
type
url
utc_offset
vicinity
wheelchair_accessible_entrance

  Оплата за маску поля

Стоимость запроса зависит от полей, указанных в маске. Пример:

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

Код: Find Place – ID only

  Категория Essentials
  Идентификатор SKU

44A2-D839-A3AC (глобальный)

FE05-60A4-CDDF (Индия)
  API Веб-сервис Places Find Place
  Оплачиваемое событие Успешный запрос только для place_id
  Триггеры Запрос Find Place, в котором не указаны поля или указано только поле place_id: FindPlace(fields: place_id).
  Цены Прейскурант (международный)
Прейскурант (Индия)

Код: Place Details – ID Refresh

  Категория Essentials
  Идентификатор SKU

2D88-4302-6299 (все страны)

4604-F56B-7086 (Индия)
  API Place Details (Legacy)
  Оплачиваемое событие Успешный запрос только полей идентификаторов
  Триггеры Запрос, содержащий только поле идентификатора места: getPlaceDetails(fields: place_id).
  Цены Прейскурант (международный)
Прейскурант (Индия)

Код: Query Autocomplete – Per Request

  Категория Essentials
  Идентификатор SKU

C4B1-8805-63EF (все страны)

59E9-EB83-5CA3 (Индия)
  API Сервис Query Autocomplete
  Оплачиваемое событие Запрос выполнен
  Триггеры

При использовании запросов Query Autocomplete оплата по сеансам Autocomplete не поддерживается. Последующие запросы информации о местах оплачиваются по коду Place Details Pro SKU.

  Цены Прейскурант (международный)
Прейскурант (Индия)

[ Pro: Places Legacy ]

Код: Autocomplete without Place Details – Per Session

  Категория Pro
  Идентификатор SKU

B52C-8320-6DC5 (все страны)

C625-D3CE-DF37 (Индия)
  API Place Autocomplete (Legacy) Android,
Place Autocomplete (Legacy) iOS,
Place Autocomplete (Legacy) Web
  Оплачиваемое событие Сеанс
  Триггеры
  Цены Прейскурант (международный)
Прейскурант (Индия)

Код: Find Current Place

  Категория Pro
  Идентификатор SKU

7218-264C-D1D7 (все страны)

0862-F46E-1A1A (Индия)
  API Places SDK для Android,
Places SDK для iOS
  Оплачиваемое событие Запрос выполнен
  Триггеры
  Примеры

В примерах ниже показано, по каким кодам начисляется оплата, когда вы отправляете запрос Find Current Place и указываете поля из кодов Basic, Contact и Atmosphere. Чтобы посмотреть SKU в счете, откройте счет по SKU, как описано в разделе Анализируйте использование сервисов и расходы по SKU.

Вы создаете запрос Find Current Place и указываете только поле ADDRESS:

В счете вы увидите следующие коды:

  • Find Current Place
  • Основные данные

Вы создаете запрос Find Current Place и указываете только поле PHONE_NUMBER:

В счете вы увидите следующие коды:

  • Find Current Place
  • Контактные данные

Вы создаете запрос Find Current Place со всеми тремя полями типов данных:

В счете вы увидите следующие коды:

  • Find Current Place
  • Основные данные
  • Контактные данные
  • Данные об атмосфере
  Цены Прейскурант (международный)
Прейскурант (Индия)

Код: Find Place

  Категория Pro
  Идентификатор SKU

DC67-3188-2294 (все страны)

ECB4-087C-9A27 (Индия)
  API Find Place (устаревший)
  Оплачиваемое событие Успешный запрос, в котором запрашивается не только поле ID
  Триггеры Запрос Find Place, в котором указано не только поле идентификатора.
  Примеры

В примерах ниже показано, по каким кодам начисляется оплата, когда вы отправляете запрос Find Current Place и указываете поля из кодов Basic, Contact и Atmosphere. Чтобы посмотреть SKU в счете, откройте счет по SKU, как описано в разделе Анализируйте использование сервисов и расходы по SKU.

Вы создаете запрос Find Place, указав только поле ADDRESS.

В счете вы увидите следующие коды:

  • Find Current Place
  • Основные данные

Вы создаете запрос Find Place, указав только поле PHONE_NUMBER.

В счете вы увидите следующие коды:

  • Find Current Place
  • Контактные данные

Вы создаете запрос Find Place с полями всех трех типов данных:

В счете вы увидите следующие коды:

  • Find Current Place
  • Основные данные
  • Контактные данные
  • Данные об атмосфере
  Цены Прейскурант (международный)
Прейскурант (Индия)

Код: Places – Nearby Search

  Категория Pro
  Идентификатор SKU

6B23-8A17-D29D (все страны)

CC66-BE0E-2477 (Индия)
  API Поиск поблизости (устаревший)
  Оплачиваемое событие Запрос на доступ к функциям Pro отправлен
  Триггеры

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

Вы создаете запрос Nearby Search, например NearbySearch (San Francisco, 100 meters). В счете вы увидите следующий список кодов (при просмотре счета по кодам):

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

Код: Places – Text Search

  Категория Pro
  Идентификатор SKU

E95A-86C7-7F47 (все страны)

102E-888D-5596 (Индия)
  API Text Search (Legacy)
  Оплачиваемое событие Успешный запрос к текстовому поиску (устаревшая версия).
  Триггеры

Запросы текстового поиска возвращают список мест, но не поддерживают указание конкретных полей, которые должны возвращаться в результатах. Запросы текстового поиска возвращают подмножество поддерживаемых полей данных. Вы оплачиваете запрос текстового поиска, а также все коды SKU типов данных: Basic Data, Contact Data и Atmosphere Data.

SKU: Places – текстовый поиск также применяется для виджета Place SearchBox в Maps JavaScript API: метод getPlaces(), если пользователь выбирает поисковой запрос места (значок "лупа"), а не подсказку (значок "маркер"), как показано ниже.

Выбор поискового запроса в виджете окна поиска с информацией о местах
В результатах виджета окна поиска для запроса "pizza" рядом с вариантом pizza delivery показан значок лупы, который означает, что это поисковой запрос места, а не подсказка.
  Примеры

Если вы выполняете запрос Text Search (Legacy), в счете будут указаны следующие коды (при просмотре счета по кодам):

  • Places – текстовый поиск
  • Основные данные
  • Контактные данные
  • Данные об атмосфере
  Цены Прейскурант (международный)
Прейскурант (Индия)

Код: Places Details

  Категория Pro
  Идентификатор SKU

FC5C-DF28-543F (все страны)

F7AA-FEF9-C90E (Индия)
  API Place Details (Legacy)
  Оплачиваемое событие Запрос на доступ к функциям Pro отправлен
  Триггеры

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

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

[ Enterprise: Places Legacy ]

Код: Atmosphere Data

Код Data, по которому начисляется оплата за поля Atmosphere Data в запросе Places Details или Find Place.

  Категория Enterprise
  Идентификатор SKU

D63D-5CC5-302A (все страны)

0CE0-1963-137E (Индия)
  API Информация о местах (устаревшая версия) с полями Atmosphere
Найти место (устаревшая версия) с полями Atmosphere
  Оплачиваемое событие Успешный запрос полей данных об атмосфере
  Триггеры
  Примеры масок полей для платежных аккаунтов

Стоимость запроса зависит от полей, указанных в маске. Пример:

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

Код: Contact Data

Код Data, по которому начисляется оплата за поля Contact Data в запросе Places Details или Find Place.

  Категория Enterprise
  Идентификатор SKU

F095-CD01-81B2 (глобальный)

A03F-5079-C66C (Индия)
  API Информация о местах (устаревшая версия) с полями Contact
Найти место (устаревшая версия) с полями Contact
  Оплачиваемое событие Успешный запрос полей данных Contact Data
  Триггеры

Поля для Android SDK

Place.Field.CURRENT_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER*
      * Используйте вместо Place.Field.PHONE_NUMBER (поддержка прекращена).
Place.Field.OPENING_HOURS
Place.Field.SECONDARY_OPENING_HOURS
Place.Field.WEBSITE_URI

Поля для iOS SDK

GMSPlaceFieldOpeningHours
GMSPlaceFieldPhoneNumber
GMSPlaceFieldWebsite

Поля для веб-сервиса

formatted_phone_number
international_phone_number
opening_hours
current_opening_hours secondary_opening_hours
website

  Оплата за маску поля

Стоимость запроса зависит от полей, указанных в маске. Пример:

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

Код: Places Photo

  Категория Enterprise
  Идентификатор SKU

81E7-85D0-58A7 (все страны)

9F4B-2E19-1B63 (Индия)
  API Places Photo (устаревшая версия)
  Оплачиваемое событие Успешный запрос на фото
  Триггеры
  • Android: запросы к fetchPhoto().
  • iOS: запросы к loadPlacePhoto:.
  • JavaScript – запросы к PlacePhoto.getUrl() для загрузки данных пикселей изображения.
  • Веб-сервис – запросы к сервису Place Photos в Places API.
  Цены Прейскурант (международный)
Прейскурант (Индия)

Устаревшие коды Routes API

[ Essentials: Routes Legacy ]

Код: Directions

  Категория Essentials
  Идентификатор SKU

28A8-3EB4-4595 (все страны)

4714-291C-3199 (Индия)
  API Сервис Directions в Maps JavaScript API
Directions API (устаревшая версия)
  Оплачиваемое событие Успешный запрос без функций Pro или Enterprise
  Триггеры Запросы, которые не активируют код SKU с более высокой ценой
  Цены Прейскурант (все страны)
Прейскурант (Индия)

SKU: Матрица расстояний

  Категория Essentials
  Идентификатор SKU

C1B6-FF9D-7700 (все страны)

558A-4F88-F361 (Индия)
  API Distance Matrix API (устаревший),
Сервис матрицы расстояний в Maps JavaScript API
  Оплачиваемое событие Каждый элемент, который не содержит функций Pro или Enterprise. Каждый запрос, отправляемый в Distance Matrix API, создает некоторое количество элементов, которое определяется произведением значений origins и destinations.
  Триггеры Запросы элементов, которые не активируют более дорогие SKU
  Цены Прейскурант (международный)
Прейскурант (Индия)

[ Pro: Routes Legacy ]

Код: Directions Advanced

  Категория Pro
  Идентификатор SKU

9407-00C2-CF85 (все страны)

E27B-BD57-FD7D (Индия)
  API Сервис Directions в Maps JavaScript API
Directions API (устаревшая версия)
  Оплачиваемое событие Успешный запрос с функциями Pro
  Триггеры
  Цены Прейскурант (международный)
Прейскурант (Индия)

SKU: Матрица расстояний Advanced

  Категория Pro
  Идентификатор SKU

DFAE-763F-CF6E (глобальный)

C0F4-32AE-F6D1 (Индия)
  API Distance Matrix API (устаревший),
Сервис матрицы расстояний в Maps JavaScript API
  Оплачиваемое событие Каждый элемент возвращается с функциями Pro. Каждый запрос, отправляемый в Distance Matrix API, создает некоторое количество элементов, которое определяется произведением значений origins и destinations.
  Триггеры
  Цены Прейскурант (международный)
Прейскурант (Индия)