VRt.Routing [RT] (7.26.3024)
Основное назначение VRt.Routing - построение пути проезда между точками и расчет матриц расстояний и времен.
- Получение расстояния и времени между двумя точками с учетом пробок
- Построение пути по заданным точкам
- Построение матрицы расстояний и времен
Путь между точками
Построение пути между точками, учитывая указанный порядок и время на каждой остановке. При указании времени выезда departure_time учитываются пробки.
Authorizations:
Request Body schema: application/jsonrequired
Новый запрос на расчет пути.
required | Array of objects (route_waypoint) [ 2 .. 15001 ] items Массив географических точек, между которыми нужно проложить путь. |
| transport_type | string (transport_type) Enum: "CAR" "TRUCK_1500" "TRUCK_3000" … 13 more Example: "CAR" Типы транспорта:
Разрешенная масса - это масса снаряженного транспорта с грузом и водителем, установленная предприятием-изготовителем в качестве максимально допустимой. |
object (geo_settings) Настройки использования гео-данных. | |
| departure_time | string or null <date-time> Default: null Example: "2026-01-21T09:30:00+03:00" Дата и время отправления в соответствии с ISO 8601. |
| result_timezone | integer <int32> (timezone) [ -12 .. 12 ] Default: 0 Example: "3" Временная зона, в которой возвращается результат расчета. |
| detail | boolean Default: false Example: "true" Построение детального пути - добавляет пути от точек, которые не находятся на дорогах, до ближайших дорог. |
| full_segments | boolean Default: true Example: "false" Возвращать полный список сегментов пути. Если опция выключена - возвращается краткий список для упрощенного отображения пути. |
| polyline | boolean Default: true Example: "false" Построение пути перемещения между точками. |
| trackpoint_time | boolean Default: false Example: "true" Создавать времена у промежуточных точек пути. |
| dataset_name | string (dataset_name) [ 0 .. 512 ] characters Example: "custom_dataset_one" Название набора данных. Техническое поле, не влияющее на расчет. |
Responses
Response Schema: application/json
required | object (tracedata) Данные используемые для трассировки запросов. |
required | object (route) Информация о построенном маршруте. |
Request samples
- Payload
- Python
{- "$ref": "route_task_moscow.json"
}Response samples
- 200
- 400
- 402
- 404
- 429
- 500
{- "$ref": "route_result_moscow.json"
}Построение матрицы маршрутизации.
Для построения матрицы не учитывается параметр geo_provider, всегда используется гео-провайдер по-умолчанию.
Матрица времен и расстояний
Построение матриц расстояний и времени попарно между указанными точками. Результат работы данного метода может незначительно отличатся от метода route.
Authorizations:
Request Body schema: application/jsonrequired
Новый запрос на расчет матрицы.
required | Array of objects (routing_matrix_waypoint) [ 2 .. 15001 ] items Массив географических точек, между которыми (попарно) нужно вычислить расстояния и времена. Точки для всех матриц (с разными |
| transport_type | string (transport_type) Enum: "CAR" "TRUCK_1500" "TRUCK_3000" … 13 more Example: "CAR" Типы транспорта:
Разрешенная масса - это масса снаряженного транспорта с грузом и водителем, установленная предприятием-изготовителем в качестве максимально допустимой. |
object (geo_settings) Настройки использования гео-данных. | |
| departure_time | string or null <date-time> Default: null Example: "2026-01-21T09:30:00+03:00" Дата и время отправления в соответствии с ISO 8601. |
| dataset_name | string (dataset_name) [ 0 .. 512 ] characters Example: "custom_dataset_one" Название набора данных. Техническое поле, не влияющее на расчет. |
Responses
Response Schema: application/json
required | object (tracedata) Данные используемые для трассировки запросов. |
required | object (routing_matrix) Матрица маршрутизации. Содержит времена и расстояний между точками. |
Request samples
- Payload
{- "$ref": "matrix_task_moscow.json"
}Response samples
- 200
- 400
- 402
- 404
- 429
- 500
{- "$ref": "matrix_result_moscow.json"
}Проверка доступности
Проверка доступности сервиса.
Responses
Response Schema: application/json
| health required | number <double> [ 0 .. 1 ] Example: "0.999" Текущий показатель здоровья сервиса.
|
Response samples
- 200
- 404
- 429
- 500
{- "health": 0.999
}Получение версии сервиса
Получение версии сервиса.
Responses
Response Schema: application/json
| major required | integer <int32> [ 1 .. 100 ] Example: "7" Версия продукта.
В рамках одной версии гарантируется совместимость общих структур данных между сервисами. |
| minor required | integer <int32> [ 0 .. 111 ] Example: "15" Минорная версия сервиса. Изменение версии указывает на новую функциональность. Обновление имеет обратную совместимость в рамках мажорной версии сервиса. |
| build required | string [ 1 .. 64 ] characters Example: "3754RC" Версия сборки. |
Response samples
- 200
- 404
- 429
- 500
{- "major": 7,
- "minor": 15,
- "build": "3754RC"
}Получение документации
Получение файла с документацией на этот сервис.
path Parameters
| filename required | string [ 6 .. 128 ] characters Example: file_en.html Название файла. |
Responses
Response Schema:
Файл с данными в формате HTML.
Response samples
- 404
- 429
- 500
{- "resource_key": "resource_key_one",
- "detail": null
}