Обзор

Выберите платформу: Android iOS Веб-служба JavaScript
Places API — это служба, которая принимает HTTP-запросы на данные о местоположении различными методами. Он возвращает отформатированные данные о местоположении и изображения заведений, географических мест или известных достопримечательностей.

Зачем использовать Places API

Создайте функции определения местоположения, чтобы ваши пользователи могли легко получить подробные данные о местоположении. Данные, доступные через Places API, основаны на одной из самых точных, актуальных и полных моделей мест реального мира. Вот примеры вариантов использования приложений:

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

Что можно сделать с помощью Places API

Вы можете использовать Places API, чтобы включить в свои приложения следующие функции:

  • Предоставление результатов поиска мест по различным типам запросов пользователей, таких как ввод текста, близлежащие местоположения, а также неоднозначные или категориальные запросы пользователей.
  • Включите функции автозаполнения для различных типов поиска: конкретных текстовых запросов или категориальных запросов.
  • Уточните тип возвращаемой информации о месте, например часы работы, сводку, отзывы пользователей и фотографии.
  • Добавляйте высококачественные фотографии в места, обслуживаемые вашим приложением.

Многие API платформы Google Maps поддерживают идентификаторы мест , где идентификатор места уникальным образом идентифицирует место в базе данных Google Адресов и на Картах Google. Существует множество способов получить идентификатор места, в том числе из Places API, а также из API геокодирования , API маршрутов и API проверки адреса .

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

Выберите свою версию Places API

Places API поддерживает две версии API: Places API — это существующие API, а Places API (новый) — это версии API следующего поколения.

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

Как работает API Адресов

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

API Places (новый) принимает запросы в виде стандартного URL-адреса с определенной конечной точкой службы, например /places илиplaces places:searchText , и возвращает ответ в формате JSON. Places API (новый) поддерживает авторизацию по ключу API и токену OAuth. В следующем примере выполняется запрос Place Details для возврата компонентов адреса для идентификатора места с использованием ключа API:

https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents&key=YOUR_API_KEY

API мест

API Places принимает запросы в виде стандартного URL-адреса с определенной конечной точкой службы, например /place или /photo . Конечные точки также принимают тип формата, указанный в запросе: JSON или XML. Запрос на обслуживание использует параметры, относящиеся к этой конкретной конечной точке, для уточнения возвращаемых данных. В следующем примере выполняется запрос Place Details для возврата компонентов адреса для идентификатора места в формате JSON:

https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJrTLr-GyuEmsRBfy61i59si0&fields=address_components&key=YOUR_API_KEY

В этом случае служба использует предоставленный идентификатор места, чтобы найти запрошенное место и вернуть компоненты адреса в формате JSON.

Ресурсы

В следующей таблице приведены ресурсы, доступные через Places API.

API мест API мест (новое) Примечание
Найти место Текстовый поиск (новинка) Новой версии Find Place не существует. Текстовый поиск (новый) заменил его.
Поиск поблизости Поиск поблизости (новинка) Все запросы, использующие существующий API, включающие текстовый запрос, должны использовать текстовый поиск (новый), поскольку поиск поблизости (новый) не поддерживает ввод текста.
Текстовый поиск Текстовый поиск (новинка)
Детали места Детали места (новое)
Разместить фото Разместить фото (новое)
Разместить автозаполнение Автозаполнение (новое) В предварительном просмотре
Автозаполнение запроса Автозаполнение (новое) Возможности, добавленные в предварительную версию автозаполнения (новая)

Как использовать API мест

Приведенные ниже шаги описывают типичный сценарий использования службы Places API. При разработке решения вы можете использовать дополнительные конечные точки, такие как поиск поблизости и размещение фотографий.
1 Получить настройку Начните с настройки проекта Google Cloud и выполните следующие инструкции по настройке, а затем узнайте, как использовать ключ API . Для Places API (нового) вы также можете использовать токены OAuth .
2 Попробуйте простой текстовый поиск Выполните простой текстовый поиск с помощью текстового поиска (новое) или текстового поиска .
3 Используйте идентификатор места для получения более подробной информации. Многие API платформы Google Карт возвращают идентификатор места как часть ответа. Используйте идентификатор места, чтобы получить подробную информацию о месте. См. «Сведения о месте (новое)» и «Сведения о месте» .
4 Получить фотографию места Служба Place Photo предоставляет вам доступ к миллионам фотографий, хранящихся в базе данных Places. Используйте «Фото места (новое)» или «Сведения о месте» , чтобы получить доступ к фотографиям места.