Отслеживание маршрута
Маршрут отслеживается между параметрами route_start
и route_finish
. Полученный трек движения курьера и время прохождения контрольных точек маршрута вы найдете в интерфейсе (подробнее см. в разделах Местонахождение курьера в определенное время и Информация о работе курьера).
Параметры отслеживания
- route_start
-
Время начала маршрута относительно
date
, в формате[d.]HH:MM:SS
.Со значением параметра также связаны появление уведомления shift_start и SMS при старте маршрута.
Пример вычисления параметра
Вы планируете маршрут на 01.12.2021 и указываете значение
route_start
:5:00:00
— отслеживание начнется в 5 часов утра 01.12.2021;1.5:00:00
— отслеживание начнется в 5 часов утра 02.12.2021.
- route_finish
-
Время окончания маршрута относительно
date
, в формате[d.]HH:MM:SS
.Пример вычисления параметра
Вы планируете маршрут на 01.12.2021 и указываете значение
route_finish
:18:00:00
— отслеживание закончится в 6 часов вечера 01.12.2021;1.18:00:00
— отслеживание закончится в 6 часов вечера 02.12.2021.
При вычислении параметров учитывается часовой пояс склада. Например, если время начала маршрута
route_start = 5:00:00
, а часовой пояс склада time_zone равенAsia/Novosibirsk
, то отслеживание начнется в 5 утра по времени Новосибирска, или в час ночи по времени Москвы.Параметры
route_start
иroute_finish
являются необязательными. Они описаны в разделе Ресурсы API.Совет
Рекомендуем указывать явно время начала
route_start
и время окончанияroute_finish
маршрута.
Начало отслеживания
При работе через API момент начала отслеживания зависит от того, задан или нет параметр route_start
маршрута.
- route_start задан
-
Примечание
Если на маршруте нет заказов и не указан
route_finish
, то маршрут считается неактивным, и отслеживание не начнется. Добавьте заказы заранее или укажитеroute_finish
.Отслеживание начнется сразу или за некоторое время до времени начала маршрута
route_start
. Сдвиг отслеживания относительно времени начала маршрута указывается в параметреtracking_start_h
, который задается в часах:-
для маршрута.
-
для компании (используется, если значение для маршрута не задано).
По умолчанию сдвиг отслеживания
tracking_start_h
для компании равен1
. Изменить значение можно через техподдержку.
Подробнее о параметре
tracking_start_h
см. в разделе Ресурсы API. -
- route_start не задан
-
Отслеживание начнется за 5 часов до начала окна самого раннего заказа.
При работе с интерфейсом начало отслеживания
route_start
маршрута зависит от способа загрузки задачи в Мониторинг. - Планирование в интерфейсе и экспорт в Мониторинг
-
Время начала маршрута
route_start
соответствует времени выезда автомобиля со склада.Пример
Условия задачи вручную внесены в интерфейс Рабочего места логиста, где и решается задача по построению маршрута. Затем маршрут экспортируется в Мониторинг.
В интерфейсе Рабочего места логиста на странице маршрута отражено, что Установленное время старта равно
9:26
, когда автомобиль выехал со склада. - Импорт готового маршрута из Excel в Мониторинг
-
Время начала маршрута
route_start
соответствует времени начала смены.Пример
В Мониторинг загружен файл Excel с подготовленными заранее маршрутами (лист Routes). При этом на листе Vehicles в столбце Время начала и конца смены для значения параметра
shifts.0.time_window
указано, что смена начинается в02:00
.В интерфейсе Рабочего места логиста на странице маршрута отражено, что Установленное время старта равно
02:00
.
Конец отслеживания
Момент окончания записи трека зависит от параметра route_finish
маршрута.
- route_finish задан
-
Отслеживание закончится во время, указанное в параметре
route_finish
маршрута. - route_finish не задан
-
Отслеживание закончится через 5 часов после конца окна самого позднего заказа.
Доступность маршрута в приложении
- route_finish задан
-
После наступления времени
route_finish
открытый маршрут закроется, и курьер не сможет войти в маршрут. - route_finish не задан
-
Маршрут перестанет быть доступен в приложении, если выполняется одно из условий:
- прошло больше 5 часов после окончания временного окна самого позднего заказа;
- закончилось время автоматического продления отслеживания.
Автоматическое продление отслеживания
В некоторых ситуациях необходимо продолжать отслеживать маршрут, даже если время route_finish
уже наступило или прошло больше 5 часов после окончания временного окна самого позднего заказа.
Отслеживание продлевается автоматически, если:
-
max_route_finish_prolongation_h
> 0. -
Выполняется хотя бы одно из следующих условий:
- в маршруте есть недоставленный заказ;
- курьер находится в радиусе заказа на маршруте;
- в конце маршрута есть непосещенный склад или заказ с типом
garage
.
Параметр max_route_finish_prolongation_h
ограничивает время, на которое маршрут можно автоматически продлевать. Время продления может быть задано в интервале от 0 до 168 часов (7 суток). По умолчанию max_route_finish_prolongation_h
равно 0
. Изменить значение можно через техподдержку.
Примечание
При изменении времени окончания route_finish
маршрута продление будет работать после достижения нового значения.