Введение
Places API – это сервис, который принимает HTTP-запросы данных о местоположении с помощью различных методов. Он возвращает отформатированные данные о местоположении и изображения организаций, географических местоположений или известных достопримечательностей.Зачем использовать Places API (новый)
Создавайте функции, использующие данные о местоположении, чтобы предоставлять пользователям подробную информацию о местах. Данные, доступные через Places API (новая версия), основаны на одной из самых точных, актуальных и полных моделей реального мира. Вот несколько примеров использования приложений:
- Показывать объявления об аренде квартир в крупных городах.
- Добавлять информацию о месте в уведомления о статусе доставки или самовывоза.
- Показывать список парков в определенном районе с фотографиями и отзывами пользователей.
- Предоставляйте путешественникам контактную информацию, отзывы и сведения о ценах в заведениях по пути.
Что можно делать с помощью Places API (New)
С помощью новой версии Places API вы можете добавить в свои приложения следующие функции:
- Предоставлять результаты поиска мест по запросам разных типов, например текстовым, поблизости, а также по неясным или категориальным запросам.
- Включите функции автозаполнения для разных типов поиска, например для текстовых или категорийных запросов.
- Уточняйте, какие сведения о месте нужно вернуть, например часы работы, краткое описание, отзывы пользователей и фотографии.
- Добавляйте фотографии высокого качества в места, обслуживаемые вашим приложением.
Многие API платформы Google Карт поддерживают идентификаторы мест, которые однозначно идентифицируют место в базе данных Google Places и на Google Картах. Получить идентификатор места можно разными способами, в том числе с помощью новой версии Places API, а также Geocoding API, Routes API и Address Validation API.
Получив идентификатор места, вы можете использовать Places API (New), чтобы запросить дополнительные сведения о конкретном заведении или объекте инфраструктуры, например полный адрес, номер телефона, среднюю оценку и отзывы.
Как работает Places API (новый)
Places API (новый) принимает запросы в виде стандартного URL с определенной конечной точкой сервиса, например /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
Как использовать Places API (New)
Ниже описан типичный сценарий использования сервиса Places API. По мере разработки решения вы можете использовать дополнительные конечные точки, например поиск поблизости (New) и фотографии мест (New).| 1 | Настройка | Настройте платежные функции, включите Places API (новую версию) и отправьте первый запрос. |
| 2 | Попробуйте простой текстовый поиск | Выполните текстовый поиск с помощью Text Search (New). |
| 3 | Как использовать идентификатор места для получения дополнительной информации | Многие API платформы Google Карт возвращают идентификатор места в ответе. Используйте идентификаторы мест, чтобы получать информацию о местах (новая версия). |
| 4 | Как получить фотографию места | Place Photos (Новое) предоставляет доступ к миллионам фотографий, хранящихся в базе данных Places. Используйте Place Photos (New), чтобы получить доступ к фотографиям места. |