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

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

Как оплачивается Places API

Places API использует модель ценообразования с оплатой по мере использования. Плата за API и SDK платформы Google Maps взимается в зависимости от SKU. Использование отслеживается для каждого SKU, и любой API или SDK может иметь более одного SKU продукта . Стоимость рассчитывается по

Использование SKU × Цена за каждое использование

Используйте наш калькулятор цен и использования , чтобы оценить стоимость использования API или SDK. Для соответствующих SKU платформы Google Maps ежемесячно предоставляется кредит в размере 200 долларов США для каждой платежной учетной записи. Этот кредит автоматически применяется 1 к соответствующим SKU.

Цены на Places API

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

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

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

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

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

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

Об артикулах Places Data

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

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

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

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

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

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

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

Используя параметр fields в запросе Place Details или Find Place, вы можете ограничить ответ только указанными полями. Поля в категории «Базовый» включены в базовую стоимость запроса «Места» и не требуют дополнительной оплаты. Артикул 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 или Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
  • 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
ЕЖЕМЕСЯЧНЫЙ ОБЪЕМ
(Цена за ЗВОНОК)
0–100 000 100 001–500 000 500 000+
Стоимость запроса мест
+ 0,00 долларов США		 Стоимость запроса мест
+ 0,00 долларов США		 Стоимость запроса мест
+ 0,00 долларов США

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

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

  • 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–100 000 100 001–500 000 500 000+
Стоимость запроса мест
+ 0,003 доллара США за каждый
(+ 3,00 доллара США за 1000)		 Стоимость запроса мест
+ 0,0024 доллара США за каждый
(+ 2,40 доллара США за 1000)		 Свяжитесь с отделом продаж , чтобы узнать оптовые цены

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

Используя параметр fields в запросе Place Details или Find Place, вы можете ограничить ответ только указанными полями. За поля в категории «Атмосфера» взимается дополнительная плата. Артикул Atmosphere Data запускается при запросе любого из этих полей:

  • Android: Place.Field.CURBSIDE_PICKUP , Place.Field.DELIVERY , 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 , GMSPlaceFieldServesBreakfast , GMSPlaceFieldServesLunch , GMSPlaceFieldServesDinner , GMSPlaceFieldServesBeer , GMSPlaceFieldServesWine , GMSPlaceFieldServesBrunch or GMSPlaceFieldServesVegetarianFood .
  • 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–100 000 100 001–500 000 500 000+
Стоимость запроса мест
+ 0,005 долларов США за каждый
(+ 5,00 долларов США за 1000)		 Стоимость запроса мест
+ 0,004 доллара США за каждый
(+ 4,00 доллара США за 1000)		 Свяжитесь с отделом продаж , чтобы узнать оптовые цены

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

Стоимость Autocomplete — Per Request SKU взимается за любые из этих вызовов или запросов, не включающих токен сеанса:

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

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

ЕЖЕМЕСЯЧНЫЙ ОБЪЕМ
(Цена за ЗАПРОС)
0–100 000 100 001–500 000 500 000+
0,00283 долларов США за каждый
(2,83 доллара США за 1000)		 0,00227 долларов США за каждый
(2,27 доллара США за 1000)		 Свяжитесь с отделом продаж , чтобы узнать оптовые цены

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

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

ЕЖЕМЕСЯЧНЫЙ ОБЪЕМ
(Цена за СЕАНС)
0–100 000 100 001–500 000 500 000+
0,017 долларов США за каждый
(17,00 долларов США за 1000)		 0,0136 долларов США за каждый
(13,60 долларов США за 1000)		 Свяжитесь с отделом продаж , чтобы узнать оптовые цены

Пример

Если ваше приложение выполняет эти два вызова в одном сеансе:

Андроид

iOS

веб-сервис

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

  • Автозаполнение без сведений о месте – за сеанс (цена от 0,017 долларов США за сеанс)

Артикул: автозаполнение (включено в сведения о месте) — за сеанс

Автозаполнение (включено в сведения о месте) — SKU за сеанс взимается за сеанс автозаполнения , который включает любое из следующих действий:

  • Android: вызов fetchPlace()
  • iOS: вызов fetchPlaceFromPlaceID:
  • Веб-сервис: запрос сведений о месте

