Файл содержит три листа: Точки, ТС, Разгрузки. Столбцы со звёздочкой (*) обязательны. Скачать готовый шаблон можно на вкладке Данные → Импорт XLSX.
Лист «Точки» — одна строка на контейнерную группу (КГ)
Поле
Тип
Описание
КГ.Код*
строка
Уникальный код КГ. Несколько строк с одним кодом на разных КП — одна группа.
КП.Код*
строка
Код контрольной точки. Несколько КГ могут быть на одном КП.
КП.Адресopt
строка
Текстовый адрес для отображения на карте.
КП.Широта*
число
Широта (WGS-84), например 55.7522
КП.Долгота*
число
Долгота (WGS-84), например 37.6155
КП.Вр.подъезда_с*
сек
Время подъезда к точке от дороги, секунды.
КП.Вр.остановки_с*
сек
Время парковки у точки, секунды.
КП.Окно_сopt
чч:мм
Начало временного окна, например 08:00
КП.Окно_доopt
чч:мм
Конец временного окна, например 18:00
КП.Примечаниеopt
строка
Произвольный комментарий к точке.
КГ.Названиеopt
строка
Название контейнерной группы для отображения.
КГ.Тип_контейнера*
строка
Тип контейнера, например Евроконтейнер, Бункер.
КГ.Кол-во*
целое
Количество контейнеров в группе.
КГ.Объём_м3*
число
Объём одного контейнера, м³.
КГ.Коэфф.заполн*
0–1
Коэффициент заполнения (0.8 = 80%).
КГ.Обслуж_1гр_с*
сек
Время обслуживания 1 грузчиком, секунды.
КГ.Обслуж_2гр_сopt
сек
Время обслуживания 2 грузчиками, секунды.
КГ.Уборка_1гр_с*
сек
Время уборки 1 грузчиком, секунды.
КГ.Уборка_2гр_сopt
сек
Время уборки 2 грузчиками, секунды.
КГ.Типы_ТС*
строка
Допустимые типы ТС через точку с запятой: ГАЗель;КамАЗ
КГ.Виды_отходовopt
строка
Вид отходов: ТКО, КГО и т.д.
Лист «ТС»
Поле
Тип
Описание
Гос.номер*
строка
Государственный номер или идентификатор ТС.
Тип_ТС*
строка
Тип ТС, например ГАЗель, КамАЗ 6520. Используется для сопоставления с допустимыми типами КГ.
Вместимость_м3*
число
Полезная вместимость кузова, м³.
Широта_депо*
число
Широта депо (начало и конец смены).
Долгота_депо*
число
Долгота депо.
Правосторонняя_разгрузкаopt
да / пусто
Манипулятор берёт контейнер правым бортом. Такому ТС расчёт запрещает подъезд к КП с чужой стороны дороги — иначе машине пришлось бы разворачиваться. Пусто = обычная машина. Понимает также yes, true, 1, +.
Лист «Разгрузки»
Поле
Тип
Описание
Код*
строка
Уникальный код точки разгрузки.
Адресopt
строка
Текстовый адрес для отображения.
Широта*
число
Широта точки разгрузки (WGS-84).
Долгота*
число
Долгота точки разгрузки (WGS-84).
Время_обслуж_с*
сек
Время обслуживания на точке (взвешивание, выгрузка), секунды.
Импорт маршрутов и метрик XLSX
XLSX
Файл является одновременно результатом экспорта маршрутов (кнопка «Выгрузить xlsx» на вкладке Маршруты) и может быть повторно загружен для просмотра или редактирования. Каждый лист файла — один маршрут ТС. Лист Метрики при импорте пропускается.
Строка-маркер. Идентификатор ТС, тип, вместимость и дата расчёта. Используется при импорте для восстановления метаданных.
Строка 2
Заголовки
Имена столбцов (см. таблицу ниже).
Строки 3+
Данные
Одна строка на контейнерную группу (КГ). Несколько КГ одного КП идут подряд с теми же временны́ми полями.
Столбцы данных
Столбец
Заголовок
Описание
A
№
Порядковый номер остановки на маршруте.
B
Код КП
Код контрольной точки (КП). Для депо и разгрузок — пусто.
C
Код КГ
Код контейнерной группы. Несколько КГ одного КП — отдельные строки с одинаковым номером остановки.
D
Адрес
Текстовый адрес точки.
E
Широта
Широта (WGS-84), 6 знаков.
F
Долгота
Долгота (WGS-84), 6 знаков.
G
Тип контейнера
Тип контейнера КГ, например Евроконтейнер.
H
Кол-во
Количество контейнеров в КГ.
I
Объём, м³
Объём одного контейнера, м³.
J
График
Расписание вывоза, произвольная строка.
K
Спрос, л
Спрос по КГ в литрах (объём × кол-во × коэфф. заполнения).
L
Прибытие
Время прибытия на точку, формат ЧЧ:ММ. При импорте пересчитывается в ISO UTC (часовой пояс Москва UTC+3).
M
Убытие
Время отправления с точки, формат ЧЧ:ММ.
N
Вид
Тип строки: старт — выезд из депо, финиш — возврат, разгрузка — точка разгрузки, пусто — клиентская точка.
Поведение при импорте
Ситуация
Поведение
Лист без маркера ТС в A1
Лист пропускается с предупреждением.
Лист Метрики
Всегда пропускается.
Строки с одинаковым Кодом КП подряд
Группируются в одну остановку; КГ добавляются в subpoints.
Строки старт / финиш
Формируют депо (первый и последний элемент маршрута).
Строка разгрузка
Проставляет _kind: unload на сырой остановке — это один из трёх способов определения разгрузки (см. ниже).
Время в колонках L/M
Конвертируется из местного времени (UTC+3) в ISO UTC с использованием даты из маркера A1.
Результат маршрутизации JSON
JSON
Загружается через кнопку на вкладке Маршруты или по Task ID. Корневой объект может содержать поля result или data — они разворачиваются автоматически.
courier_routes — маршруты ТС
Объект вида { "ИД_ТС": [ остановки ] }. Первый элемент — выезд из депо, последний — возврат, остальные — точки обслуживания и разгрузки.
Поле остановки
Тип
Описание
id
строка
Идентификатор точки из source.points. Для разгрузок содержит слово unload.
lat / lon
число
Координаты остановки.
address
строка
Текстовый адрес.
time_in
ISO 8601
Время прибытия на точку.
time_out
ISO 8601
Время отправления с точки.
demand
число
Объём груза на точке, м³.
load
число
Накопленная загрузка ТС после обслуживания точки.
shift
объект
Только для первого/последнего элемента. Содержит shift.start.location / shift.end.location с полями lat, lon, address.
source — исходные данные задачи
Ключ
Тип
Описание
source.points
массив
Все точки задачи (подробнее — в таблице ниже).
source.vehicles
массив
ТС: id, type, capacity / volume, service_time_type (one_loader / two_loaders), right_side_unload (правосторонняя разгрузка — влияет и на расчёт, и на замер проезда в симуляторе).
source.unload_points
массив
Точки разгрузки: id, lat, lon, address, service_time (сек).
source.points — поля точки
Поле
Тип
Описание
id
строка
Уникальный идентификатор точки (КП).
lat / lon
число
Координаты (WGS-84).
address
строка
Текстовый адрес.
cp_code
строка
Код КП из исходного XLSX.
subpoints
массив
КГ на этой точке. Поля: id, container_type, count, volume, fill_ratio, service_time.