Обзор

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

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

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

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

Что вы можете делать с Places API

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

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

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

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

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

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

Ресурсы

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

Ресурсы данных Данные возвращены Формат возврата
Место поиска Возвращает список мест на основе местоположения устройства или строки поиска.

См. подробные сведения об ответах на поиск мест , ответах на поиск поблизости и ответах на текстовый поиск .

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

Подробнее см. в ответах с информацией о месте .

  • JSON
  • XML
Разместить фотографии Предоставляет доступ к миллионам фотографий, связанных с местами, хранящихся в базе данных Google Place.

Подробнее см. в ответе на фото места .

  • JSON
  • XML
Разместить автозаполнение Автоматически заполняет название и/или адрес места по мере ввода пользователем.

Подробнее об ответах автозаполнения места .

  • JSON
  • XML
Автозаполнение запросов Предоставляет службу прогнозирования запросов для текстового географического поиска, возвращая предлагаемые запросы по мере ввода пользователем.

См. подробные сведения об ответах автозаполнения запросов .

  • JSON
  • XML

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

Приведенные ниже шаги охватывают типичный сценарий использования трех конечных точек в службе API Places. По мере создания решения вы можете использовать дополнительные конечные точки, такие как «Поиск поблизости», «Поместить фотографии» и «Автозаполнение запросов».
1 Получить настройку Начните с настройки проекта Google Cloud и выполните следующие инструкции по настройке, а затем узнайте , как использовать ключ API .
2 Попробуйте обычный текстовый поиск Получив ключ API, выполните простой текстовый поиск, как показано в разделе «Примеры базового текстового поиска» в руководстве по текстовому поиску .
3 Используйте запрос «Найти место» Запросы «Найти место» возвращают идентификатор места вместе с запрашиваемыми полями данных, такими как часы работы, адрес и фотографии. См. примеры Find Place и попробуйте еще один, соответствующий вашему варианту использования.
4 Понимание основ ответа «Найти место» Изучите данные, возвращенные ответом «Найти место». Дополнительные сведения см. в разделе Поиск ответов о месте .
5 Чтобы узнать подробности, используйте идентификатор места. Ответы «Найти место» не предоставляют всех данных, доступных для конкретного места. Вы можете использовать идентификатор места, полученный из ответа «Найти место», чтобы получить дополнительные сведения о месте. См. сведения о месте .

Доступные клиентские библиотеки

Вызовите этот API на выбранном вами языке через одну из следующих клиентских библиотек:

Клиент Java, клиент Python, клиент Go и клиент Node.js для сервисов Google Maps — это поддерживаемые сообществом клиентские библиотеки с открытым исходным кодом в соответствии с лицензией Apache 2.0 . Загрузите их с GitHub, где вы также можете найти инструкции по установке и примеры кода.

Что дальше