API оптимизации маршрутов
routeOptimizer API — API оптимизации маршрутов для парков из нескольких машин. Вы отправляете точки и машины одним запросом и получаете оптимизированные маршруты: какая машина какую точку объезжает, в каком порядке, с расстоянием и длительностью. API учитывает вместимость, временные окна, пары «забор — доставка» и дорожные ограничения, поэтому маршруты последней мили планируются автоматически из вашей ERP или CRM.
Все инструменты для успешной оптимизации последней мили
Routing API
Значительно ускоряет планирование доставки, управление зонами и маршрутами и повышает эффективность использования транспорта. Количество адресов и ограничений больше не имеет значения: система сразу формирует и предлагает самые оптимальные и точные маршруты из всех возможных вариантов.
Distance Matrix API
Быстро рассчитывает расстояние, время в пути и ETA между точками отправления и назначения. Можно задать тысячи точек одновременно. Система учитывает тип транспорта и его технические ограничения, перевозимый груз, а также маршрут, дорожную инфраструктуру и возможные задержки.
Geocoding API
Преобразует координаты широты и долготы, а также названия мест в адрес или почтовый индекс и обратно.
Поддерживает Google, OpenStreetMap и национальные API геокодирования.
Ограничения при планировании маршрутов
Ограничения маршрута
- Длительность и расстояние
- Несколько рейсов (маршрутов) на машину
- Автоматическое распределение заказов с оптимизацией маршрута
- Ограничение расстояния между точками
- Приоритет по типу товара
- Ограничения по зонам/полигонам
Ограничения транспорта
- Классификация
- Настройка скорости
- Несколько типов вместимости
- Стоимость использования и обслуживания
- Габариты и вес груза
- Ограничение по числу и типу остановок
Ограничения по времени
- Рабочие часы и перерывы персонала
- Окна забора и доставки
- Максимальный простой на остановке
Ограничения остановок
- Мягкие и абсолютные приоритеты
- Время обслуживания
- Классификация остановок
- Списки допустимых машин
- Окна забора / доставки
- Контроль последовательности забора / доставки
Маршрут
- Длительность и расстояние
- Несколько рейсов (маршрутов) на машину
- Автоматическое распределение заказов с оптимизацией маршрута
Транспорт
- Классификация, настройка скорости, вместимость, стоимость использования и обслуживания
- Габариты и вес груза
Время
- Рабочие часы и смены персонала
- Окна забора и доставки
- Максимальный простой на остановке
Остановка
- Мягкие и абсолютные приоритеты
- Время обслуживания
- Классификация
- Списки допустимых машин
- Окна забора / доставки
- Контроль последовательности забора / доставки
Как работает routeOptimizer API?
- Авторизуйтесь. Вызовите
POST /login, чтобы получить cookie сессии, и передавайте его в каждом следующем запросе. - Отправьте точки и машины. Вызовите
POST /optimizationsс массивом points (координаты, груз и время обслуживания) и массивом vehicles (вместимость и необязательные ограничения). Точка 0 — склад, если у машины не заданы свои начало и конец. - Получите маршруты. Ответ распределяет точки по машинам и задаёт порядок объезда на каждом маршруте с расстоянием, длительностью и временем прибытия. Точки, которые нельзя обслужить, возвращаются как нераспределённые.
- При необходимости скорректируйте. Меняйте порядок точек, переносите точки между машинами, возвращайте выпавшие точки в план, исключайте участки дорог или зоны и добавляйте свои метаданные.
Пример запроса
POST /optimizations
{
"response_format": "v2",
"capacity_measurement_type": "volume",
"search_time_limit": 15,
"vehicles": [
{ "id": 1, "capacity": { "general": 6 } },
{ "id": 2, "capacity": { "general": 6 } }
],
"points": [
{ "id": 0, "la": 59.444701, "lo": 24.723633 },
{ "id": 1, "volume": 3, "la": 59.438947, "lo": 24.711118, "st": 900 },
{ "id": 2, "volume": 3, "la": 59.444348, "lo": 24.713008, "st": 1800 }
]
}Пример ответа (сокращённый)
{
"code": 200,
"data": {
"id": 1502,
"result_body": {
"routes": [
{
"veh_id": 1,
"num": 2,
"duration": 3198,
"leg_rings": [[
{ "from": 0, "to": 1, "duration": 243.1,
"time": { "min": "2025-02-09 08:04:03" } },
{ "from": 1, "to": 2, "duration": 106,
"time": { "min": "2025-02-09 08:20:49" } }
]]
}
]
}
}
}Какие ограничения поддерживает API?
Вместимость машины по весу, объёму или штукам, в том числе по отсекам; временные окна клиентов; пары «забор — доставка» с забором до доставки; лимиты визитов к типам клиентов на машину; приоритеты точек; дорожные ограничения через исключённые участки или полигоны.
Есть ли лимиты?
На демо-аккаунте — до 50 точек в одном запросе. По промышленным объёмам свяжитесь с нами.
Где полная документация?
Все эндпоинты, схемы и примеры — в документации routeOptimizer API. Чтобы попробовать на своих данных, запросите демо. Сравниваете платформы? Посмотрите City & Carrier и Route4Me.