Обзор Roads API

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

Преимущества Roads API

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

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

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

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

  • Привязка к дорогам. Этот сервис возвращает наиболее вероятные дороги, по которым двигалось транспортное средство, на основе предоставленного набора GPS-координат. Вы можете указать до 100 точек GPS, собранных вдоль маршрута. При необходимости вы также можете запросить, чтобы сервис интерполировал дополнительные точки, в результате чего получится путь, который плавно следует геометрии дороги.
  • Nearest Roads. Этот сервис возвращает ближайший сегмент дороги для точки GPS. Можно указать до 100 точек GPS. Указанные точки не обязательно должны быть частью непрерывного пути.
  • Ограничения скорости. Этот сервис возвращает установленное ограничение скорости для сегмента дороги. Сервис Speed Limit доступен всем клиентам с лицензией на отслеживание объектов. Для клиентов с планом Premium платформы 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 независимых координат (широта/долгота) и идентификаторы мест для ближайшей дороги для каждой указанной точки. Точки не обязательно должны быть непрерывными. Подробную информацию вы найдете в разделе Ответы руководства по Nearest Roads API.
Ограничения скорости

Массив, содержащий до 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, где также опубликованы образцы кода и инструкции по установке.

Дальнейшие действия