Краткий справочник по Routes API

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 API:

  • npm: @googlemaps/routing
  • pypi: google-maps-routing
  • go: cloud.google.com/go/maps
  • maven: com.google.maps:google-maps-routing

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

Ниже приведены ссылки на руководства по каждой задаче. Вы также можете сравнить возможности продуктов в Обзоре возможностей.