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

Разработчики из Европейской экономической зоны (ЕЭЗ)

Введение

Новый API для работы с местами включает следующие API:

В этом документе представлен обзор новых API.

Подробная информация о месте (новое)

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

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

Фотографии мест (новые)

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

Все запросы к API «Разместить фотографии (новый)» должны содержать имя ресурса фотографии, которое однозначно идентифицирует возвращаемую фотографию. Имя ресурса фотографии можно получить следующим образом:

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

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

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

  • Поиск текста (новая функция)

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

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

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

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

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

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

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

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

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

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

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

Поля

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

Поле Описание
regularSecondaryOpeningHours Указывается конкретное время работы для определенных операций. Дополнительные часы работы отличаются от основных часов работы предприятия. Например, ресторан может указать часы работы автокассы или часы доставки в качестве дополнительных часов работы.
paymentOptions Доступные способы оплаты. Заведение может принимать несколько способов оплаты. Если данные о способах оплаты недоступны, поле «Способ оплаты» будет пустым. Доступные способы оплаты:
  • Кредитная карта
  • Дебетовая карта
  • Принимаем только наличные
  • Оплата NFC
parkingOptions На территории предусмотрены различные варианты парковки. Варианты включают следующее:
  • Бесплатные парковки
  • Платные парковки
  • Бесплатная парковка на улице
  • Парковка с услугами парковщика
  • Бесплатная парковка в гараже
  • Платная парковка в гараже
subDestinations Уникальные места, связанные с конкретным местом. Например, терминалы аэропортов считаются подпунктами назначения аэропорта.
fuelOptions Самая актуальная информация о вариантах топлива, доступных на автозаправочной станции. Эта информация регулярно обновляется. Варианты включают следующее:
  • Дизель
  • Обычный неэтилированный бензин
  • Средний уровень
  • Премиум
  • СП91
  • СП91 Е10
  • СП92
  • СП95 Е10
  • СП98
  • СП99
  • СП100
  • Сжиженный газ
  • E80
  • E85
  • Метан
  • Биодизель
  • Грузовой дизель
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 добавлены функции, использующие искусственный интеллект (новое).

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

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

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

Переход на новые API для работы с данными о местах

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