Результат планирования
На странице с полученным решением:
- В верхнем правом углу нажмите Экспортировать.
- Выберите Решение в Excel.
https://yandex.ru/courier/companies/<company_id>/depots/all/mvrp/<task_id>/export/excel, где:
-
<company_id>— идентификатор компании, который можно найти в разделе Настройки → Компания → Идентификатор компании. -
<task_id>—idзадачи.
Результат выгрузки можно использовать для анализа или загрузки в другую систему. Учитывайте, что состав и порядок столбцов в файле могут меняться.
В Excel-файле с результатами есть несколько листов:
- Маршруты
- Расширенные маршруты
- Метрики
Информация с листа Маршруты полностью дублируется на листе Расширенные маршруты, поэтому дальше будет описываться только лист Расширенные маршруты, где вы найдете больше информации.
Расширенные маршруты
На листе Расширенные маршруты содержится информация о маршрутах, запланированных для автомобилей или курьеров.
Маршрут — это список точек, которые нужно посетить в определенном порядке, чтобы выполнить все заказы. На листе точки располагаются в запланированной очередности сверху вниз от первой к последней. Маршруты отделяются друг от друга пустой строкой.
Для одного автомобиля или курьера может быть запланировано несколько смен и несколько рейсов (в том числе несколько рейсов внутри одной смены). Это зависит от настроек компании или склада.
Поля на листе Расширенные маршруты можно условно объединить в несколько групп:
Параметры заказа
- Номер заказа (
refв API) - Адрес клиента (
description) - Комментарий (
comments) - Телефон клиента (
phone) - Клиент (
title) - Время прибытия на заказ/склад (
arrival_time) - Время отправления (
departure_time) - Суммарное время на заказ (
total_service_duration) - Время обслуживания на адрес (
shared_service_duration) - Время обслуживания на заказ, с (
service_duration_s) - Время обслуживания адреса, с (
total_service_duration_s) - Время обслуживания на адрес, с (
shared_service_duration_s) - Время прибытия, с (
arrival_time_s) - Время отправления, c (
departure_time_s)
Параметры автомобиля и смены курьера
- Идентификатор машины (
vehicle_refв API) - Смена (
shift_time_window) - ID машины (
vehicle_id) - ID смены (
shift_id) - Способ передвижения (
routing_mode) - Номер GPS‑трекера (
vehicle_imei) - Пользовательские единицы измерения (
shipment_size_custom) - Пользовательские единицы измерения вместимости (
vehicle_capacity_custom) - Свойства машины (
vehicle_tags) - Требования к машине (
required_tags) - Опциональные теги (
optional_tags)
Информация о маршруте и точках маршрута
- Номер рейса (
run_numberв API) - Номер остановки (
stopIndex) - Тип точки (
location_type) - Длительность перерыва (
break_duration) - Интервал доставки/время работы склада (
time_window) - Жёсткое временное окно (
hard_time_window) - Время обслуживания на заказ (
service_duration) - Время в пути до заказа (
transit_duration) - Время пребывания заказа в автомобиле (
on_board_duration_s) - Длина пути до точки, км (
transit_distance_km) - Время ожидания начала интервала (
waiting_duration) - Тип опоздания (
failed_time_window_how) - Длительность опоздания (
failed_time_window_duration) - Грузоподъёмность машины, кг (
vehicle_capacity_weight_kg) - Вместимость машины, мест (
vehicle_capacity_units) - Вес заказа, кг (
shipment_size_weight_kg) - Размер заказа, мест (
shipment_size_units) - Объём заказа, м³ (
shipment_size_volume_cbm) - Загруженные заказы (
picked_orders) - ID точки (
id) - Длина пути до точки, м (
transit_distance_m) - Длительность перерыва, c (
break_duration_s) - Время в пути, с (
transit_duration_s) - Время ожидания, с (
waiting_duration_s) - Широта (
point_lat) - Долгота (
point_lon) - Зоны (
zones) - Исключённые зоны (
avoid_zones)
Описание параметров вы найдете в описании листов Orders и Vehicles для файла планирования.
Метрики
Данные листа Метрики используют для анализа эффективности планирования и построения более точных маршрутов.
Метрики рассчитываются как для всех маршрутов вместе (столбец Все машины), так и для каждого маршрута ТС по отдельности.
Их можно условно разделить на несколько групп:
- Общие метрики решения (общее количество автомобилей или курьеров, заказов, нераспределенных заказов).
- Информация об автомобилях или курьерах и сменах (идентификаторы, временные окна смен).
- Утилизация ТС (загруженность по весу, объему, юнитам).
- Информация о маршруте (время начала и окончания, пробег, общее время маршрута, время движения и ожидания на маршруте).
- Информация о нарушении временных окон (заказов, смен).
- Информация о стоимости маршрута (стоимость для алгоритма, штрафы алгоритма).
Популярные метрики
Чаще всего при анализе маршрутов смотрят на следующие метрики:
used_vehicles— количество задействованных автомобилей или курьеров.dropped_locations_count— количество нераспределенных заказов.failed_time_window_locations_count/total_failed_time_window_duration— количество нарушений временного окна/суммарное время нарушения временных окон.orders_count– количество заказов в маршруте.weight_perc/units_perc/volume_perc– утилизация транспорта по весу, количеству мест, объему.total_transit_distance_km— длина маршрута в километрах.
Сценарии использования
Геозоны
Если в планировании используются ограничения по геозонам, в выгруженном файле Excel с решением на листе Расширенные маршруты вы найдете дополнительный столбец zones. В нем указываются геозоны, в которые попадает заказ.