Обзор API дорог

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

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

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

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

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

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

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

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

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

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

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

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

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

Что дальше?