О новом Places API

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

Введение

В Places API (новый) входят следующие API:

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

Place Details (New)

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

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

Place Photos (New)

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

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

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

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

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

  • Text Search (New)

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

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

  • Поиск мест рядом (новый)

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

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

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

Autocomplete (New) и токены сеансов

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

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

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

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

Поля

В Places API (New) есть несколько новых полей:

Поле Описание
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 (New) включает следующие поля специальных возможностей:

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

Краткие пересказы на основе искусственного интеллекта

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

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

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

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

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

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

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

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