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