Routes API – это веб-сервис с двумя методами: Compute Routes возвращает маршрут между двумя местоположениями с необязательными промежуточными путевыми точками, а Compute Route Matrix возвращает расстояние и время в пути для комбинаций пунктов отправления и назначения (до 625 элементов маршрута).
Routes API: основные факты
- Продукт: Routes API.
- Другие названия: Routes API v2, Compute Routes, Compute Route Matrix.
- Категория: маршруты.
- Платформа: веб-сервис (REST).
- Где выполняется: на сервере (код бэкенда).
- Стадия запуска: GA
- Жизненный цикл: активно.
- Обзор: обзор Routes API.
- Регионы: все страны. Маршруты для двухколесного транспорта, экологичные маршруты и расчет платы за проезд доступны только в поддерживаемых странах и городах. Зависимые территории с собственным кодом CLDR не поддерживаются, если они не указаны в списке. Для платежных адресов в Европейской экономической зоне (ЕЭЗ) условия ЕЭЗ, приведенные на странице https://developers.google.com/maps/comms/eea/routes, запрещают использовать описания маршрутов или шаги с любой картой. (подробнее о покрытии)
Когда использовать Routes API
Используйте Routes API, если:
- Вам нужно проложить маршрут между пунктами отправления и назначения, возможно, с промежуточными точками, для автомобиля, пешехода, велосипеда, двухколесного транспортного средства или общественного транспорта.
- Вам нужно получить расстояния и время в пути для множества пар пунктов отправления и назначения в одном запросе (до 625 элементов).
- Вам нужны расчеты платы за проезд (в некоторых городах), экологичные маршруты (в некоторых регионах), ломаные линии с учетом трафика или маршруты для крупногабаритного транспорта (доступно не везде).
- Вы переносите серверное приложение с устаревшего Directions API или Distance Matrix API.
Когда не следует использовать Routes API
- Вам нужно оптимизировать распределение грузов и порядок остановок для всего автопарка. Используйте Route Optimization API.
- Вам нужна пошаговая навигация в приложении на Android, которая следует по рассчитанному маршруту. Используйте Navigation SDK для Android.
- Вам нужна пошаговая навигация в приложении на iOS, которая следует по рассчитанному маршруту. Используйте Navigation SDK для iOS.
Routes API: настройка
- Сервис, который нужно включить:
routes.googleapis.com. - Аутентификация: ключ API, OAuth 2.0, сервисный аккаунт.
- Начало работы: настройка Routes API
- Справочная информация: документация по Routes API.
- Цены: Статистика использования и оплата Routes API.
- Правила: правила Routes API.
- Примечания к выпуску: Примечания к выпуску Routes API
Официальные пакеты Routes API:
- npm:
@googlemaps/routing - pypi:
google-maps-routing - go:
cloud.google.com/go/maps - maven:
com.google.maps:google-maps-routing
Routes API: сопутствующие товары
- Заменяет: Directions API, Distance Matrix API.
- Часто используется с: Navigation SDK для Android, Navigation SDK для iOS, Route Optimization API, Geocoding API, Places API (New).
Routes API: распространенные ошибки
- Проблема. Нет списка возвращаемых полей по умолчанию. Запросы без маски полей (заголовок
X-Goog-FieldMaskили параметр$fields) возвращают ошибку. Решение. Всегда отправляйте маску полей, в которой перечислены нужные вам поля ответа. Подробнее: /maps/documentation/routes/choose_fields. - Проблема. Использование маски поля с подстановочным знаком (
*) в рабочей среде увеличивает стоимость и задержку, а стоимость может неожиданно возрасти по мере добавления в ответ новых расширенных функций. Решение. Используйте*только во время разработки. В рабочей среде запрашивайте только нужные поля. Подробнее: /maps/documentation/routes/choose_fields. - Проблема. Информация о платных дорогах и расходе топлива не возвращается, если просто добавить ее в маску поля. С момента общей доступности ее нужно включать явным образом. Решение. Добавьте в запрос массив
extraComputations(например,TOLLS,FUEL_CONSUMPTION) в дополнение к маске поля. Подробнее: /maps/documentation/routes/migrate-routes-preview. - Проблема. Compute Route Matrix позволяет использовать 625 элементов, но только 100 элементов, если
routingPreference– этоTRAFFIC_AWARE_OPTIMAL. Решение. При использованииTRAFFIC_AWARE_OPTIMALследите за тем, чтобы количество пунктов отправления, умноженное на количество пунктов назначения, не превышало 100. Также можно разделить запрос. Подробнее: /maps/documentation/routes/compute_route_matrix.
Что можно делать с помощью Routes API
Ниже приведены ссылки на руководства по каждой задаче. Вы также можете сравнить возможности продуктов в Обзоре возможностей.
- Возвращает маршруты между двумя или более точками с заданными координатами широты и долготы в виде серии координат для каждого шага на маршруте.
- Возвращает маршруты между двумя или более наборами координат широты и долготы в виде серии описаний маневров для шагов на маршруте.
- Возвращает расстояние между каждым шагом на маршруте между двумя или более наборами координат широты и долготы.
- Возвращать время в пути между каждым шагом на маршруте между двумя или более наборами координат широты и долготы.
- Возвращает закодированную ломаную линию между каждым шагом на маршруте между двумя или более наборами координат широты и долготы.
- Возвращает расстояние для маршрута между двумя или более наборами координат широты и долготы.
- Возвращает время в пути для маршрута между двумя или более наборами координат широты и долготы.
- Возвращает закодированную ломаную линию для маршрута между двумя или более наборами координат широты и долготы.
- Возвращать информацию о платных дорогах на маршруте между двумя или более наборами координат широты и долготы.
- Укажите способ передвижения (на автомобиле, общественном транспорте, пешком или на двухколесном транспортном средстве) для запроса маршрута. Примечание. В веб-сервисе Routes API (computeRoutes) передайте travelMode в теле JSON HTTP POST, используя RouteTravelMode (DRIVE, BICYCLE, TWO_WHEELER, WALK, TRANSIT или TRUCK с routeModifiers.vehicleInfo), и включите обязательный заголовок X-Goog-FieldMask вместо устаревшего параметра запроса режима GET. В библиотеке Routes в Maps JavaScript API передайте travelMode и поля в ComputeRoutesRequest.
- Укажите остановку или промежуточную точку для запроса маршрута.
- Укажите, как данные о трафике используются в запросе маршрута.
- Укажите, какие объекты, например шоссе или платные дороги, следует исключить из маршрута.
- Задайте путевые точки на маршруте.
- Задавать промежуточные путевые точки на маршруте.
- Задайте точку, через которую должен проходить маршрут.
- Укажите направление движения и сторону дороги для маршрута.
- Оптимизируйте порядок остановок на маршруте.
- Укажите экологичный маршрут в запросе маршрутов. Предварительный просмотр
- Укажите более короткое расстояние или альтернативный маршрут для запроса маршрутов. Примечание. В Routes API запрос более короткого маршрута (SHORTER_DISTANCE) – это экспериментальная функция, а запрос альтернативных маршрутов (computeAlternativeRoutes) – общедоступная.
- Возвращает расстояния для матрицы маршрутов между несколькими пунктами отправления и назначения.
- Возвращает время в пути для матрицы маршрутов между несколькими пунктами отправления и назначения.
- Получайте информацию о платных дорогах для матрицы маршрутов между несколькими пунктами отправления и назначения.
- Укажите способ передвижения (на автомобиле, общественном транспорте, пешком, на двухколесном транспортном средстве) для запроса матрицы маршрутов. Примечание. В веб-сервисе Routes API (computeRouteMatrix) передайте travelMode в теле HTTP POST JSON, используя RouteTravelMode (DRIVE, TWO_WHEELER, WALK, TRANSIT или TRUCK с origins[].routeModifiers.vehicleInfo; BICYCLE не поддерживается для матриц маршрутов), и включите обязательный заголовок X-Goog-FieldMask. В библиотеке Routes Maps JavaScript API передайте travelMode и поля в ComputeRouteMatrixRequest.