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