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

Напоминание: чтобы использовать Places SDK для Android, вы должны включать ключ API во все запросы API и включить выставление счетов для каждого из своих проектов.

Ошибка: 9005 PLACES_API_RATE_LIMIT_EXCEEDED.

Примечание. Если в вашем приложении Android возникает ошибка 9005 PLACES_API_RATE_LIMIT_EXCEEDED , возможно, вы используете устаревшую версию Places SDK для Android. Версия Places SDK для Android для Сервисов Google Play (например com.google.android.gms:play-services-places ) устарела с 29 января 2019 г. и отключена 29 июля 2019 г. Новая версия Places SDK для Android теперь доступен. Мы рекомендуем обновиться до новой версии как можно скорее. Подробности смотрите в руководстве по миграции .

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

Как выставляется счет за Places SDK для Android

Places SDK для Android версии 3.3.0 поддерживает две версии SDK: существующую Places SDK для Android и Places SDK для Android (новую) — версию SDK следующего поколения. Чтобы узнать ключевые различия между двумя версиями SDK, см. раздел «Выбор версии SDK» .

Выбранная вами версия SDK управляет ценами на сведения о месте, текстовый поиск и фотографии места. Подробную информацию о ценах см. в разделах «Цены на Places SDK для Android (новая версия)» и «Цены на Places SDK для Android» .

Цены на автозаполнение мест и текущее место одинаковы для обоих SDK.

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

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

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

Цены на Places SDK для Android (новинка)

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

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

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

Артикул: Сведения о месте (только идентификаторы)

Примечание. Если вы выберете какие-либо поля из SKU «Сведения о месте (только местоположение), вам будет выставлен счет по этому тарифу». Если вы выберете какие-либо поля из SKU «Сведения о месте (базовый)», вам будет выставлен счет по этому тарифу. Если вы выберете какие-либо поля из SKU «Сведения о месте (расширенные)», вам будет выставлен счет по этой ставке. Если вы выберете какие-либо поля из SKU «Сведения о месте (предпочтительно)», вам будет выставлен счет по этой ставке.

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

Android : Place.Field.ID , Place.Field.NAME , Place.Field.PHOTO_METADATAS

ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за ЗВОНОК)
0–100 000	100 001–500 000	500 000+
0,0 доллара США за каждого (0,00 доллара США за 1000)	0,0 доллара США за каждого (0,00 доллара США за 1000)	0,0 доллара США за каждого (0,00 доллара США за 1000)

---

Артикул: Подробности о месте (только местоположение)

Примечание. Артикул: сведения о месте (только местоположение) находится в предварительной версии. Информация о ценах публикуется только для информационного использования — использование во время предварительной версии предоставляется со скидкой до 0 долларов США.

Примечание. Если вы выберете какие-либо поля из SKU «Сведения о месте (базовый)», вам будет выставлен счет по этому тарифу. Если вы выберете какие-либо поля из SKU «Сведения о месте (расширенные)», вам будет выставлен счет по этой ставке. Если вы выберете какие-либо поля из SKU «Сведения о месте (предпочтительно)», вам будет выставлен счет по этой ставке.

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

Android : Place.Field.ADDRESS_COMPONENTS , Place.Field.ADDRESS , Place.Field.LAT_LNG , Place.Field.PLUS_CODE , Place.Field.TYPES , Place.Field.VIEWPORT

ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за ЗВОНОК)
0–100 000	100 001–500 000	500 000+
0,005 доллара США за каждого (5,00 долларов США за 1000)	0,004 доллара США за каждого (4,00 долларов США за 1000)	Свяжитесь с отделом продаж для уточнения оптовых цен.

---

Артикул: Детали места (базовый)

Примечание. Если вы выберете какие-либо поля из SKU «Сведения о месте (расширенные)», вам будет выставлен счет по этой ставке. Если вы выберете какие-либо поля из SKU «Сведения о месте (предпочтительно)», вам будет выставлен счет по этой ставке.

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

Android : Place.Field.BUSINESS_STATUS , Place.Field.ICON_BACKGROUND_COLOR , Place.Field.ICON_URL , Place.Field.UTC_OFFSET , Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE

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

---

Артикул: Сведения о месте (расширенный)

Примечание. Если вы выберете какие-либо поля из SKU «Сведения о месте (предпочтительно)», вам будет выставлен счет по этому тарифу.

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

