Новый API-интерфейс Places включает в себя следующие API:
Этот документ содержит обзор этих новых API.
API сведений о месте
Идентификатор места уникально идентифицирует место в базе данных Google Адресов и на Картах Google. Имея идентификатор места, вы можете запросить подробную информацию о конкретном заведении или достопримечательности, инициировав запрос сведений о месте (новое) . Запрос «Сведения о месте (новое)» возвращает исчерпывающую информацию об указанном месте, такую как его полный адрес, номер телефона, рейтинг пользователей и отзывы.
Есть много способов получить идентификатор места. Вы можете использовать:
- Текстовый поиск (новинка)
- Поиск поблизости (новинка)
- API геокодирования
- API маршрутов
- API проверки адреса
- Разместить автозаполнение
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 | Варианты оплаты, которые принимает место. Место может принимать более одного варианта оплаты. Если данные о способе оплаты недоступны, поле варианта оплаты будет не заполнено. Опции включают следующее:
|
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 | В отеле Place имеется парковка, оборудованная для гостей на инвалидных креслах. |
wheelchairAccessibleEntrance | Место имеет вход, доступный для инвалидных колясок. |
wheelchairAccessibleRestroom | В отеле есть туалет, оборудованный для гостей на инвалидных колясках. |
wheelchairAccessibleSeating | Место имеет места для гостей на инвалидных колясках. |
Переход на API новых адресов
Если вы уже являетесь клиентом Places API и хотите перенести свое приложение для использования новых API, ознакомьтесь со следующей документацией по миграции: