--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.kz/routing/doc/en/delivery/functions/tracking.md - https://yandex.kz/routing/doc/kk/delivery/functions/tracking.md - https://yandex.kz/routing/doc/ru/delivery/functions/tracking.md - href: ru/delivery/functions/tracking.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt title: Яндекс Маршрутизация — функции — отслеживание маршрута --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.kz/routing/doc/ru/llms.txt # Отслеживание маршрута Маршрут отслеживается между параметрами `route_start` и `route_finish`. Полученный трек движения курьера и время прохождения контрольных точек маршрута вы найдете в интерфейсе (подробнее см. в разделах [Местонахождение курьера в определенное время](https://yandex.kz/routing/doc/ru/delivery/interface/couriers.md#location) и [Информация о работе курьера](https://yandex.kz/routing/doc/ru/delivery/interface/couriers.md#info)). ## Параметры отслеживания {#params} **route_start** : Время начала маршрута относительно `date`, в формате `[d.]HH:MM:SS`. Со значением параметра также связаны [появление уведомления shift_start](https://yandex.kz/routing/doc/ru/delivery/faq.md) и [SMS при старте маршрута](https://yandex.kz/routing/doc/ru/extras/sms-setting.md#sms-start). {% cut "Пример вычисления параметра" %} Вы планируете маршрут на  01.12.2021 и указываете значение `route_start`: - `5:00:00` — отслеживание начнется в 5 часов утра 01.12.2021; - `1.5:00:00` — отслеживание начнется в 5 часов утра 02.12.2021. {% endcut %} **route_finish** : Время окончания маршрута относительно `date`, в формате `[d.]HH:MM:SS`. {% cut "Пример вычисления параметра" %} Вы планируете маршрут на  01.12.2021 и указываете значение `route_finish`: - `18:00:00` — отслеживание закончится в 6 часов вечера 01.12.2021; - `1.18:00:00` — отслеживание закончится в 6 часов вечера 02.12.2021. {% endcut %} При вычислении параметров учитывается [часовой пояс](https://yandex.kz/routing/doc/ru/vrp/date-time-zone.md#time-zone) склада. Например, если время начала маршрута `route_start = 5:00:00`, а часовой пояс склада time_zone равен `Asia/Novosibirsk`, то отслеживание начнется в 5 утра по времени Новосибирска, или в час ночи по времени Москвы. Параметры `route_start` и `route_finish` являются необязательными. Они описаны в разделе [Ресурсы API](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/addsARoute). {% note tip %} Рекомендуем указывать явно время начала `route_start` и время окончания `route_finish` маршрута. {% endnote %} ## Начало отслеживания {#start-tracking} При работе через API момент начала отслеживания зависит от того, задан или нет параметр `route_start` маршрута. **route_start задан** : {% note info %} Если на маршруте нет заказов и не указан `route_finish`, то маршрут считается неактивным, и отслеживание не начнется. Добавьте заказы заранее или укажите `route_finish`. {% endnote %} Отслеживание начнется сразу или за некоторое время до времени начала маршрута `route_start`. Сдвиг отслеживания относительно времени начала маршрута указывается в параметре `tracking_start_h`, который задается в часах: - для маршрута. - для компании (используется, если значение для маршрута не задано). По умолчанию сдвиг отслеживания `tracking_start_h` для компании равен `1`. Изменить значение можно через техподдержку. Подробнее о параметре `tracking_start_h` см. в разделе [Ресурсы API](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/addsARoute). **route_start не задан** : Отслеживание начнется за 5 часов до начала окна самого раннего заказа. ![](../_images/without-route-start.svg) При работе с интерфейсом начало отслеживания `route_start` маршрута зависит от способа загрузки задачи в Мониторинг. **Планирование в интерфейсе и экспорт в Мониторинг** : Время начала маршрута `route_start` соответствует времени выезда автомобиля со склада. {% cut "Пример" %} Условия задачи вручную внесены в интерфейс Рабочего места логиста, где и решается задача по построению маршрута. Затем маршрут экспортируется в Мониторинг. - [Пример условий задачи](https://doc-static.yandex.net/src/dev/routing/doc-examples/routing-to-monitoring.xlsx) В интерфейсе [Рабочего места логиста](https://yandex.ru/courier/) на странице маршрута отражено, что **Установленное время старта** равно `9:26`, когда автомобиль выехал со склада. ![](../_images/routing-to-monitoring-route_start.png) {% endcut %} **Импорт готового маршрута из Excel в Мониторинг** : Время начала маршрута `route_start` соответствует времени начала смены. {% cut "Пример" %} В Мониторинг загружен файл Excel с подготовленными заранее маршрутами (лист **Routes**). При этом на листе **Vehicles** в столбце **Время начала и конца смены** для значения параметра `shifts.0.time_window` указано, что смена начинается в `02:00`. - [Пример файла с готовым маршрутом](https://doc-static.yandex.net/src/dev/routing/doc-examples/excel-to-monitoring.xlsx) В интерфейсе [Рабочего места логиста](https://yandex.ru/courier/) на странице маршрута отражено, что **Установленное время старта** равно `02:00`. ![](../_images/excel-to-monitoring-route_start.png) {% endcut %} ## Конец отслеживания {#finish-tracking} Момент окончания записи трека зависит от параметра `route_finish` маршрута. **route_finish задан** : Отслеживание закончится во время, указанное в параметре `route_finish` маршрута. **route_finish не задан** : Отслеживание закончится через 5 часов после конца окна самого позднего заказа. ![](../_images/without-route-finish.svg) ## Доступность маршрута в приложении {#route-access} **route_finish задан** : После наступления времени `route_finish` открытый маршрут закроется, и курьер не сможет войти в маршрут. **route_finish не задан** : Маршрут перестанет быть доступен в приложении, если выполняется одно из условий: - прошло больше 5 часов после окончания временного окна самого позднего заказа; - закончилось время [автоматического продления отслеживания](#extension-finish-tracking). ## Автоматическое продление отслеживания {#extension-finish-tracking} В некоторых ситуациях необходимо продолжать отслеживать маршрут, даже если время `route_finish` уже наступило или прошло больше 5 часов после окончания временного окна самого позднего заказа. Отслеживание продлевается автоматически, если: 1. `max_route_finish_prolongation_h` > 0. 1. Выполняется хотя бы одно из следующих условий: - в маршруте есть недоставленный заказ; - курьер находится в радиусе заказа на маршруте; - в конце маршрута есть непосещенный склад или заказ с типом `garage`. Параметр `max_route_finish_prolongation_h` ограничивает время, на которое маршрут можно автоматически продлевать. Время продления может быть задано в интервале от 0 до 168 часов (7 суток). По умолчанию `max_route_finish_prolongation_h` равно `0`. Изменить значение можно через техподдержку. {% note info %} При изменении времени окончания `route_finish` маршрута продление будет работать после достижения нового значения. {% endnote %} Написать в службу поддержки [//]: # (Вариант без html\: \[Написать в службу поддержки\]\(../../../feedback.md\))