Справочный центр Wialon

get_round_data

Чтобы получить подробную информацию о рейсах, используйте метод route/get_round_data:

Copied!
svc=route/get_round_data
params={
  "itemId": <long>,          
  "col": [<long>]              
}

Параметры

Запрос должен содержать следующие параметры:

Параметр Описание
itemId ID маршрута.
col Массив ID рейсов.

Ответ

Если запрос выполнен успешно, ответ возвращается в следующем формате:

Copied!
[
  {
    "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 Прибытие отложено.

Если вы заметили ошибку в тексте, пожалуйста, выделите её и нажмите Ctrl+Enter.