--- metadata: - name: generator content: Diplodoc Platform v5.56.0 alternate: - https://yandex.kz/routing/doc/en/vrp/grouping-routes.md - https://yandex.kz/routing/doc/kk/vrp/grouping-routes.md - https://yandex.kz/routing/doc/ru/vrp/grouping-routes.md - href: ru/vrp/grouping-routes.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 # Кучные маршруты Яндекс Маршрутизация позволяет строить маршруты, в которых заказы группируются ближе друг к другу или локализуются в какой-то области. Для этого используйте опции `options.proximity_factor` и `options.global_proximity_factor`. |Опция | Описание| |:----- | :-----| |`proximity_factor` | При построении маршрута учитывается расстояние до ближайших заказов. В результате получаются маршруты с более близким расстоянием между соседними заказами. На практике такие маршруты более устойчивы к изменениям временных окон заказов — при переносе времени получения заказа курьер может поехать на следующий заказ, а затем вернуться к предыдущему.| |`global_proximity_factor` | При построении маршрута учитывается расстояние до последнего заказа. В результате получаются географически сгруппированные маршруты. Совместно с этой опцией используйте [дооптимизацию последовательности](post-optimization.md). Также вы можете группировать заказы вокруг «[точки притяжения](properties-of-vehicles-routes.md#route-proximity)».| Опции могут принимать значение от 0 до 10, где 0 — отсутствие группировки заказов, а 10 — максимальная группировка заказов. Мы рекомендуем значения от 0 до 1. Более высокие значения могут ухудшать метрики решения: пробег, время маршрута, количество курьеров. Если часть заказов на маршруте должна быть сгруппирована, а часть — нет, например, при доставке в центре и на окраине города, вы можете точечно отключить `proximity_factor` и `global_proximity_factor`. Для этого на листе **Orders** в поле `use_in_proximity` укажите значение `false` у тех заказов, которые не нужно дополнительно группировать. По умолчанию при построении кучных маршрутов учитывается расположение всех складов. Чтобы не учитывать промежуточные склады при расчете кучности, на листе **Depot** в поле `use_in_proximity` укажите для них значение `false`. Дополнительное описание и возможности группировки см. в кейсе [Кучные маршруты](https://yandex.kz/routing/doc/ru/vrp/examples-of-settings.md#grouping-routes). **Пример 1** Параметр `cost.km` = 8 (значение по умолчанию), а значения `proximity_factor` и `global_proximity_factor` нулевые. Маршруты оптимальны по пробегу, но географически растянуты и не локализованы в какой-то зоне. [Пример Excel](https://doc-static.yandex.net/src/dev/routing/doc-examples/uc-planning-without-proximity.xlsx) ⋅ [Запрос API (JSON)](https://courier.yandex.ru/vrs/api/v1/log/request/f85646ce-78160b6-964cb7c9-db657f53) ⋅ [Ответ API](https://courier.yandex.ru/vrs/api/v1/result/f85646ce-78160b6-964cb7c9-db657f53) ⋅ [Открыть на карте](https://courier.yandex.ru/mvrp-map#f85646ce-78160b6-964cb7c9-db657f53) **Пример 2** То же, что и в примере 1, но повысили значение `proximity_factor` до 0,5. Маршруты сформированы так, чтобы соседние заказы были ближе друг к другу. [Пример Excel](https://doc-static.yandex.net/src/dev/routing/doc-examples/uc-planning-proximity.xlsx) ⋅ [Запрос API (JSON)](https://courier.yandex.ru/vrs/api/v1/log/request/f1be53b8-b39e3d7-6e707c9-e238722a) ⋅ [Ответ API](https://courier.yandex.ru/vrs/api/v1/result/f1be53b8-b39e3d7-6e707c9-e238722a) ⋅ [Открыть на карте](https://courier.yandex.ru/mvrp-map#f1be53b8-b39e3d7-6e707c9-e238722a) **Пример 3** То же, что и в примере 1, но повысили значение `global_proximity_factor` до 0,5 и включили опцию `post_optimization`. Маршруты географически сгруппированы. [Пример Excel](https://doc-static.yandex.net/src/dev/routing/doc-examples/uc-planning-global-proximity.xlsx) ⋅ [Запрос API (JSON)](https://courier.yandex.ru/vrs/api/v1/log/request/20c835a8-78683352-1504b043-df388934) ⋅ [Ответ API](https://courier.yandex.ru/vrs/api/v1/result/20c835a8-78683352-1504b043-df388934) ⋅ [Открыть на карте](https://courier.yandex.ru/mvrp-map#20c835a8-78683352-1504b043-df388934) **Пример 4** Необходимо доставить 40 заказов. Опции кучности действуют на все заказы. Алгоритм строит гибкие и компактные маршруты для трех автомобилей. [Пример Excel](https://doc-static.yandex.net/src/dev/routing/doc-examples/planning-proximity.xlsx) ⋅ [Запрос API (JSON)](https://courier.yandex.ru/vrs/api/v1/log/request/5ecf5652-b97ffb71-d93387cd-84ca7852) ⋅ [Ответ API](https://courier.yandex.ru/vrs/api/v1/result/5ecf5652-b97ffb71-d93387cd-84ca7852) ⋅ [Открыть на карте](https://courier.yandex.ru/mvrp-map#5ecf5652-b97ffb71-d93387cd-84ca7852) **Пример 5** То же, что в примере 4, но для заказов за пределами МКАД в поле `use_in_proximity` указано `false`, поэтому они не включены в группировку. В результате алгоритм объединяет «дальние» заказы и предлагает маршруты для двух автомобилей вместо трех. [Пример Excel](https://doc-static.yandex.net/src/dev/routing/doc-examples/planning-use-in-proximity.xlsx) ⋅ [Запрос API (JSON)](https://courier.yandex.ru/vrs/api/v1/log/request/4d5e3c9c-15b05f4-77a351ab-2fe62b76) ⋅ [Ответ API](https://courier.yandex.ru/vrs/api/v1/result/4d5e3c9c-15b05f4-77a351ab-2fe62b76) ⋅ [Открыть на карте](https://courier.yandex.ru/mvrp-map#4d5e3c9c-15b05f4-77a351ab-2fe62b76) Написать в службу поддержки