Обзор API дорог

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

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

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

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

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

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

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

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

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

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

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

Что дальше