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: настройка
- Сервис, который нужно включить:
routeoptimization.googleapis.com. - Аутентификация: OAuth 2.0, сервисный аккаунт.
- Начало работы: настройка Route Optimization API.
- Документация: документация по Route Optimization API.
- Цены: использование и оплата Route Optimization API.
- Правила: правила Route Optimization API.
- Примечания к выпуску: 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: сопутствующие товары
- Часто используется с: Navigation SDK для Android, Navigation SDK для iOS, Fleet Engine Service, Maps JavaScript API.
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
Ниже приведены ссылки на руководства по каждой задаче. Вы также можете сравнить возможности продуктов в Обзоре возможностей.
- Получите план доставки с несколькими остановками, оптимизированный с учетом заданных ограничений по маршруту, стоимости, грузу и транспортному средству.
- Возвращать время начала и окончания для каждой остановки в оптимизированном плане доставки.
- Возвращает время в пути, задержки, перерывы и время ожидания между остановками в оптимизированном плане доставки.
- Возвращать информацию о загрузке транспортного средства на каждой остановке в оптимизированном плане доставки.
- Возвращает информацию о стоимости каждой доставки в оптимизированном плане.
- Возвращать закодированную ломаную линию для маршрута между каждой остановкой в оптимизированном плане доставки.
- Возвращать токен маршрута навигации для маршрута между каждой остановкой в оптимизированном плане доставки.
- Получайте агрегированные показатели по доставке, транспортным средствам и стоимости для оптимизированного плана доставки.
- Укажите временное окно для плана доставки с несколькими остановками.
- Укажите время начала и окончания доступности и местоположения для каждого транспортного средства в плане доставки с несколькими остановками.
- Укажите временные затраты для каждого транспортного средства в плане доставки с несколькими остановками.
- Укажите параметры модели затрат для плана доставки с несколькими остановками.
- Укажите ограничения по времени получения и доставки для каждой отправки в плане доставки с несколькими остановками.
- Укажите назначения транспортных средств для плана доставки с несколькими остановками.
- Укажите ограничения по загрузке для каждого транспортного средства в плане доставки с несколькими остановками.
- Укажите, нужно ли учитывать информацию о загруженности дорог в реальном времени при планировании доставки с несколькими остановками.
- Пакетная обработка запроса на оптимизацию плана доставки с несколькими остановками и запись ответа в Google Cloud Storage.
- Выделяйте время на парковку перед доставкой.
- Приоритет отдается посещениям, которые можно выполнить одно за другим.
- Избегайте разворотов на маршруте с несколькими остановками. Экспериментальная версия Примечание. Экспериментальная функция. На нее распространяются условия и ограничения, действующие для предварительных версий.
- Оптимизация для достижения заданных целей. Экспериментальная версия Примечание. Экспериментальная функция. На нее распространяются условия и ограничения, действующие для предварительных версий.
- Сначала доставляйте более тяжелые грузы. Экспериментальная версия Примечание. Экспериментальная функция. На нее распространяются условия и ограничения, действующие для предварительных версий.