Обзор API дорог

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

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

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

  • Соедините координаты широты и долготы с дорогой или дорогами.
  • Найдите ближайшую дорогу для заданных координат.
  • Узнайте ограничения скорости на участках дорог.

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

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

  • Функция «Привязка к дорогам » возвращает наиболее вероятные маршруты, пройденные по заданному набору GPS-координат. Вы можете указать до 100 GPS-точек, собранных вдоль маршрута. При желании вы также можете запросить интерполяцию дополнительных точек, в результате чего будет построен маршрут, плавно повторяющий геометрию дороги.
  • Ближайшие дороги. Эта служба возвращает ближайший участок дороги для точки GPS. Вы можете указать до 100 точек GPS. Указанные точки не обязательно должны быть частью непрерывного маршрута.
  • Ограничения скорости. Эта услуга возвращает установленное ограничение скорости для участка дороги. Услуга «Ограничения скорости» доступна всем клиентам с лицензией на отслеживание активов. Для клиентов 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 элементов метаданных о дорогах. Эти элементы включают ограничения скорости и идентификаторы мест, с единицами измерения в км/ч или милях в час. Подробности см. в разделе «Ответы» в руководстве по ограничениям скорости .

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

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

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

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

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

Что дальше?