Android : Place.Field.CURRENT_OPENING_HOURS , Place.Field.SECONDARY_OPENING_HOURS , Place.Field.PHONE_NUMBER , Place.Field.PRICE_LEVEL , Place.Field.RATING , Place.Field.OPENING_HOURS , Place.Field.USER_RATINGS_TOTAL , Place.Field.WEBSITE_URI

ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за ЗВОНОК)
0–100 000	100 001–500 000	500 000+
0,020 доллара США за каждого (20,00 долларов США за 1000)	0,016 доллара США за каждого (16,00 долларов США за 1000)	Свяжитесь с отделом продаж для уточнения оптовых цен.

---

Артикул: Подробности о месте (предпочтительно)

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

Android : Place.Field.CURBSIDE_PICKUP , Place.Field.DELIVERY , Place.Field.DINE_IN , Place.Field.EDITORIAL_SUMMARY , Place.Field.RESERVABLE , Place.Field.REVIEWS , 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

ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за ЗВОНОК)
0–100 000	100 001–500 000	500 000+
0,025 доллара США за каждого (25,00 долларов США за 1000)	0,020 доллара США за каждого (20,00 долларов США за 1000)	Свяжитесь с отделом продаж для уточнения оптовых цен.

---

Артикул: Текстовый поиск (только идентификатор)

Примечание. Если вы выберете какие-либо поля из SKU «Текстовый поиск (базовый)», вам будет выставлен счет по этому тарифу. Если вы выберете какие-либо поля из SKU «Текстовый поиск (расширенный)», вам будет выставлен счет по этой ставке. Если вы выберете какие-либо поля из SKU «Текстовый поиск (предпочтительный)», вам будет выставлен счет по этой ставке.

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

Android : Place.Field.ID , Place.Field.NAME

ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за ЗВОНОК)
0–100 000	100 001–500 000	500 000+
0,0 доллара США за каждого (0,00 доллара США за 1000)	0,0 доллара США за каждого (0,00 доллара США за 1000)	0,0 доллара США за каждого (0,00 доллара США за 1000)

---

Артикул: Текстовый поиск (базовый)

Примечание. Если вы выберете какие-либо поля из SKU «Текстовый поиск (расширенный)», вам будет выставлен счет по этой ставке. Если вы выберете какие-либо поля из SKU «Текстовый поиск (предпочтительный)», вам будет выставлен счет по этой ставке.

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

Android : Place.Field.ADDRESS_COMPONENTS , Place.Field.BUSINESS_STATUS , Place.Field.ADDRESS , Place.Field.ICON_BACKGROUND_COLOR , Place.Field.ICON_URL , Place.Field.LAT_LNG , Place.Field.PHOTO_METADATAS , Place.Field.PLUS_CODE , Place.Field.TYPES , Place.Field.UTC_OFFSET , Place.Field.VIEWPORT , Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE

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

---

Артикул: Текстовый поиск (расширенный)

Примечание. Если вы выберете какие-либо поля из SKU «Текстовый поиск (предпочтительный)», вам будет выставлен счет по этой ставке.

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

Android : Place.Field.CURRENT_OPENING_HOURS , Place.Field.SECONDARY_OPENING_HOURS , Place.Field.PHONE_NUMBER , Place.Field.PRICE_LEVEL , Place.Field.RATING , Place.Field.OPENING_HOURS , Place.Field.USER_RATINGS_TOTAL , Place.Field.WEBSITE_URI

ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за ЗВОНОК)
0–100 000	100 001–500 000	500 000+
0,035 доллара США за каждого (35,00 долларов США за 1000)	0,028 доллара США за каждого (28,00 долларов США за 1000)	Свяжитесь с отделом продаж для уточнения оптовых цен.

---

Артикул: Текстовый поиск (предпочтительно)

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

Android : Place.Field.CURBSIDE_PICKUP , Place.Field.DELIVERY , Place.Field.DINE_IN , Place.Field.EDITORIAL_SUMMARY , Place.Field.RESERVABLE , Place.Field.REVIEWS , 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

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

---

Артикул: Разместить фото

За каждый запрос к API взимается SKU Place Photo .

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

---

Цены на Places SDK для Android

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

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

---

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

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

Используя параметр полей в запросе «Сведения о месте» или «Найти место», вы можете ограничить ответ только указанными полями. Поля категории «Базовый » включены в базовую стоимость запроса мест и не требуют дополнительной оплаты. Артикул базовых данных активируется при запросе любого из этих полей:

