Документация Яндекс Маршрутизации описывает сервис, который распределяет заказы между машинами или курьерами и строит порядок объезда с плановым временем прибытия. Входные данные передаются двумя способами: через веб-интерфейс с шаблоном Excel или JSON-запросом к API. Ключ для API берут в настройках компании в сервисе.

Что есть в документации

Главная страница документации делит материал на разделы: планирование маршрутов, экспресс-доставка с отдельным руководством по API, календарное планирование и подключаемые опции с дополнительной тарификацией. Для обычной курьерской службы нужен раздел о планировании маршрутов. Экспресс-доставка и календарное планирование нужны тем, кому важна доставка в течение часа или расписание на несколько дней вперёд.

Детальные атрибуты (какие поля у заказа и у транспорта, какие ограничения можно задать) вынесены в справочник атрибутов и опций. Его читайте после общего обзора: сначала поймите схему работы, потом выбирайте поля.

Какие данные нужны на входе

Сервис принимает три группы сведений:

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

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

Два способа загрузки

Excel подходит для разового теста и небольшой службы. Скачиваете шаблон, заполняете, загружаете в веб-интерфейсе, получаете маршруты и скачиваете результат. Инструкция по заполнению шаблона есть в документации.

API подходит, когда заказы приходят автоматически из учётной системы или интернет-магазина. Задачу ставят запросом на добавление задачи (в документации он называется add/mvrp), результат забирают отдельным запросом по идентификатору решения. Готовые модули интеграции с вашей учётной системой ищите в документации, в остальных случаях потребуется программист. Ключ API не публикуйте в открытом коде и храните в настройках системы.

Что получаете на выходе

Результат содержит три вещи: какие заказы достались каждой машине, в какой последовательности их объезжать и когда курьер ожидаемо будет у каждого адреса. Это плановое время, не гарантия, но оно помогает назвать клиенту окно и управлять рейсом.

Время расчёта зависит от размера задачи: небольшие задачи считаются быстро, большие занимают заметно дольше. Ориентиры по времени смотрите в документации. Заложите это в расписание: утром отправлять задачу за пять минут до выезда курьеров не стоит.

Как внедрять сервис по шагам

  1. Возьмите вчерашний день: список заказов и фактические маршруты.
  2. Загрузите те же заказы в сервис и сравните километраж и время.
  3. Если разница заметна, запустите пробную эксплуатацию на неделю.
  4. Для регулярной работы автоматизируйте загрузку заказов по API.
  5. Закрепите правило: водитель следует плану, отклонения фиксируют в комментариях.
  6. Раз в месяц сравнивайте плановый и фактический пробег.

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

Беларусь и Россия

Сервис ориентирован на российские города, для Беларуси проверяйте покрытие карт и пробок по нужному городу на тестовой задаче. Если адреса определяются неверно, используйте координаты. Для рейсов между странами (например, Москва, Минск) маршрутизация решает городскую развозку на каждом конце, а междугородный рейс планируют отдельно: учитывают платные дороги для грузовиков: в России Платон, в Беларуси BelToll.

Вопросы и ответы

Нужен ли программист для старта? Нет, достаточно шаблона Excel. Программист понадобится, когда заказы нужно подгружать автоматически.

Сколько платить за сервис? Тарифы и бесплатные лимиты меняются, актуальную информацию смотрите в кабинете и в разделе о тарификации.

Учитывает ли сервис пробки? По документации расстояния и время считаются по графу дорог с учётом пробок.

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

Другие статьи рубрики: маршрутизация.

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

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

Похожие записи