Об API мест (новое)

API Places (новый) включает следующие API:

• Детали места (новое)
• Разместить фото (новое)
• Поиск поблизости (новинка)
• Текстовый поиск (новинка)
• Автозаполнение (новое)

Этот документ содержит обзор этих новых API.

Детали места (новое)

Идентификатор места уникально идентифицирует место в базе данных Google Адресов и на Картах Google. Имея идентификатор места, вы можете запросить подробную информацию о конкретном заведении или достопримечательности, инициировав запрос сведений о месте (новое) . Запрос «Сведения о месте (новое)» возвращает исчерпывающую информацию об указанном месте, такую ​​как его полный адрес, номер телефона, рейтинг пользователей и отзывы.

Примечание. Вы можете получить ту же информацию о месте с помощью «Сведения о месте» (новое), что и с помощью текстового поиска (новое) или «Поиска поблизости» (новое). Однако если у вас уже есть идентификатор места, вызов Place Details (New) обходится дешевле, чем вызов одного из API поиска.

Есть много способов получить идентификатор места. Вы можете использовать:

• Текстовый поиск (новинка)
• Поиск поблизости (новинка)
• API геокодирования
• API маршрутов
• API проверки адреса
• Разместить автозаполнение

Разместить фото (новое)

API Place Photo (новый) позволяет добавлять в приложение высококачественный фотографический контент, предоставляя доступ к миллионам фотографий, хранящихся в базе данных Google Places. Используя API Place Photo (New), вы можете получить доступ к фотографиям и изменить размер изображения до оптимального размера для вашего приложения.

Все запросы к API Place Photo (New) должны включать имя фоторесурса, которое однозначно идентифицирует возвращаемую фотографию. Вы можете получить название фоторесурса, используя:

• Детали места (новое)
• Текстовый поиск (новинка)
• Поиск поблизости (новинка)

Чтобы включить название фоторесурса в ответ на запрос «Сведения о месте (новый), текстовый поиск (новый)» или «Поиск поблизости (новый), убедитесь, что вы включили поле photos в маску поля запроса.

Текстовый поиск (новинка) и поиск поблизости (новинка)

API Places включает в себя два API поиска:

• Текстовый поиск (новинка)

  Позволяет указать текстовую строку для поиска места. Например: «Острая вегетарианская еда в Сиднее, Австралия» или «Изысканный ресторан из морепродуктов недалеко от Пало-Альто, Калифорния».

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

• Поиск поблизости (новинка)

  Позволяет указать регион для поиска вместе со списком типов мест. Укажите регион в виде круга, определяемого координатами широты и долготы центральной точки и радиусом в метрах.

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

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

Автозаполнение (новое) и токены сеанса

Автозаполнение (новинка) — это веб-служба, которая возвращает прогнозы мест и прогнозы запросов в ответ на HTTP-запрос. В запросе укажите текстовую строку поиска и географические границы, контролирующие область поиска.

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

Новые поля, атрибуты и параметры доступности.

API-интерфейс Places (новый) включает новые поля, атрибуты и параметры доступности, позволяющие предоставить пользователям дополнительную информацию о месте. Эти аспекты описаны в следующих разделах.

Поля

API Places (новый) включает несколько новых полей:

