--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.kz/routing/doc/en/vrp/points-throughputs.md - https://yandex.kz/routing/doc/kk/vrp/points-throughputs.md - https://yandex.kz/routing/doc/ru/vrp/points-throughputs.md - href: ru/vrp/points-throughputs.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 # Пропускная способность точки Чтобы автомобили приезжали на заказ или склад в разное время, ограничьте их пропускную способность и назначьте штрафы за нарушение ограничения. {% note warning %} Для корректного учета ограничений и штрафов не рекомендуем задавать их одновременно для заказов и складов. {% endnote %} {% list tabs %} - Для заказа 1. На листе **Options** в полях `points_throughputs.N.point.lat` (`options.points_throughputs.point.lat` в [API]((https://yandex.ru/routing/doc/ru/vrp/redoc/index.html#operation/)addsATask)) и `points_throughputs.N.point.lon` (`options.points_throughputs.point.lon`) укажите координаты заказа, пропускную способность которого нужно ограничить. Вы можете указать координаты нескольких заказов любого [типа](https://yandex.kz/routing/doc/ru/vrp/properties-of-orders.md#order-type). 1. Определите тип и величину ограничения с помощью одного из параметров: * `points_throughputs.N.throughput.kg_per_hour` (`options.points_throughputs.throughput.kg_per_hour` в API) — пропускная способность заказа в кг/час; * `points_throughputs.N.throughput.units_per_hour` (`options.points_throughputs.throughput.units_per_hour`) — в грузовых единицах/час (паллеты, коробки, кеги); * `points_throughputs.N.throughput.vehicle_count` (`options.points_throughputs.throughput.vehicle_count`) — в автомобилях/час. {% note info %} Для каждого заказа можно задать только одно ограничение. {% endnote %} 1. Задайте величину [штрафов](https://yandex.kz/routing/doc/ru/vrp/more-about-penalties.md#points-throughputs) за несоблюдение условий посещения `points_throughputs.N.penalty.throughput` (`options.points_throughputs.penalty.throughput`), где: * `fixed` — штраф за факт нарушения пропускной способности; * `kg` — за каждый дополнительный килограмм; * `unit` — за каждую дополнительную грузовую единицу; * `vehicle` — за каждый дополнительный автомобиль при загрузке или выгрузке. Если размеры штрафов не указаны, используются [значения по умолчанию](https://yandex.kz/routing/doc/ru/vrp/default-values-cost-penalty.md#options). - Для склада Пропускную способность склада можно задать с помощью параметра `depot.throughput`. Подробнее об этом см. в разделе [Пропускная способность склада](https://yandex.kz/routing/doc/ru/vrp/properties-of-depot.md#depot-throughput). {% endlist %} **Пример 1** Два курьера доставляют заказы одному клиенту. Разгрузка обоих автомобилей запланирована примерно на одно и то же время. [Пример Excel](https://doc-static.yandex.net/src/dev/routing/doc-examples/points-throughputs1-without-limit.xlsx) ⋅ [Запрос API (JSON)](https://courier.yandex.ru/vrs/api/v1/log/request/019f33a2-fce5-8242-9e6d-ce9986ff9e00) ⋅ [Ответ API](https://courier.yandex.ru/vrs/api/v1/result/019f33a2-fce5-8242-9e6d-ce9986ff9e00) ⋅ [Открыть на карте](https://courier.yandex.ru/mvrp-map#019f33a2-fce5-8242-9e6d-ce9986ff9e00) **Пример 2** Те же условия, что в примере 1, но добавлено ограничение пропускной способности на адресе клиента — не более одного автомобиля в час. В результате планирования незначительно увеличился общий пробег, а временные интервалы разгрузки перестали пересекаться. [Пример Excel](https://doc-static.yandex.net/src/dev/routing/doc-examples/points-throughputs2-throughput-vehicle.xlsx) ⋅ [Запрос API (JSON)](https://courier.yandex.ru/vrs/api/v1/log/request/019f33a3-ef3c-86c2-9771-7db7d283d400) ⋅ [Ответ API](https://courier.yandex.ru/vrs/api/v1/result/019f33a3-ef3c-86c2-9771-7db7d283d400) ⋅ [Открыть на карте](https://courier.yandex.ru/mvrp-map#019f33a3-ef3c-86c2-9771-7db7d283d400) **Пример 3** Два курьера развозят 12 заказов. Ни для одного из заказов не заданы ограничения пропускной способности. В результате планирования все заказы равномерно распределяются между курьерами. Штрафы за несоблюдение условий посещения не начисляются. [Пример Excel](https://doc-static.yandex.net/src/dev/routing/doc-examples/points-throughputs3-without-limit.xlsx) ⋅ [Запрос API (JSON)](https://courier.yandex.ru/vrs/api/v1/log/request/019f33b6-5846-8171-b81b-d23a27563600) ⋅ [Ответ API](https://courier.yandex.ru/vrs/api/v1/result/019f33b6-5846-8171-b81b-d23a27563600) ⋅ [Открыть на карте](https://courier.yandex.ru/mvrp-map#019f33b6-5846-8171-b81b-d23a27563600) **Пример 4** {#example-4} Те же условия, что в примере 3, но: * координаты заказа 1 совпадают с координатами склада; * на листе **Options** для заказа 1 заданы: * ограничение пропускной способности — `points_throughputs.0.throughput.vehicle_count` = 1; * штрафы за несоблюдение условий посещения: * `points_throughputs.0.penalty.throughput.fixed` = 10 000; * `points_throughputs.0.penalty.throughput.vehicle` = 10 000. Курьеры начинают маршруты со склада. В результате планирования нарушается ограничение пропускной способности для заказа 1. Поскольку его координаты совпадают со складом, в ответе API штраф за несоблюдение условий посещения отображается в поле `result.metrics._tasks_summary.metrics.total_depot_penalty` и рассчитывается по формуле: `points_throughputs.0.penalty.throughput.fixed` + `result.metrics._tasks_summary.metrics.depot_throughput_violation_vehicles` * `points_throughputs.0.penalty.throughput.vehicle` = 10 000 + 1/2 * 10 000 = 15 000, где: * `result.metrics._tasks_summary.metrics.depot_throughput_violation_vehicles` — доля времени, в течение которого курьеры, которые нарушают условия посещения, одновременно находятся на складе. В этом примере **Время обслуживания в начале рейса** на листе **Depot** ([depot.service_duration_s](https://yandex.kz/routing/doc/ru/vrp/properties-of-depot.md#depot-service-duration) в запросе API) составило 1800 секунд. Курьеры начали маршруты со склада и одновременно находились на нем 1800 секунд (30 минут). Доля времени `result.metrics._tasks_summary.metrics.depot_throughput_violation_vehicles` составила половину часа или 1/2. [Пример Excel](https://doc-static.yandex.net/src/dev/routing/doc-examples/points-throughputs4-location-depot.xlsx) ⋅ [Запрос API (JSON)](https://courier.yandex.ru/vrs/api/v1/log/request/019f33bc-201c-87ae-9e4c-33dee6799200) ⋅ [Ответ API](https://courier.yandex.ru/vrs/api/v1/result/019f33bc-201c-87ae-9e4c-33dee6799200) ⋅ [Открыть на карте](https://courier.yandex.ru/mvrp-map#019f33bc-201c-87ae-9e4c-33dee6799200) **Пример 5** Те же условия, что в примере 3, но: * курьеры начинают маршруты с заказа 1 с типом `garage`; * на листе **Options** для него заданы: * ограничение пропускной способности — `points_throughputs.0.throughput.vehicle_count` = 1; * штрафы за несоблюдение условий посещения: * `points_throughputs.0.penalty.throughput.fixed` = 10 000; * `points_throughputs.0.penalty.throughput.vehicle` = 10 000. В результате планирования для заказа 1 нарушается ограничение пропускной способности. В ответе API штраф за несоблюдение условий посещения отображается в поле `result.metrics._tasks_summary.metrics.total_depot_penalty` и рассчитывается по такой же формуле, что и в [примере 4](#example-4). На листе **Orders** время обслуживания на заказ 1 `service_duration_s` ([locations.service_duration_s](https://yandex.kz/routing/doc/ru/vrp/properties-of-orders.md#order-service-duration-delivery) в запросе API) составило 1800 секунд. Курьеры начали маршруты с заказа 1 и одновременно находились на его адресе 1800 секунд (30 минут). Доля времени `result.metrics._tasks_summary.metrics.depot_throughput_violation_vehicles` составила половину часа или 1/2. Тогда `result.metrics._tasks_summary.metrics.total_depot_penalty` = 10 000 + 1/2 * 10 000 = 15 000. [Пример Excel](https://doc-static.yandex.net/src/dev/routing/doc-examples/points-throughputs5-location.xlsx) ⋅ [Запрос API (JSON)](https://courier.yandex.ru/vrs/api/v1/log/request/019f33c5-2fa6-83e5-b3bf-2865d2d17a00) ⋅ [Ответ API](https://courier.yandex.ru/vrs/api/v1/result/019f33c5-2fa6-83e5-b3bf-2865d2d17a00) ⋅ [Открыть на карте](https://courier.yandex.ru/mvrp-map#019f33c5-2fa6-83e5-b3bf-2865d2d17a00) Написать в службу поддержки