Навигация | TSP API | Справочник API | 2GIS Documentation
TSP API
Карты
Поиск
Навигация
2ГИС Про
2ГИС Линза
Личный кабинет
On‑Premise
ру
en

POST /logistics/vrp/1.1.0/create

Спецификация OpenAPI

Documentation Powered by ReDoc

2GIS Navigation API (6.0.0)

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

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

query Parameters
key
required
string

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

Request Body schema: */*

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

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

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

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

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

start_time
string <date-time>
Default: "2025-02-24T07:12:56.150174"

Дата и время начала движения в формате 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

Блок опций TSP/VRP

Responses

Response Schema: application/json
task_id
required
string

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

status
required
string (schemas)
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 Schema: application/json
string or null

Описание ошибки

Response Schema: application/json
required
Array of strings or Array of DetailErrorDescription (objects)

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
}