Поле	Описание
regularSecondaryOpeningHours	Описывает определенное время для определенных операций. Второстепенные часы работы отличаются от основных часов работы предприятия. Например, ресторан может указать часы работы в пути или часы доставки в качестве второстепенных часов.
paymentOptions	Варианты оплаты, которые принимает место. Место может принимать более одного варианта оплаты. Если данные о способе оплаты недоступны, поле варианта оплаты будет не заполнено. Опции включают следующее: Кредитная карта Дебетовая карта Принимаем только наличные NFC-платеж
parkingOptions	Варианты парковки предусмотрены местом. Опции включают следующее: Бесплатные парковки Платные парковки Бесплатная уличная парковка Услуги парковщика Бесплатная парковка в гараже Платная парковка в гараже
subDestinations	Уникальные места, связанные с конкретным местом. Например, терминалы аэропорта считаются подпунктами назначения аэропорта.
fuelOptions	Самая последняя информация о вариантах топлива, доступных на заправочных станциях. Эта информация регулярно обновляется. Опции включают следующее: Дизель Обычный неэтилированный Средний класс Премиум СП91 СП91 Е10 СП92 СП95 Е10 СП98 СП99 СП100 сжиженный нефтяной газ Е80 Е85 Метан Биодизель Грузовой дизель
evChargeOptions	Количество зарядных устройств для электромобилей (EV) на этой станции. Хотя некоторые зарядные устройства для электромобилей имеют несколько разъемов, каждое зарядное устройство может одновременно заряжать только один автомобиль; в результате это поле отражает количество доступных зарядных устройств для электромобилей в данный момент.
shortFormattedAddress	Короткий, удобочитаемый адрес места.
primaryType	Основной тип данного результата. Например, место можно классифицировать как cafe или airport . Место может иметь только один основной тип. Полный список возможных значений см. в разделе Поддерживаемые типы .
primaryTypeDisplayName	Отображаемое имя основного типа, локализованное на язык запроса, если применимо. Полный список возможных значений см. в разделе Поддерживаемые типы .

Атрибуты

API Places (новый) включает несколько новых атрибутов:

Атрибут	Описание
outdoorSeating	Место обеспечивает размещение на открытом воздухе.
liveMusic	Место обеспечивает живую музыку.
menuForChildren	В заведении есть детское меню.
servesCocktails	Место предлагает коктейли.
servesDessert	Место предлагает десерт.
servesCoffee	Место подают кофе.
goodForChildren	Место хорошее для детей.
allowsDogs	Место позволяет собакам.
restroom	В отеле есть туалет.
goodForGroups	Место подходит для групп.
goodForWatchingSports	Место подходит для просмотра спортивных состязаний.

Параметры доступности

API Places (новый) включает следующие поля параметров специальных возможностей:

Поле	Описание
wheelchairAccessibleParking	В отеле Place имеется парковка, оборудованная для гостей на инвалидных креслах.
wheelchairAccessibleEntrance	Место имеет вход, доступный для инвалидных колясок.
wheelchairAccessibleRestroom	В отеле есть туалет, оборудованный для гостей на инвалидных колясках.
wheelchairAccessibleSeating	Место имеет места для гостей на инвалидных колясках.

Резюме на основе искусственного интеллекта

Places API (новый) Сводки на основе искусственного интеллекта используют возможности модели Gemini для возврата сводок о местах и ​​областях, которые могут помочь пользователям решить, куда идти.

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

Примечание. Все сводки на основе искусственного интеллекта, отображаемые в вашем приложении, должны сопровождаться соответствующим указанием авторства в соответствии с политиками и стандартами Google. Дополнительную информацию см. в разделе Политики для Places API .

В Places API добавлены функции искусственного интеллекта (новинка)

Сводки на основе искусственного интеллекта поддерживаются функциями «Сведения о месте» (новинка) , «Текстовый поиск» (новинка) и «Поиск поблизости» (новинка) . Следующие сводки на основе искусственного интеллекта доступны в ответах API Places (новое):

• Сводки мест – это краткие обзорные сводки, относящиеся к конкретному месту.
• Краткое изложение отзывов – это удобочитаемое изложение того, что рецензенты сказали о месте.
• Краткие сведения о районе , в которых представлены обзоры близлежащих и популярных мест в окрестностях. К ним относятся сводки о районе и сводки о зарядных станциях для электромобилей.

Google часто обновляет эти сводки, чтобы гарантировать их актуальность на основе последней доступной информации. Когда вы делаете запрос к Places API (новый), вы будете отображать самые свежие данные в своем приложении.

Переход на API новых адресов

Если вы уже являетесь клиентом Places API и хотите перенести свое приложение для использования новых API, ознакомьтесь со следующей документацией по миграции:

• Перенос в сведения о месте (новинка)
• Переход на поиск поблизости (новинка)
• Переход на текстовый поиск (новинка)
• Миграция для размещения фотографии (новая версия)
• Переход на автозаполнение (новое)