--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.kz/routing/doc/en/delivery/functions/visit-detection.md - https://yandex.kz/routing/doc/kk/delivery/functions/visit-detection.md - https://yandex.kz/routing/doc/ru/delivery/functions/visit-detection.md - href: ru/delivery/functions/visit-detection.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 # Детекция посещения точек маршрута Посещение точек маршрута (заказов и складов) определяется автоматически. На основе этой функции фиксируются нарушения в последовательности доставки заказов (если не включена опция [Порядок доставки по статусам заказов](https://yandex.kz/routing/doc/ru/delivery/configurable-options/delivery-by-order-status.md)) и работает [автоматическое определение доставки](https://yandex.kz/routing/doc/ru/delivery/functions/delivery-detection.md). {% note info %} Для складов детекция посещения работает, только если настроен экспорт складов в Мониторинг и/или если склады добавляются в маршруты как отдельные точки через API (для этих точек `type` = `depot`). Подробнее см. раздел [Посещение склада курьером](https://yandex.kz/routing/doc/ru/delivery/functions/visiting-depot.md). {% endnote %} ## Настройки параметров детекции {#detection-parameters} **Радиус детекции, м** : Радиус детекции при выполнении заказа может быть настроен: - для компании. Параметр действует для всех заказов компании, если для них не настроены индивидуальные параметры. По умолчанию равен 500 м. Указать иное значение можно самостоятельно в [настройках компании](../interface/company.md) при подключении функции [автоматического определения доставки](delivery-detection.md) или через обращение в поддержку (если не хотите подключать автоматическое определение доставки). Максимальный радиус детекции, который можно указать — 2000 м. - для склада. Параметр действует для всех заказов маршрута, который начинается с этого склада. Чтобы задать радиус детекции для склада, используйте параметр `mark_delivered_radius` в методе API при [создании](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/addsADepot) склада или редактировании [одного](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/editsDepot) или [нескольких](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/editsMultipleDepots) складов. Приоритет этого радиуса выше, чем у заданного на компанию. - для заказа. Чтобы задать его, используйте параметр `mark_delivered_radius` в методе API при [создании](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/addsAnOrder) или редактировании [одного](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/editsOrder) или [нескольких](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/editsMultipleOrders) заказов. Приоритет этого радиуса выше, чем у заданного для компании или склада. Радиус детекции посещения склада (отличный от настройки на уровне компании) можно задать через интерфейс в [настройках склада](https://yandex.kz/routing/doc/ru/delivery/interface/depots.md) или с помощью метода API при создании [одного](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/addsADepot) или [нескольких](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/editsMultipleDepots) складов в параметре `mark_route_started_radius`. **Коэффициент детекции** : По умолчанию равен 0,5. Указать иное значение можно самостоятельно в [настройках компании](https://yandex.kz/routing/doc/ru/delivery/interface/company.md) (только при подключении функции [автоматического определения доставки](https://yandex.kz/routing/doc/ru/delivery/functions/delivery-detection.md)) или через обращение в поддержку (если не хотите подключать автоматическое определение доставки). **Время нахождения в радиусе, необходимое для детекции посещения, с** : Детекция посещения сработает через время $N$, в течение которого курьер должен непрерывно находиться в пределах радиуса детекции, то есть в зоне доставки. {% note info %} Если параметры времени не указаны, то детекция посещения сработает в момент въезда курьера в радиус. {% endnote %} Для заказа время непрерывного нахождения курьера в зоне доставки рассчитывается по формуле: $N = coef_{detection} * \times(t_{order} + t_{address})$, где - $coef_{detection}$ — коэффициент детекции; - $t_{order}$ — время обслуживания на заказ `service_duration_s`; - $t_{address}$ — время обслуживания на адрес `shared_service_duration_s`. Для склада при расчете используется время погрузки/разгрузки `service_duration_s`. Задать данное значение можно также через метод API по созданию [одного](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/addsADepot) или [нескольких](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/editsMultipleDepots) складов. Задавать данный параметр нужно, если вы пользуетесь [детекцией складов](visiting-depot.md). **Зависимость от расчета ETA** : Момент, когда сработает детекция посещения, зависит от выбранного [типа расчета ETA](https://yandex.kz/routing/doc/ru/extras/sms-setting.md#notification-eta): - для `arrival_time`: через $N$ секунд с момента въезда в зону доставки; - для `delivery_time`: через $N$ секунд с момента начала доставки, но не раньше окна доставки. #| || ![](./../_images/video-icon.png) | Ручной и автоматический режим фиксации доставки. Настройка режима определения доставки {% cut "Посмотреть видео" %} @[rutube](https://rutube.ru/play/embed/7c0120cc2dbddcc29b170f46add86167) {% endcut %} || |# **Детекция следующей по порядку точки** {#setup-point-next} : Включить опцию **Разрешена детекция только следующей по порядку точки** можно в [настройках компании](https://yandex.kz/routing/doc/ru/delivery/interface/company.md#auto-delivery). Используйте, если важен [порядок выполнения заказов](https://yandex.kz/routing/doc/ru/vrp/properties-of-orders.md#sequence-order) на маршруте. Если опция включена: - разрешается детекция только той точки маршрута, которая идет следующей по порядку; - детекция не срабатывает при заезде в радиусы других точек. Исключение: разрешается фиктивная отметка посещения для стартового склада вместе с детекцией заказа, который идет первым по порядку после склада. Если опция отключена: - алгоритм отмечает выполнение заказов по очереди; - одновременно в одной точке могут отметиться выполненными только те заказы, которые идут друг за другом, и мультизаказы; - алгоритм учитывает сервисное время заказа и сопоставляет его со временем нахождения в радиусе. **Пример 1** Курьер доставляет медицинские препараты с разными температурными режимами. Для этого задан порядок выполнения заказов: заказ 1 → заказ 2 → заказ 3 → заказ 4 → заказ 5 → заказ 6 → заказ 7. Включена опция **Разрешена детекция только следующей по порядку точки**. Заказы 1 и 3 расположены по одному адресу, но должны быть доставлены в разной последовательности. В результате при выполнении заказа 1 детекция заказа 3 не сработает, даже если курьер проведет в зоне доставки достаточно времени для детекции. **Пример 2** В маршруте курьера 5 заказов. Включена опция **Разрешена детекция только следующей по порядку точки**. Логист вручную отмечает заказ 1 как выполненный. В результате курьер посещает сразу заказ 2 и происходит детекция, так как все предыдущие заказы выполнены. **Пример 3** Те же условия, что в примере 2. Логист вручную отмечает заказ 1 и заказ 4 как выполненные. В результате курьер посещает: 1. Заказ 2 — происходит детекция, так как все предыдущие заказы выполнены. 1. Заказ 5 — детекция не происходит, потому что не все предыдущие заказы выполнены. Заказ 3 не завершен, несмотря на ручную отметку заказа 4. ## Особенности времени фиксации посещения {#setup-details} Посещение точки определяется по времени на устройстве курьера. Например, курьер посетил заказ в 17:00, но в этот момент интернет-соединение на его устройстве пропало и восстановилось только в 17:10. Тогда в Рабочем месте логиста на дашборде в 17:05 менеджер не увидит, что заказ посещен. Менеджер увидит эту информацию только в 17:10, когда интернет-соединение восстановилось и устройство смогло передать данные на сервер Мониторинга. При этом время посещения заказа будет зафиксировано как 17:00. Написать в службу поддержки [//]: # (Вариант без html\: \[Написать в службу поддержки\]\(../../../feedback.md\))