Зачем использовать Places API
Создайте функции определения местоположения, чтобы сделать подробные данные о местоположении доступными для ваших пользователей. Данные, доступные через Places API, основаны на одной из самых точных, актуальных и полных моделей мест реального мира. Вот примеры вариантов использования приложений:
- Показывайте аренду квартир в крупных мегаполисах с результатами, ориентированными конкретно на города.
- Включите информацию о месте в обновление статуса самовывоза или доставки.
- Отобразите список парков в районе вместе с фотографиями и отзывами, отправленными пользователями.
- Предоставьте людям, планирующим поездки, контактную информацию, отзывы и уровень цен на заведения по пути.
Что можно сделать с помощью Places API
Вы можете использовать Places API, чтобы включить в свои приложения следующие функции:
- Предоставление результатов поиска мест по различным типам запросов пользователей, таких как ввод текста, близлежащие местоположения, а также неоднозначные или категориальные запросы пользователей.
- Включите функции автозаполнения для различных типов поиска: конкретных текстовых запросов или категориальных запросов.
- Уточните тип возвращаемой информации о месте, например часы работы, сводку, отзывы пользователей и фотографии.
- Добавляйте высококачественные фотографии в места, обслуживаемые вашим приложением.
Многие API платформы Google Maps поддерживают идентификаторы мест , где идентификатор места уникальным образом идентифицирует место в базе данных Google Адресов и на Картах Google. Существует множество способов получить идентификатор места, в том числе из Places API, а также из API геокодирования , API маршрутов и API проверки адреса .
Получив идентификатор места, вы можете использовать Places API, чтобы запросить более подробную информацию о конкретном заведении или достопримечательности, например полный адрес, номер телефона, рейтинг пользователей и отзывы.
Как работает Places API (новый)
API Places (новый) принимает запросы в виде стандартного URL-адреса с определенной конечной точкой службы, например /places илиplaces places:searchText , и возвращает ответ в формате JSON. Places API (новый) поддерживает авторизацию по ключу API и токену OAuth. В следующем примере выполняется запрос Place Details (New) для возврата компонентов адреса для идентификатора места с использованием ключа API:
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key= YOUR_API_KEY
Как использовать API мест
Приведенные ниже шаги описывают типичный сценарий использования службы Places API. При разработке решения вы можете использовать дополнительные конечные точки, такие как «Поиск поблизости» (новое) и «Разместить фотографию» (новое).| 1 | Настроить | Начните с настройки проекта Google Cloud и выполните следующие инструкции по настройке, а затем узнайте , как использовать ключ API . |
| 2 | Попробуйте простой текстовый поиск | Выполните текстовый поиск с помощью Text Search (New) . |
| 3 | Используйте идентификатор места для получения более подробной информации. | Многие API платформы Google Карт возвращают идентификатор места как часть ответа. Используйте идентификаторы мест, чтобы получить подробную информацию о месте (новинка) . |
| 4 | Получить фотографию места | Сервис Place Photo (New) предоставляет вам доступ к миллионам фотографий, хранящихся в базе данных Places. Используйте «Фото места (новое)» для доступа к фотографиям места. |