Запрос автозаполнения доступен бесплатно, а последующий вызов Place Details оплачивается на основе обычных цен на Place Details .

Запрос Place Details генерирует SKU данных ( Basic , Contact и/или Atmosphere ) в зависимости от полей, указанных в запросе.

Если вы не укажете поля в запросе сведений о месте, активируются все SKU данных (базовый, контакт и атмосфера).

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

ЕЖЕМЕСЯЧНЫЙ ОБЪЕМ
(Цена за СЕАНС)
0–100 000 100 001–500 000 500 000+
0.00 долларов США 0.00 долларов США 0.00 долларов США

Пример

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

Андроид

iOS

веб-сервис

В вашем счете вы увидите перечисленные ниже артикулы (при просмотре счета по артикулам ):

  • Автозаполнение (включено в сведения о месте) — за сеанс (оплачивается в размере 0,00 долларов США)
  • Детали места (цена от 0,017 долларов США за сеанс)
  • Базовые данные (оплачивается в размере 0,00 долларов США)

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

Query Autocomplete — Per Request SKU взимается за каждый запрос на:

ЕЖЕМЕСЯЧНЫЙ ОБЪЕМ
(Цена за ЗАПРОС)
0–100 000 100 001–500 000 500 000+
0,00283 долларов США за каждый
(2,83 доллара США за 1000)		 0,00227 долларов США за каждый
(2,27 доллара США за 1000)		 Свяжитесь с отделом продаж , чтобы узнать оптовые цены

Ценообразование по сеансу автозаполнения не поддерживается при использовании автозаполнения запросов. Последующие вызовы Places Details оплачиваются на основе обычных расценок Places Details .

Артикул: Детали места

Плата за вызовы Place Details взимается следующим образом:

ЕЖЕМЕСЯЧНЫЙ ОБЪЕМ
(Цена за ЗВОНОК)
0–100 000 100 001–500 000 500 000+
0,017 долларов США за каждый
(17,00 долларов США за 1000)		 0,0136 долларов США за каждый
(13,60 долларов США за 1000)		 Свяжитесь с отделом продаж , чтобы узнать оптовые цены

Артикул Place Details создается из следующих API:

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

Вызов или запрос сведений о месте также создает SKU данных ( Basic , Contact и/или Atmosphere ) в зависимости от полей, указанных в вызове или запросе. Если в вызове или запросе сведений о месте не указано ни одного поля, активируются ВСЕ SKU данных, и с вас будет взиматься плата за вызов или запрос сведений о местах плюс стоимость всех данных.

Примеры

  1. Сделайте один из этих звонков или запросов:
    • Мобильный телефон: вызовите fetchPlace() на Android или fetchPlaceFromPlaceID: на iOS и укажите только поле ADDRESS .
    • Веб-API или сервис: сделайте запрос сведений о месте и укажите только поле адреса: getPlaceDetails(fields: formatted_address)
    В вашем счете вы увидите перечисленные ниже артикулы (при просмотре счета по артикулам ):
    • Детали места (цена от 0,017 долларов США за сеанс)
    • Базовые данные (оплачивается в размере 0,00 долларов США)
  2. Сделайте один из этих звонков или запросов:
    • Мобильный телефон: вызовите fetchPlace() на Android или fetchPlaceFromPlaceID: на iOS и укажите только поле PHONE_NUMBER .
    • Веб-API или сервис: сделайте запрос Place Details и укажите поле номера телефона: getPlaceDetails(fields: formatted_phone_number)
    В вашем счете вы увидите перечисленные ниже артикулы (при просмотре счета по артикулам ):
    • Детали места (цена от 0,017 долларов США за сеанс)
    • Контактные данные (цена от 0,003 долларов США за запрос)
  3. Сделайте один из этих звонков или запросов:
    • Мобильный телефон: вызовите fetchPlace() на Android или fetchPlaceFromPlaceID: на iOS и укажите все поля.
    • Веб-API или сервис: сделайте запрос Place Details и укажите все поля (этот тип запроса используется по умолчанию, если вы не укажете ни одного поля): getPlaceDetails() .
    В вашем счете вы увидите перечисленные ниже артикулы (при просмотре счета по артикулам ):
    • Детали места (цена от 0,017 долларов США за сеанс)
    • Базовые данные (оплачивается в размере 0,00 долларов США)
    • Контактные данные (цена от 0,003 долларов США за запрос)
    • Атмосферные данные (цена от 0,005 долларов США за запрос)

