Обзор API дорог

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

Зачем использовать Roads API

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

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

Что можно сделать с помощью Roads API

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

  • Snap to Roads Эта служба возвращает наиболее вероятные пройденные дороги на основе предоставленного набора GPS-координат. Вы можете указать до 100 точек GPS, собранных по маршруту. При желании вы также можете запросить, чтобы служба интерполировала дополнительные точки, в результате чего путь будет плавно следовать геометрии дороги.
  • Nearest Roads Эта служба возвращает ближайший сегмент дороги для точки GPS. Вы можете указать до 100 точек GPS. Указанные вами точки не обязательно должны быть частью непрерывного пути.
  • Ограничения скорости Эта служба возвращает опубликованное ограничение скорости для участка дороги. Служба ограничения скорости доступна всем клиентам с лицензией Asset Tracking. Для клиентов Google Maps Platform Premium Plan, которые перешли на оплату по мере использования, функция остается активной.

Как работает Roads API

Roads 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 элементов метаданных дорог. Они содержат ограничения скорости и идентификаторы мест с единицами измерения KPH или MPH. Подробности см. в разделе Ответы в руководстве по ограничениям скорости .

Как использовать Roads API

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

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

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

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

Что дальше?