Добавление задачи

При планировании через API параметры передаются сервису Маршрутизации в теле запроса в формате JSON. Поставить задачу в очередь на обработку можно с помощью метода /add/mvrp, подробнее см. в разделе со спецификацией.

Для отправки API-запросов через Postman вы можете использовать коллекцию Routing API.

Описание тела запроса

{
    "depot": {
        // Описывает склад, если он один.
    },
    "depots": [
        // Описывает склады, если их несколько.
    ],
    "locations": [
        // Описывает заказы.
    ],
    "vehicles": [
        // Описывает транспортные средства.
        "planned_route": {
            // Описывает заранее запланированные пункты назначения без указания последовательности посещения.
        }
    ],
   "options": {
        // Описывает опции маршрутизации.
        "incompatible_load_types": [
            // Описывает несовместимые типы заказов.
         ],
        "location_groups": [
            // Описывает группы заказов.
         ]
    },
    "zones": [
        // Описывает геозоны (если не используются геозоны из интерфейса).
    ]
}

* Обязательные объекты/массивы объектов при планировании через API. Не относится к соответствующим листам Excel.

Минимальный набор параметров по каждому из объектов:

• склады depots:

  • идентификатор id;
  • координаты point.lat, point.lon;
  • временное окно time_window или несколько временных окон time_windows, если склад работает с перерывами.

• заказы locations:

  • идентификатор id;
  • координаты point.lat, point.lon;
  • временное окно выполнения заказа time_window или несколько временных окон time_windows;
  • жесткость временного окна hard_window;
  • сервисное время (время на выполнение заказа) service_duration_s.

• курьеры и автомобили vehicles:

  • идентификатор id;
  • способ передвижения (пешком, на общественном транспорте, на легковом или грузовом автомобиле) routing_mode;
  • необходимость возврата на склад после завершения маршрута return_to_depot.

• параметры алгоритма планирования options:

  • часовой пояс time_zone.