Артикул: Детали места – Обновление идентификатора

Используйте запрос сведений о месте, чтобы обновить устаревшие идентификаторы мест . Эти типы запросов доступны бесплатно.

ЕЖЕМЕСЯЧНЫЙ ОБЪЕМ
(Цена за ЗВОНОК)
0–100 000 100 001–500 000 500 000+
0.00 долларов США 0.00 долларов США 0.00 долларов США

Пример

Сделайте запрос сведений о месте, указав только поле идентификатора места: getPlaceDetails(fields: place_id) . В вашем счете вы увидите этот SKU в списке (при просмотре счета по SKU ):

  • Сведения о месте — обновление идентификатора (оплачивается в размере 0,00 долларов США)

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

Плата за поиск места взимается за запрос на поиск места.

ЕЖЕМЕСЯЧНЫЙ ОБЪЕМ
(Цена за ЗВОНОК)
0–100 000 100 001–500 000 500 000+
0,017 долларов США за каждый
(17,00 долларов США за 1000)		 0,0136 долларов США за каждый
(13,60 долларов США за 1000)		 Свяжитесь с отделом продаж , чтобы узнать оптовые цены

Запросы Find Place также генерируют SKU данных ( Basic , Contact и/или Atmosphere ) в зависимости от полей, указанных в запросе. Как и в запросах сведений о месте, вы можете использовать параметр fields в запросе на поиск места, чтобы ограничить ответ только указанными полями. Вам выставляется счет за запрос «Найти место», а также за запрашиваемые данные. По умолчанию, если поля НЕ запрашиваются, возвращается только идентификатор места, поэтому дополнительная плата за передачу данных не взимается.

Примеры

  1. Вы делаете запрос на поиск места и указываете только поле адреса: FindPlace(fields: formatted_address) . В вашем счете вы увидите перечисленные ниже артикулы (при просмотре счета по артикулам ):
    • Find Place (цена от 0,017 долларов США за звонок)
    • Базовые данные (оплачивается в размере 0,00 долларов США)
  2. Вы делаете запрос Find Place и указываете поле номера телефона: FindPlace(fields: formatted_phone_number) . В вашем счете вы увидите перечисленные ниже артикулы (при просмотре счета по артикулам ):
    • Find Place (цена от 0,017 долларов США за звонок)
    • Контактные данные (цена от 0,003 долларов США за запрос)
  3. Вы делаете запрос «Найти место» и указываете поля из всех трех сегментов типа данных: FindPlace(fields: formatted_address, opening_hours, price_level) . В вашем счете вы увидите перечисленные ниже артикулы (при просмотре счета по артикулам ):
    • Find Place (цена от 0,017 долларов США за звонок)
    • Базовые данные (оплачивается в размере 0,00 долларов США)
    • Контактные данные (цена от 0,003 долларов США за запрос)
    • Атмосферные данные (цена от 0,005 долларов США за запрос)

Артикул: «Найти место» — только идентификатор

Find Place (Найти место) — плата взимается только за идентификатор для запросов Find Place, в которых указывается только возвращаемый идентификатор места. По умолчанию, если в запросе «Найти место» не указаны поля, возвращается только идентификатор места.

ЕЖЕМЕСЯЧНЫЙ ОБЪЕМ
(Цена за ЗВОНОК)
0–100 000 100 001–500 000 500 000+
0.00 долларов США 0.00 долларов США 0.00 долларов США

Пример

Вы делаете запрос на поиск места и указываете только поле place_id : FindPlace(fields: place_id) . В вашем счете вы увидите этот SKU в списке (при просмотре счета по SKU ):

  • Найти место — только удостоверение личности (оплачивается в размере 0,00 долларов США)

Place — функция поиска поблизости взимается за запросы к службе поиска мест поблизости API JavaScript Карт ( nearbySearch() ) или к службе поиска поблизости API Places.

ЕЖЕМЕСЯЧНЫЙ ОБЪЕМ
(Цена за ЗВОНОК)
0–100 000 100 001–500 000 500 000+
0,032 доллара США за каждый
(32,00 долларов США за 1000)		 0,0256 долларов США за каждый
(25,60 долларов США за 1000)		 Свяжитесь с отделом продаж , чтобы узнать оптовые цены

