Яндекс Маршрутизация API: возможности планирования

Яндекс Маршрутизация это сервис, который распределяет заказы между курьерами и водителями и строит для каждого оптимальный маршрут. Он решает классическую задачу маршрутизации транспорта: есть склад, парк машин или курьеров, список адресов с временными окнами и ограничениями, и нужно получить маршруты с минимальной суммой затрат и штрафов. Для разработчика это программный интерфейс (API), для диспетчера веб-кабинет и мобильное приложение для исполнителей. Ниже разобрано, что учитывает алгоритм, какие данные нужно подготовить, как читать результат и чем сервис отличается от обычного построения маршрута на карте.

Что входит в сервис

По описанию на официальной странице документации, сервис состоит из нескольких частей, которые можно использовать вместе или по отдельности.

• Планирование маршрутов: распределение заказов по исполнителям и построение маршрутов с учётом более 300 параметров планирования.
• Мониторинг: слежение за доставкой в реальном времени и информирование получателей об ожидаемом времени прибытия.
• Мобильное приложение для исполнителей, где видны заказы из сервиса.
• Календарное планирование: многодневные маршруты с регулярными посещениями точек.
• Дополнительные платные опции, которые подключают по запросу.

Условия тарификации и оферта опубликованы на странице самого сервиса, их нужно смотреть в первоисточнике: цены и лимиты меняются, и пересказ быстро устаревает.

Что учитывает алгоритм планирования

Алгоритм получает на входе описание склада, исполнителей и заказов, а затем итеративно улучшает начальный маршрут. Из документации следует, что в расчёт входят:

• склад и его пропускная способность по погрузке;
• автомобили и курьеры с типом и способом передвижения;
• вместимость автомобилей;
• время работы исполнителей;
• заказы с весом, габаритами, временными окнами и особыми требованиями, например хрупкостью;
• несовместимость заказов и машин, порядок выполнения заказов;
• матрица расстояний по дорогам и пробки по времени суток.

Ограничения делятся на жёсткие и мягкие. Жёсткие нарушать нельзя: число исполнителей, вместимость машины, несовместимость заказов и автомобилей, обязательный порядок. Мягкие допускают нарушение со штрафом: временные окна, максимальный пробег за смену, минимальное и максимальное число остановок, длительность смены. Оптимизируется сумма стоимости использованных ресурсов и штрафов, итоговая метрика называется суммарной стоимостью со штрафами, и чем она ниже, тем лучше решение.

Как подготовить данные для расчёта

1. Опишите точку старта: склад, адрес, время работы и ограничения по погрузке.
2. Составьте список исполнителей: тип транспорта, вместимость по весу и объёму, смена, стоимость часа и километра.
3. Соберите заказы: точный адрес или координаты, окно доставки, вес, габариты, время на разгрузку.
4. Отметьте особые требования: заказ только для машины с рефрижератором, хрупкий груз, обязательный подъём на этаж.
5. Проверьте адреса. Ошибка в улице превращается в крюк в десять километров, и алгоритм не заметит её сам.
6. Запустите расчёт и сравните результат с ручным планом хотя бы по пробегу и числу опозданий.

Для оценки стоимости рейса и сравнения вариантов подойдёт калькулятор стоимости рейса, для стоимости километра калькулятор стоимости километра.

Учебный пример: что меняет оптимизация

Условный пример с заданными допущениями. Склад в городе, 36 заказов на день, окна доставки по два часа, 3 курьера на автомобилях, на каждого не больше 14 остановок и 8 часов смены. Допустим, при ручном распределении по районам курьеры проезжают 96, 88 и 74 километра, а два заказа не успевают в окно. Алгоритм учитывает пробки и окна, перераспределяет заказы между районами и сокращает пробег.

Цифры правой колонки взяты как иллюстрация порядка величин, а результат реального расчёта зависит от плотности адресов, окон и дорожной сети. Реальную экономию можно проверить только на ваших данных, сравнив два плана за одни и те же дни.

Как читать результат расчёта

• Результат вероятностный: при одинаковых данных маршруты могут отличаться, но суммарная стоимость со штрафами меняется незначительно.
• Время решения задачи ограничено, поэтому для очень больших задач разбивайте день на несколько расчётов.
• Максимальный диапазон корректного построения маршрута составляет 7 дней. Для более длинных планов используется специальный параметр.
• Ошибки валидации и бизнес-логики приходят в теле ответа с кодом 200, их должен обрабатывать ваш код. Сбои на стороне сервера возвращаются с кодом 50x.

Чем отличается от построения маршрута на карте

Библиотеки карт строят путь от точки А до точки Б или через несколько точек в заданном вами порядке. Сервис маршрутизации сам решает, какой курьер поедет к какой точке и в какой последовательности. Для задач вида «доехать до адреса» хватит маршрутизации на картах. Для задач «развезти 200 заказов 15 курьерам с окнами и вместимостью» нужна именно оптимизация. Сравнение сервисов смотрите в материале сравнение сервисов маршрутизации Relog и Яндекс.

Кому подходит

• Службам доставки с десятками и сотнями заказов в день.
• Интернет-магазинам с собственным автопарком.
• Торговым компаниям, развозящим товар по точкам.
• Сервисным компаниям с выездными бригадами.

Для небольшого потока в 10–15 адресов в день ручное планирование нередко окупается лучше, чем подключение и обучение. Принципы ручного планирования зон, окон и очередности описаны в статье планирование маршрутов курьеров.

Частые вопросы

Где найти документацию? В разделе документации сервиса на сайте Яндекса, в нём описаны планирование, мониторинг и приложение. Названия разделов при обновлениях меняются.

Можно ли пользоваться бесплатно? Условия тарификации указаны на странице сервиса вместе с офертой. Проверяйте актуальные условия в первоисточнике, в том числе наличие пробного периода.

Нужно ли что-то скачивать? Планирование и мониторинг ведутся через веб-интерфейс и API, для исполнителей есть мобильное приложение. Скачивайте приложения только из официальных магазинов.

Подходит ли сервис для Беларуси? Доступность сервисов Яндекса в конкретной стране и условия оплаты уточняйте на сайте сервиса и у поддержки. Для расчётов по Беларуси точность зависит от полноты картографических данных по вашему региону.

Что делать, если маршрут получился неудобным? Проверьте ограничения: слишком узкие окна и малая вместимость приводят к штрафам и странным решениям. Ослабьте мягкие ограничения и запустите расчёт снова.

Читайте также

• Яндекс Маршрутизация: как планировать маршруты
• Сравнение сервисов маршрутизации Relog и Яндекс
• Оптимизация маршрутов курьеров в Яндекс Доставке
• Оптимальный маршрут перевозки: метод и пример расчёта

Остальные материалы раздела собраны в рубрике Маршрутизация.

Проверено: октябрь 2026. Источники: документация сервиса Яндекс Маршрутизация (раздел о планировании маршрутов и описание алгоритма, обработка ошибок), общие методы решения задачи маршрутизации транспорта.

Раздел: Технологии и сервисы / Маршрутизация и оптимизация доставки