Зачем использовать 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, а также данные, которые он возвращает.
Ресурсы данных | Данные возвращены | Формат возврата |
---|---|---|
Место поиска | Возвращает список мест на основе местоположения устройства или строки поиска. См. подробные сведения об ответах на поиск мест , ответах на поиск поблизости и ответах на текстовый поиск . |
|
Сведения о месте | Возвращает более подробную информацию о конкретном месте, включая отзывы пользователей. Подробнее см. в ответах с информацией о месте . |
|
Разместить фотографии | Предоставляет доступ к миллионам фотографий, связанных с местами, хранящихся в базе данных Google Place. Подробнее см. в ответе на фото места . |
|
Разместить автозаполнение | Автоматически заполняет название и/или адрес места по мере ввода пользователем. Подробнее об ответах автозаполнения места . |
|
Автозаполнение запросов | Предоставляет службу прогнозирования запросов для текстового географического поиска, возвращая предлагаемые запросы по мере ввода пользователем. См. подробные сведения об ответах автозаполнения запросов . |
|
Как использовать API мест
Приведенные ниже шаги охватывают типичный сценарий использования трех конечных точек в службе API Places. По мере создания решения вы можете использовать дополнительные конечные точки, такие как «Поиск поблизости», «Поместить фотографии» и «Автозаполнение запросов».1 | Получить настройку | Начните с настройки проекта Google Cloud и выполните следующие инструкции по настройке, а затем узнайте , как использовать ключ API . |
2 | Попробуйте обычный текстовый поиск | Получив ключ API, выполните простой текстовый поиск, как показано в разделе «Примеры базового текстового поиска» в руководстве по текстовому поиску . |
3 | Используйте запрос «Найти место» | Запросы «Найти место» возвращают идентификатор места вместе с запрашиваемыми полями данных, такими как часы работы, адрес и фотографии. См. примеры Find Place и попробуйте еще один, соответствующий вашему варианту использования. |
4 | Понимание основ ответа «Найти место» | Изучите данные, возвращенные ответом «Найти место». Дополнительные сведения см. в разделе Поиск ответов о месте . |
5 | Чтобы узнать подробности, используйте идентификатор места. | Ответы «Найти место» не предоставляют всех данных, доступных для конкретного места. Вы можете использовать идентификатор места, полученный из ответа «Найти место», чтобы получить дополнительные сведения о месте. См. сведения о месте . |
Доступные клиентские библиотеки
Вызовите этот API на выбранном вами языке через одну из следующих клиентских библиотек:
- Java-клиент для сервисов Google Maps
- Клиент Python для сервисов Google Maps
- Клиент Go для сервисов Google Maps
- Клиент Node.js для сервисов Google Maps
Клиент Java, клиент Python, клиент Go и клиент Node.js для сервисов Google Maps — это поддерживаемые сообществом клиентские библиотеки с открытым исходным кодом в соответствии с лицензией Apache 2.0 . Загрузите их с GitHub, где вы также можете найти инструкции по установке и примеры кода.
Что дальше
- Начните использовать поиск Places API : перейдите в Place Search .
- Получите ключ API : перейдите к разделу Использование ключей API.