Перейти к основному содержимому

POST /logistics/vrp/1.1.0/create

Спецификация OpenAPI
API docs by Redocly

2GIS Navigation API (6.0.0)

Алгоритмы

Решение задачи коммивояжёра

Расчет обхода всех указанных точек для одного или нескольких курьеров

query Parameters
key
required
string

API-ключ разработчика

Request Body schema: */*
required

Параметры запроса

required
Array of objects (Agent) [ 1 .. 200 ] items

Список курьеров

required
Array of objects (WayPoint) [ 1 .. 4000 ] items

Список информации о точках для посещения

start_time
string <date-time>
Default: "2025-08-28T10:09:16.334896"

Дата и время начала движения в формате RFC 3339 (например, 2020-05-15T15:52:01Z). Если параметр не указан, используется текущее время

travel_time_calculation
string
Default: "from_start_point"
Enum: "from_start_point" "from_each_point"

Способ расчета продолжительности маршрута:

  • from_start_point - учитывать данные о пробках только на момент начала движения по маршруту,
  • from_each_point - рассчитать время старта курьера с каждой точки на маршруте и учитывать данные о пробках для каждого перемещения курьера,

RoutingOptions (object) or null
Options (object) or null

Глобальные настройки временных окон

Responses

Response Schema: application/json
task_id
required
string

Идентификатор задачи

status
required
string (PublicTaskStatus)
Enum: "Run" "Partial" "Fail" "Done" "Not Found"

Статус задачи:

  • Run - задача в процессе обработки,
  • Partial - маршрут построен, но из него были исключены одна или несколько точек,
  • Fail - при построении маршрута возникла ошибка,
  • Done - маршрут успешно построен,
  • Not Found - задача не найдена,

PublicResultUrls (object) or null
integer or null

Время ожидания расчёта матрицы достижимости (в секундах)

integer or null

Время расчёта матрицы достижимости (в секундах)

integer or null

Время расчёта задачи коммивояжера (в секундах)

integer or null

Время ожидания расчёта задачи коммивояжера (в секундах)

Response samples

Content type
application/json
{
  • "task_id": "string",
  • "status": "Run",
  • "urls": {
    • "url_vrp_solution": "string",
    • "url_excluded": "string"
    },
  • "dm_queue": 0,
  • "dm": 0,
  • "vrp": 0,
  • "vrp_queue": 0
}