get_round_data
Чтобы получить подробную информацию о рейсах, используйте метод route/get_round_data:
svc=route/get_round_data
params={
"itemId": <long>,
"col": [<long>]
}
Параметры
Запрос должен содержать следующие параметры:
| Параметр | Описание |
|---|---|
| itemId | ID маршрута. |
| col | Массив ID рейсов. |
Ответ
Если запрос выполнен успешно, ответ возвращается в следующем формате:
[
{
"id": <long>, // ID рейса.
"n": <text>, // Название.
"d": <text>, // Описание.
"tz": <uint>, // Часовой пояс.
"u": <long>, // ID назначенного объекта (если не указан, используется первый объект из "cu", который отправляется с первой контрольной точки).
"cu": [<long>], // Массив ID объектов.
"pt": [ // Контрольные точки.
{
"n": <text>, // Название.
"f": <uint>, // Тип.
"u": <long>, // ID объекта (0, если тип не "контрольная точка из объекта").
"y": <double>, // Широта.
"x": <double>, // Долгота.
"r": <uint> // Радиус.
}
],
"sh": { // Расписание.
"id": <long>, // ID расписания.
"n": <text>, // Название.
"f": <uint>, // Тип.
"tz": <uint>, // Часовой пояс.
"cfg": { // Пользовательская конфигурация. Передается из объекта расписания без изменений.
"enabled": <byte>, // Автоматическое создание рейсов: 1 — включено, 0 — отключено.
"name": <text>, // Название рейса.
"description": <text>, // Описание.
"roundFlags": <uint>, // Флаги рейса.
"units": [<long>], // ID объектов.
"validityPeriod": <uint> // Период действия.
},
"tm": [ // Время прохождения контрольных точек.
{
"at": <uint>, // Время прибытия.
"ad": <uint>, // Отклонение от времени прибытия.
"dt": <uint>, // Время отбытия.
"dd": <uint> // Отклонение от времени отбытия.
}
],
"sch": { // Временные ограничения.
"f1": <uint>, // Начало интервала 1.
"f2": <uint>, // Начало интервала 2.
"t1": <uint>, // Конец интервала 1.
"t2": <uint>, // Конец интервала 2.
"m": <uint>, // Маска дней месяца.
"y": <uint>, // Маска месяцев.
"w": <uint> // Маска дней недели.
}
},
"at": <uint>, // Время активации.
"vt": <uint>, // Начало периода действия.
"vp": <uint>, // Период действия.
"f": <uint>, // Флаги рейса.
"st": { // Состояние рейса.
"st": { // Общее состояние рейса.
"pi": <uint>, // Индекс контрольной точки (4294967295 означает, что рейс не начат).
"ps": <uint>, // Флаги состояния и флаги событий.
"ut": <uint> // Время последнего события.
},
"pts": { // Состояние по отдельной контрольной точке.
"<text>": {
"st": <uint>, // Флаги событий.
"tm": <uint> // Время последнего события.
}
// ... другие контрольные точки
}
}
}
]
Типы контрольных точек описаны на странице update_checkpoints.
Типы расписаний описаны на странице update_schedule.
Флаги рейса
| Флаг | Описание |
|---|---|
| 0x0 | Порядок прохождения контрольных точек: строгий. |
| 0x2 | Удалять завершенные рейсы с временной шкалы. |
| 0x10 | Порядок прохождения контрольных точек: возможны пропуски. |
| 0x20 | Разрешает формирование отчетов по рейсам. |
| 0x40 | Порядок прохождения контрольных точек: произвольный. |
Флаги состояния рейса
| Флаг | Описание |
|---|---|
| 0x010000 | Не активен. |
| 0x020000 | Завершен. |
| 0x040000 | Ожидание прибытия. |
| 0x080000 | Ожидание отбытия. |
| 0x200000 | Опоздание. |
| 0x400000 | Опережение. |
| 0x800000 | Остановлен. |
| 0x0100000 | Прерван. |
Флаги событий
| Флаг | Описание |
|---|---|
| 0x1 | Рейс начат. |
| 0x2 | Рейс завершен. |
| 0x4 | Рейс прерван. |
| 0x8 | Объект прибыл на контрольную точку. |
| 0x10 | Объект прошел контрольную точку. |
| 0x20 | Объект отбыл с контрольной точки. |
| 0x40 | Объект прибыл с опозданием. |
| 0x80 | Объект прибыл раньше времени. |
| 0x100 | Объект прошел контрольную точку вовремя. |
| 0x200 | Прибытие отложено. |