Запросы Nearby Search возвращают список мест, но не поддерживают указание возвращаемых полей. Запросы Nearby Search возвращают подмножество поддерживаемых полей данных . Плата взимается за запрос поиска поблизости, начиная с 0,032 доллара США за каждый, а также за все SKU типа данных ( базовые данные , контактные данные и данные об атмосфере ).

Пример

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

  • Place – Поиск рядом (цена от 0,032 доллара США за звонок)
  • Базовые данные (оплачивается в размере 0,00 долларов США)
  • Контактные данные (цена от 0,003 долларов США за запрос)
  • Атмосферные данные (цена от 0,005 долларов США за запрос)

Артикул: Место – текстовый поиск

Place — Text Search оплачивается за запросы к службе текстового поиска мест Maps JavaScript API ( textSearch() ) или к службе текстового поиска Places API .

ЕЖЕМЕСЯЧНЫЙ ОБЪЕМ
(Цена за ЗВОНОК)
0–100 000 100 001–500 000 500 000+
0,032 доллара США за каждый
(32,00 долларов США за 1000)		 0,0256 долларов США за каждый
(25,60 долларов США за 1000)		 Свяжитесь с отделом продаж , чтобы узнать оптовые цены

Запросы текстового поиска возвращают список мест, но не поддерживают указание возвращаемых полей. Запросы текстового поиска возвращают подмножество поддерживаемых полей данных . Плата взимается за запрос текстового поиска, начиная с 0,032 доллара США за каждый, а также за все SKU типа данных ( базовые данные , контактные данные и данные об атмосфере ).

Артикул «Место — текстовый поиск» также генерируется виджетом Place SearchBox API JavaScript Карт : методом getPlaces() после того, как пользователь выбирает запрос места (значок: лупа), а не результат (значок: булавка), как показано здесь:

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

Пример

Вы делаете запрос Text Search, например TextSearch(123 Main Street) . В вашем счете вы увидите перечисленные ниже артикулы (при просмотре счета по артикулам ):

  • Place - текстовый поиск (цена от 0,032 USD за звонок)
  • Базовые данные (оплачивается в размере 0,00 долларов США)
  • Контактные данные (цена от 0,003 долларов США за запрос)
  • Атмосферные данные (цена от 0,005 долларов США за запрос)

Артикул: Место Фото

Плата за артикул Place Photo взимается за:

Для службы JavaScript вызов метода PlacePhoto.getUrl() не приводит к выставлению счетов до тех пор, пока URL-адрес не будет фактически использован для получения данных о пикселях.

ЕЖЕМЕСЯЧНЫЙ ОБЪЕМ
(Цена за ЗВОНОК)
0–100 000 100 001–500 000 500 000+
0,007 долларов США за каждый
(7,00 долларов США за 1000)		 0,0056 долларов США за каждый
(5,60 долларов США за 1000)		 Свяжитесь с отделом продаж , чтобы узнать оптовые цены

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

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

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

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

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

Управляйте стоимостью использования

Чтобы управлять стоимостью использования API платформы Google Карт, установите дневную квоту на все запросы к любому оплачиваемому API. Дневные квоты сбрасываются в полночь по тихоокеанскому времени.

Чтобы просмотреть или изменить лимиты квот для Places API:

  1. В Cloud Console откройте страницу квот платформы Google Maps .
  2. Щелкните раскрывающийся список API и выберите Places API .
  3. Чтобы просмотреть лимиты квоты, прокрутите вниз до карточки «Запросы» .
    В таблице перечислены имена и ограничения квот.
  4. Чтобы изменить ограничение квоты, щелкните значок «Изменить» для этого ограничения.
    В появившемся диалоговом окне в поле Лимит квоты введите предпочтительную оплачиваемую дневную квоту (вплоть до квоты, если таковая имеется, указанная Google) и нажмите Сохранить .

Если использование вами API достигает предела оплачиваемой квоты в какой-либо день, ваше приложение не сможет получить доступ к API до конца этого дня.

  1. Пользователи в Индии должны создать платежную учетную запись Google Cloud Platform, прежде чем создавать платежную учетную запись платформы Google Maps, чтобы получить кредит платформы Maps. ↩