Зачем использовать 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: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 . Для API Places (новое) вы также можете использовать токены OAuth . |
| 2 | Попробуйте простой текстовый поиск | Выполните простой текстовый поиск с помощью текстового поиска (новое) или текстового поиска . |
| 3 | Используйте идентификатор места для получения более подробной информации. | Многие API платформы Google Карт возвращают идентификатор места как часть ответа. Используйте идентификатор места, чтобы получить подробную информацию о месте. См. «Сведения о месте (новое)» и «Сведения о месте» . |
| 4 | Получить фотографию места | Сервис Place Photo предоставляет вам доступ к миллионам фотографий, хранящихся в базе данных Places. Используйте «Фото места (новое)» или «Сведения о месте» , чтобы получить доступ к фотографиям места. |