Об API новых мест

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

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

API сведений о месте

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

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

API размещения фотографий

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

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

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

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

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

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

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

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

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

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

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

API автозаполнения и токены сеанса

API автозаполнения (новый) — это веб-служба, которая возвращает прогнозы мест и прогнозы запросов в ответ на 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 Место имеет места для гостей на инвалидных колясках.

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

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