Введение
API Places (новый) включает в себя следующие API:
- Подробности места (новые)
- Фотографии места (новые)
- Поиск поблизости (новый)
- Текстовый поиск (новый)
- Автозаполнение (Новое)
В этом документе содержится обзор этих новых API.
Подробности места (новые)
Идентификатор места однозначно идентифицирует место в базе данных Google Places и на Google Maps. С помощью идентификатора места вы можете запросить сведения о конкретном заведении или точке интереса, инициировав запрос Place Details (New) . Запрос Place Details (New) возвращает исчерпывающую информацию об указанном месте, такую как его полный адрес, номер телефона, рейтинг пользователя и отзывы.
Есть много способов получить идентификатор места. Вы можете использовать:
- Текстовый поиск (новый)
- Поиск поблизости (новый)
- API геокодирования
- API маршрутов
- API проверки адреса
- Автозаполнение (Новое)
Фотографии места (новые)
Place Photos (New) позволяет вам добавлять высококачественный фотографический контент в ваше приложение, предоставляя вам доступ к миллионам фотографий, хранящихся в базе данных Google Places. Используя API Place Photos (New), вы можете получить доступ к фотографиям и изменить размер изображения до оптимального для вашего приложения.
Все запросы к API Place Photos (New) должны включать имя фоторесурса, которое однозначно идентифицирует возвращаемую фотографию. Вы можете получить имя фоторесурса, используя:
Чтобы включить название фоторесурса в ответ на запрос «Сведения о месте (новый)», «Текстовый поиск (новый)» или «Поиск поблизости (новый)», обязательно включите поле photos в маску поля запроса.
Текстовый поиск (новый) и поиск поблизости (новый)
API Places включает два поисковых API:
Позволяет указать текстовую строку, по которой следует искать место. Например: «Острая вегетарианская еда в Сиднее, Австралия» или «Изысканные блюда из морепродуктов недалеко от Пало-Альто, Калифорния».
Вы можете уточнить поиск, указав такие данные, как уровни цен, текущий статус открытия, рейтинги или определенные типы мест. Вы также можете указать, чтобы сместить результаты к определенному местоположению или ограничить поиск определенным местоположением.
Позволяет указать регион для поиска вместе со списком типов мест. Укажите регион как круг, определяемый координатами широты и долготы центральной точки и радиусом в метрах.
Укажите один или несколько типов мест, которые определяют характеристики места. Например, укажите "
pizza_restaurant" и "shopping_mall" для поиска пиццерии, расположенной в торговом центре в указанном регионе.
Основное различие между этими двумя поисками заключается в том, что текстовый поиск (новый) позволяет указать произвольную строку поиска, тогда как поиск поблизости (новый) требует указания определенной области, в которой будет выполняться поиск.
Автозаполнение (новое) и токены сеанса
Autocomplete (New) — это веб-сервис, который возвращает прогнозы мест и запросов в ответ на HTTP-запрос. В запросе укажите строку текстового поиска и географические границы, которые управляют областью поиска.
Токены сеанса — это строки, сгенерированные пользователем, которые отслеживают вызовы Autocomplete (New) как сеансы. Autocomplete (New) использует токены сеанса для группировки фаз запроса и выбора поиска пользователя с автозаполнением в отдельный сеанс для выставления счетов.
Новые поля, атрибуты и параметры доступности
API Places (новый) включает новые поля, атрибуты и параметры доступности, чтобы предоставить пользователям больше информации о месте. Эти аспекты описаны в следующих разделах.
Поля
API Places (новый) включает несколько новых полей:
| Поле | Описание |
|---|---|
regularSecondaryOpeningHours | Описывает конкретное время для определенных операций. Вторичные часы работы отличаются от основных часов работы предприятия. Например, ресторан может указать часы работы автосервиса или часы доставки в качестве дополнительных часов. |
paymentOptions | Варианты оплаты, которые принимает место. Место может принимать более одного варианта оплаты. Если данные о варианте оплаты недоступны, поле варианта оплаты будет не установлено. Варианты включают в себя следующее:
|
parkingOptions | Варианты парковки, предоставляемые местом. Варианты включают следующее:
|
subDestinations | Уникальные места, которые связаны с определенным местом. Например, терминалы аэропорта считаются подпунктами назначения аэропорта. |
fuelOptions | Самая последняя информация о вариантах топлива, доступных на заправочной станции. Эта информация регулярно обновляется. Варианты включают следующее:
|
evChargeOptions | Количество зарядных устройств для электромобилей (EV) на этой станции. Хотя некоторые зарядные устройства для электромобилей имеют несколько разъемов, каждое зарядное устройство может заряжать только одно транспортное средство одновременно; в результате это поле отражает количество доступных зарядных устройств для электромобилей в данный момент времени. |
shortFormattedAddress | Короткий, понятный человеку адрес места. |
primaryType | Основной тип данного результата. Например, место может быть классифицировано как cafe или airport . Место может иметь только один основной тип. Полный список возможных значений см. в разделе Поддерживаемые типы . |
primaryTypeDisplayName | Отображаемое имя основного типа, локализованное на языке запроса, если применимо. Полный список возможных значений см. в разделе Поддерживаемые типы . |
Атрибуты
API Places (новый) включает несколько новых атрибутов:
| Атрибут | Описание |
|---|---|
outdoorSeating | Место располагает местами для сидения на открытом воздухе. |
liveMusic | Здесь играет живая музыка. |
menuForChildren | В заведении есть детское меню. |
servesCocktails | Здесь подают коктейли. |
servesDessert | Здесь подают десерт. |
servesCoffee | Здесь подают кофе. |
goodForChildren | Место хорошо подходит для детей. |
allowsDogs | Место допускает собак. |
restroom | В этом месте есть туалет. |
goodForGroups | Место рассчитано на группы. |
goodForWatchingSports | Место подходит для просмотра спортивных состязаний. |
Параметры доступности
API Places (новый) включает следующие поля параметров доступности:
| Поле | Описание |
|---|---|
wheelchairAccessibleParking | Место предлагает парковку, доступную для инвалидных колясок. |
wheelchairAccessibleEntrance | В помещении имеется вход, доступный для инвалидных колясок. |
wheelchairAccessibleRestroom | В помещении имеется туалет, доступный для инвалидных колясок. |
wheelchairAccessibleSeating | В помещении имеются места для сидения, подходящие для инвалидных колясок. |
Резюме на основе искусственного интеллекта
API мест (новый) Сводки на основе искусственного интеллекта используют возможности модели Gemini для возврата сводок о местах и областях, которые могут помочь пользователям решить, куда пойти.
Резюме на основе ИИ синтезирует данные из различных источников, чтобы помочь пользователям принимать более обоснованные решения о месте. Например, если вы подумываете о том, чтобы посетить новый ресторан, резюме на основе ИИ может вывести на экран общие основные моменты меню, дать вам представление о его атмосфере или собрать воедино темы из отзывов пользователей. Если вы посещаете новый город, резюме на основе ИИ может предоставить обзор близлежащих достопримечательностей и удобств.
В API Places добавлены функции на основе искусственного интеллекта (новое)
Сводки на основе ИИ поддерживаются Place Details (New) , Text Search (New) и Nearby Search (New) . Следующие сводки на основе ИИ доступны в ответах Places API (New):
- Краткие обзоры мест , представляющие собой краткие обзоры, относящиеся к определенному месту.
- Резюме отзывов , представляющее собой удобоваримое изложение того, что сказали рецензенты о каком-либо месте.
- Сводки по районам , которые предоставляют обзоры близлежащих и популярных мест в окрестностях. Они включают сводки по районам и сводки по зарядным станциям для электромобилей.
Google часто регенерирует эти сводки, чтобы гарантировать их актуальность на основе последней доступной информации. Когда вы делаете запрос API Places (New), вы отобразите самые свежие данные в своем приложении.
Переход на новые API Places
Если вы являетесь существующим клиентом API Places (новый) и хотите перенести свое приложение для использования новых API, ознакомьтесь со следующей документацией по миграции:
- Перейти к сведениям о месте (новое)
- Переход на ближайший поиск (новый)
- Переход на текстовый поиск (новый)
- Перенести в Place Photos (новое)
- Переход на автозаполнение (новое)