Зачем использовать API дорог
С помощью Roads API вы можете получить ограничения скорости, примерное время прибытия или другие метаданные о дороге. С помощью этих метаданных о дороге вы можете улучшить свои приложения для вождения следующими возможностями:
- Соедините координаты широты и долготы с дорогой или дорогами.
- Найти ближайшую дорогу по набору координат
- Получите ограничения скорости для участков дороги
Что вы можете сделать с помощью Roads API
С помощью Roads API вы можете сопоставить координаты GPS с геометрией дороги и определить ограничение скорости на участках дороги.
- Привязка к дорогам Эта служба возвращает наиболее вероятные дороги, по которым вы проезжали, на основе предоставленного набора координат GPS. Вы можете указать до 100 точек GPS, собранных на маршруте. При желании вы также можете запросить, чтобы сервис интерполировал дополнительные точки, в результате чего путь плавно повторяет геометрию дороги.
- Ближайшие дороги Эта служба возвращает ближайший сегмент дороги для точки GPS. Вы можете указать до 100 точек GPS. Указанные вами точки не обязательно должны быть частью непрерывного пути.
- Ограничения скорости Эта служба возвращает опубликованное ограничение скорости для участка дороги. Услуга «Ограничение скорости» доступна всем клиентам, имеющим лицензию на отслеживание активов. Для клиентов Премиум-плана платформы Google Карт , перешедших на оплату по мере использования, эта функция остается активной.
Как работает API дорог
API Roads использует три конечные точки, которые принимают координаты широты и долготы или идентификаторы мест для предоставления маршрутов дорог, сегментов или данных об ограничении скорости. В следующем примере показан запрос ближайших дорог на основе набора координат широты и долготы:
https://roads.googleapis.com/v1/nearestRoads ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796 &key=YOUR_API_KEY
Ресурсы
В следующей таблице приведены ресурсы, доступные через Roads API, а также данные, которые он возвращает.
Ресурсы данных | Данные возвращены | Формат возврата |
---|---|---|
Привязка к дорогам | Возвращает массив из 100 точек GPS маршрута. Включает координаты долготы и широты, привязанные к дороге, а также идентификаторы мест. Подробности см. в разделе «Ответы» в руководстве «Привязка к дорогам» . |
|
Ближайшие дороги | Массив, содержащий до 100 независимых координат широты и долготы, а также идентификаторы мест для ближайшей дороги для каждой указанной точки. Точки не обязательно должны быть непрерывными. Подробности смотрите в ответах в справочнике по ближайшим дорогам . | |
Ограничения скорости | Массив, содержащий до 100 элементов метаданных о дорогах. Они содержат ограничения скорости и идентификаторы мест с единицами измерения в км/ч или милях в час. Подробности см. в разделе «Ответы» руководства по ограничениям скорости . |
Как использовать API дорог
1 | Попробуйте демо-версию привязки к дорогам | Нажмите на демо-версию, чтобы создать трек и посмотреть, как привязка к конечной точке дороги обеспечивает плавность данных. См. Демонстрацию в руководстве «Привязка к дорогам» . Вам не нужен ключ API. |
2 | Настроить | Начните с настройки проекта Google Cloud и выполните следующие инструкции по настройке, а затем узнайте , как использовать ключ API . |
3 | Попробуйте привязать к запросу дороги | Используйте один из примеров привязки к дорогам и попробуйте тот, который соответствует вашему варианту использования. |
4 | Получите ограничения скорости для вашего пути | Используя те же данные о пути, которые вы предоставили для запроса привязки к дорогам, выполните запрос ограничения скорости. См. пример запроса с использованием пути . |
5 | Узнайте, как обрабатывать длинные пути | Следуйте разделам « Обработка длинных путей» в Руководстве по расширенным концепциям . |
6 | Включите данные о дорогах в свое собственное приложение! | Посмотрите подробный пример кода из демо-версии дороги, чтобы начать встраивать функциональность данных о дорогах в свое собственное приложение. |
Доступные клиентские библиотеки
Вызовите этот API на выбранном вами языке через одну из следующих клиентских библиотек:
- Java-клиент для сервисов Google Maps
- Клиент Python для служб Google Maps
- Клиент Go для сервисов Google Maps
- Клиент Node.js для сервисов Google Maps
Клиент Java, клиент Python, клиент Go и клиент Node.js для служб Google Maps — это клиентские библиотеки, поддерживаемые сообществом, с открытым исходным кодом по лицензии Apache 2.0 . Загрузите их с GitHub, где вы также можете найти инструкции по установке и пример кода.
Что дальше
- Попробуйте Roads API : перейдите в Roads Inspector.
- Узнайте, как отправлять запросы к Roads API . Перейдите к интересующему вас сервису:
- Понимание расширенных концепций : перейдите к разделу «Расширенные концепции».
- Следуйте рекомендациям : перейдите к разделу «Рекомендации по веб-службам».