О новом Places API

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

Введение

Новая версия Places API включает следующие API:

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

Place Details (New)

Идентификатор места однозначно идентифицирует его в базе данных Google Places и на Google Картах. Используя идентификатор места, вы можете запросить информацию об определенном заведении или объекте инфраструктуры, отправив запрос Place Details (New). Запрос "информация о местах (новая версия)" возвращает подробную информацию об указанном месте, например полный адрес, номер телефона, средняя оценка и отзывы пользователей.

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

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

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

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

Чтобы включить название ресурса фотографии в ответ на запрос информации о местах (New), текстового поиска (New) или поиска поблизости (New), убедитесь, что в маске полей запроса указано поле photos.

Новые версии текстового поиска и поиска поблизости

В Places API (новинка) есть два API для поиска:

  • Text Search (New)

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

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

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

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

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

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

Новая версия Autocomplete и токены сеанса

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

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

Новые поля, атрибуты и параметры специальных возможностей

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

Поля

В Places API (новый) добавлено несколько новых полей:

Поле Описание
regularSecondaryOpeningHours Описывает определенное время для определенных операций. Дополнительные часы работы отличаются от основных. Например, ресторан может указать часы работы окна выдачи заказов или доставки в качестве дополнительных.
paymentOptions Способы оплаты, которые принимаются в этом месте. В одном месте может быть доступно несколько способов оплаты. Если данные о способе оплаты недоступны, поле "Способ оплаты" будет пустым. Вот некоторые из них:
  • Кредитная карта
  • Дебетовая карта
  • Только наличные
  • оплата через NFC
parkingOptions Варианты парковки, предлагаемые заведением. Вот некоторые из них:
  • Бесплатная парковка
  • Платные парковки
  • Бесплатная уличная парковка
  • Услуги парковщика
  • Бесплатная крытая парковка
  • Платная крытая парковка
subDestinations Уникальные места, связанные с определенным местом. Например, терминалы аэропорта считаются подпунктами назначения аэропорта.
fuelOptions Актуальная информация о видах топлива, доступных на заправке. Информация регулярно обновляется. Доступны следующие варианты:
  • Дизель
  • Обычный неэтилированный
  • Среднее
  • Премиум
  • SP91
  • SP91 E10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • СУГ
  • E80
  • E85
  • Метан
  • Биодизельное топливо
  • Дизельное топливо для грузовиков
evChargeOptions Количество зарядных устройств для электромобилей на этой станции. Некоторые устройства для зарядки ЭМ имеют несколько коннекторов, но каждое из них может заряжать только один автомобиль за раз. Таким образом, это поле отражает количество доступных устройств для зарядки ЭМ в данный момент времени.
shortFormattedAddress Краткий человекочитаемый адрес места.
primaryType Основной тип результата. Например, место может быть классифицировано как cafe или airport. У места может быть только один основной тип. Полный список возможных значений приведен в разделе Поддерживаемые типы.
primaryTypeDisplayName Отображаемое название основного типа, локализованное на язык запроса, если применимо. Полный список возможных значений приведен в разделе Поддерживаемые типы.
entrances Входы в пункт назначения. Вход – это пара координат широты и долготы, определяющая местоположение точки входа и выхода для места.
navigationPoints Точки навигации для пункта назначения. Точка навигации – это место рядом с дорогой, где может заканчиваться навигация, включая поддерживаемые способы передвижения и варианты использования.

Атрибуты

В Places API (New) добавлены следующие атрибуты:

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

Параметры специальных возможностей

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

Поле Описание
wheelchairAccessibleParking В этом месте есть парковка, доступная для инвалидов-колясочников.
wheelchairAccessibleEntrance Вход доступен для инвалидов-колясочников.
wheelchairAccessibleRestroom В заведении есть туалет, доступный для инвалидов-колясочников.
wheelchairAccessibleSeating В заведении есть места, доступные для инвалидов-колясочников.

Краткий пересказ от ИИ

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

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

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

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

  • Описания мест – краткие обзоры, связанные с определенным местом.
  • Пересказы отзывов – краткие описания того, что пользователи говорят о месте.
  • Сводки по районам, в которых приводится информация о популярных местах и достопримечательностях поблизости. Это, например, краткие описания районов и станций зарядки электромобилей.

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

Переход на Places API (новый)

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