Отслеживание маршрута

Маршрут отслеживается между параметрами 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 часов после окончания временного окна самого позднего заказа.

Отслеживание продлевается автоматически, если:

1. max_route_finish_prolongation_h > 0.

2. Выполняется хотя бы одно из следующих условий:

   • в маршруте есть недоставленный заказ;
   • курьер находится в радиусе заказа на маршруте;
   • в конце маршрута есть непосещенный склад или заказ с типом garage.

Параметр max_route_finish_prolongation_h ограничивает время, на которое маршрут можно автоматически продлевать. Время продления может быть задано в интервале от 0 до 168 часов (7 суток). По умолчанию max_route_finish_prolongation_h равно 0. Изменить значение можно через техподдержку.