• 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–100 000	100 001–500 000	500 000+
Стоимость запроса мест + 0,00 долларов США	Стоимость запроса мест + 0,00 долларов США	Стоимость запроса мест + 0,00 долларов США

---

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

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

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

---

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

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

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

• 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 , GMSPlaceFieldServesBreakfast , GMSPlaceFieldServesLunch , GMSPlaceFieldServesDinner , GMSPlaceFieldServesBeer , GMSPlaceFieldServesWine , GMSPlaceFieldServesBrunch или 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)	Свяжитесь с отделом продаж для уточнения оптовых цен.

---

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

Артикул «Автозаполнение — по запросу» взимается за любой из этих вызовов или запросов, которые не включают токен сеанса:

• Android: findAutocompletePredictions()
• iOS: findAutocompletePredictionsFromQuery:
• JavaScript: служба автозаполнения мест Maps JavaScript API
• Веб-сервис: служба автозаполнения мест Places API.

За вызовы, сделанные из недействительного сеанса автозаполнения (например, сеанса, в котором повторно используется токен сеанса), также взимается плата за номер 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)	Свяжитесь с отделом продаж для уточнения оптовых цен.

Пример

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

Андроид

• 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 отображается в отчетах о платежах, но не на странице «Оплата» > «Цены» в Google Cloud Console.

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

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

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

Запрос сведений о месте генерирует SKU данных ( Базовый , Контакт и/или Атмосфера ) — в зависимости от полей, указанных в запросе.

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

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

ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за СЕАНС)
0–100 000	100 001–500 000	500 000+
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 долларов США)

---

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

За вызовы Place Details взимается следующая плата:

ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за ЗВОНОК)
0–100 000	100 001–500 000	500 000+
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 API JavaScript Карт : метод getPlaces() после того, как пользователь выбирает результат размещения (значок: булавка), *а не* запрос (значок: лупа), как показано здесь:

  

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

• Веб-сервис: Служба Place Details API Places

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

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

Примеры

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

---

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

За вызовы метода findCurrentPlace() (Android) или findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) взимается плата .

ЕЖЕМЕСЯЧНЫЙ ДИАПАЗОН ОБЪЕМА (Цена за ЗВОНОК)
0–100 000	100 001–500 000	500 000+
0,030 доллара США за каждого (30,00 долларов США за 1000)	0,024 доллара США за каждого (24,00 долларов США за 1000)	Свяжитесь с отделом продаж для уточнения оптовых цен.

Вызовы findCurrentPlace() (Android) или findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) также генерируют номера SKU данных ( Basic , Contact и/или Atmосфера ) в зависимости от полей, указанных в вызове. Укажите поля данных, чтобы ограничить ответ только этими полями. Вам выставляется счет за вызов «Найти текущее место», а также за запрошенные данные.

Примеры

1. Вы вызываете findCurrentPlace() (Android) или findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) и указываете только поле ADDRESS . В вашем счете вы увидите следующие SKU (при просмотре счета по SKU ):
   • Найти текущее место (цена от 0,030 долларов США за запрос)
   • Базовые данные (оплачивается по цене 0,00 долларов США)
2. Вы вызываете findCurrentPlace() (Android) или findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) и указываете поле PHONE_NUMBER . В вашем счете вы увидите следующие SKU (при просмотре счета по SKU ):
   • Найти текущее место (цена от 0,030 долларов США за запрос)
   • Контактные данные (цена от 0,003 доллара США за запрос)
3. Вы вызываете findCurrentPlace() (Android) или findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) и указываете поля из всех трех сегментов типов данных. В вашем счете вы увидите следующие SKU (при просмотре счета по SKU ):
   • Найти текущее место (цена от 0,030 долларов США за запрос)
   • Базовые данные (оплачивается по цене 0,00 долларов США)
   • Контактные данные (цена от 0,003 доллара США за запрос)
   • Данные об атмосфере (цена от 0,005 долларов США за запрос)

---

Артикул: Разместить фото

За номер SKU Place Photo взимается плата за:

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

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

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

---

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

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

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

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

Примечание. Вы можете установить ежедневные оплачиваемые квоты только для оплачиваемых API. Если в вашем проекте не используются оплачиваемые API, вы не сможете установить дневные лимиты.

Чтобы просмотреть или изменить ограничения квот для Places SDK для Android:

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

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

Сопутствующие ресурсы по управлению затратами

• Платформа Google Maps и цены
• Отчетность и мониторинг платформы Google Maps

---

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