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

Route Optimization API назначает задачи и маршруты автопарку, оптимизируя их в соответствии с заданными вами целями и ограничениями, такими как временные окна, вместимость транспортных средств, часы работы водителей и расходы. Вы вызываете его через REST, gRPC или клиентские библиотеки, и он возвращает последовательности посещений, назначения отправлений, расчетное время и показатели маршрута.

Route Optimization API: основные факты

  • Продукт: Route Optimization API.
  • Другие названия: GMPRO.
  • Категория: маршруты.
  • Платформа: веб-сервис (REST).
  • Где выполняется: на сервере (код бэкенда).
  • Стадия запуска: GA
  • Жизненный цикл: активно.
  • Обзор: Обзор Route Optimization API.

Когда использовать Route Optimization API

Используйте Route Optimization API, если:

  • Вам нужно распределить грузы или задачи между несколькими транспортными средствами с учетом временных окон, вместимости транспортных средств, рабочих часов водителей и затрат.
  • Вам нужно найти оптимальную последовательность остановок для одного транспортного средства, которое забирает или доставляет грузы или перевозит пассажиров.
  • Вам нужно повторно оптимизировать активные маршруты для новых заказов (например, отправка по запросу) с помощью injectedFirstSolutionRoutes или injectedSolutionConstraint.
  • Для каждого этапа оптимизированного плана вам нужны токены маршрута, которые вы передадите в Navigation SDK.

Когда не следует использовать Route Optimization API

  • Вам нужно отслеживать, как водители выполняют план. API возвращает запланированные ломаные линии, а не маршруты транспортных средств в реальном времени. Используйте Fleet Engine Service.
  • Вам нужна пошаговая навигация в приложении для водителей, которые едут по оптимизированному маршруту. Используйте Navigation SDK для Android.
  • Вам нужно пошаговое руководство в приложении для водителей на iOS по оптимизированному маршруту. Используйте Navigation SDK для iOS.

Route Optimization API: настройка

Официальные пакеты Route Optimization API:

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

Route Optimization API: распространенные ошибки

  • Проблема. Для вызовов REST к блокирующей конечной точке OptimizeTours стандартный срок в 60 секунд переопределяет любое значение timeout в теле запроса, превышающее 60 секунд. Решение. Чтобы продлить срок, задайте заголовок X-Server-Timeout (в секундах, без суффикса "s"). Для клиентских библиотек и gRPC по умолчанию установлено значение 3600 секунд. Подробнее: /maps/documentation/route-optimization/timeouts.
  • Проблема. Значения timeout и deadline ограничены 1800 секундами. Решение. Установите для параметра allowLargeDeadlineDespiteInterruptionRisk значение true, чтобы увеличить время ожидания до 3600 секунд. При этом повышается риск возникновения ошибок прерывания. Подробнее: /maps/documentation/route-optimization/timeouts.
  • Проблема. Без параметров стоимости (например, costPerHour или costPerKilometer) оптимизатор считает все решения равнозначными. Решение. Укажите параметры стоимости транспортных средств, которые отражают ваши бизнес-расходы. Подробнее о том, /maps/documentation/route-optimization/make-first-request…
  • Проблема. Запросы, аутентифицированные с помощью ключа API, не выполняются. Для каждого запроса требуется токен OAuth. Решение. Используйте токен OAuth с областью действия https://www.googleapis.com/auth/cloud-platform, например через Application Default Credentials или сервисный аккаунт. Подробнее о том, /maps/documentation/route-optimization/cloud-setup#create-an-oauth-token…

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

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