Обзор API дорог

Roads API — это служба, которая принимает HTTPS-запросы с координатами широты и долготы для одной или нескольких точек на карте. Он использует эти точки для поиска ближайших сегментов дороги и возвращает идентификатор места вместе с метаданными, такими как ближайший сегмент дороги и ограничения скорости.

Зачем использовать API дорог

С помощью Roads API вы можете получить ограничения скорости, расчетное время прибытия или другие метаданные о дорогах. С помощью этих дорожных метаданных вы можете улучшить свои приложения для вождения, добавив следующие возможности:

  • Соедините координаты широты/долготы с дорогой или дорогами.
  • Найти ближайшую дорогу для набора координат
  • Получить ограничения скорости для участков дороги

Что вы можете делать с Roads API

С помощью Roads API вы можете сопоставлять GPS-координаты с геометрией дороги и определять ограничение скорости на участках дороги.

  • Привязка к дорогам Эта служба возвращает наиболее вероятные пройденные дороги на основе предоставленного набора GPS-координат. Вы можете указать до 100 точек GPS, собранных на маршруте. При желании вы также можете запросить, чтобы служба интерполировала дополнительные точки, в результате чего путь плавно повторяет геометрию дороги.
  • Ближайшие дороги Эта служба возвращает ближайший сегмент дороги для точки GPS. Вы можете указать до 100 точек GPS. Указанные вами точки не обязательно должны быть частью непрерывного пути.
  • Ограничения скорости Эта служба возвращает опубликованное ограничение скорости для сегмента дороги. Услуга «Ограничение скорости» доступна для всех клиентов с лицензией на отслеживание активов. Для клиентов плана Premium платформы Google Карт , которые перешли на оплату по факту использования, эта функция остается активной.

Как работает API дорог

API дорог использует три конечные точки, которые принимают координаты широты и долготы или идентификаторы мест для предоставления дорожных путей, сегментов или данных об ограничении скорости. В следующем примере показан запрос ближайших дорог на основе набора координат широты/долготы:

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 из маршрута. Включает привязанные к дороге координаты долготы и широты вместе с идентификаторами мест. См. подробности в разделе «Ответы» в руководстве «Привязка к дорогам» .

  • JSON
Ближайшие дороги

Массив до 100 независимых координат широты/долготы вместе с идентификаторами ближайшей дороги для каждой указанной точки. Точки не должны быть непрерывными. Подробнее см. в разделе «Ответы» руководства «Ближайшие дороги» .

Ограничение скорости

Массив до 100 элементов метаданных дороги. Они содержат ограничения скорости и идентификаторы мест с единицами измерения в км/ч или милях в час. См. подробности в разделе «Ответы» в руководстве по ограничениям скорости .

Как использовать API дорог

1 Попробуйте демонстрацию привязки к дорогам Нажмите на демонстрацию, чтобы создать трек и посмотреть, как привязка к конечной точке дорог обеспечивает плавные данные. См . демонстрацию в руководстве по привязке к дорогам . Вам не нужен ключ API.
2 Настроить Начните с настройки проекта Google Cloud и выполните следующие инструкции по настройке, а затем узнайте , как использовать ключ API .
3 Попробуйте привязку к запросу дорог Используйте один из примеров привязки к дорогам и попробуйте тот, который соответствует вашему варианту использования.
4 Получите ограничения скорости для вашего дорожного пути Используя те же данные о пути, которые вы предоставили для запроса привязки к дорогам, выполните запрос ограничения скорости. См. пример запроса с использованием пути .
5 Узнайте, как обрабатывать длинные пути Следуйте разделам Обработка длинных путей в Руководстве по дополнительным понятиям .
6 Включите дорожные данные в свое собственное приложение! См. подробный пример кода из демонстрации Road snapped, чтобы приступить к встраиванию функциональности дорожных данных в собственное приложение.

Доступные клиентские библиотеки

Вызовите этот API на выбранном вами языке через одну из следующих клиентских библиотек:

Клиент Java, клиент Python, клиент Go и клиент Node.js для сервисов Google Maps — это поддерживаемые сообществом клиентские библиотеки с открытым исходным кодом в соответствии с лицензией Apache 2.0 . Загрузите их с GitHub, где вы также можете найти инструкции по установке и примеры кода.

Что дальше