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

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