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

update_round

Чтобы создать, изменить или удалить рейс, используйте метод route/update_round:

Copied!
svc=route/update_round
params={
  "itemId": <long>,
  "id": <long>,
  "callMode": <text>,
  "n": <text>,
  "d": <text>,
  "u": <long>,
  "at": <uint>,
  "vt": <uint>,
  "vp": <uint>,
  "sh": <long>,
  "cu": [<long>],
  "f": <uint>,
  "tz": <uint>
}

Параметры

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

Параметр Описание
itemId ID маршрута.
id ID рейса.
callMode Действие: create, update, delete.
sh ID расписания. Обязателен, если действие — create или update.

Описание остальных параметров см. на странице get_round_data.

Ответ

Если запрос выполнен успешно, формат ответа зависит от действия, указанного в параметре callMode.

Ответ на запрос создания или обновления рейса возвращается в следующем формате:

Copied!
[
  <long>,                  // ID рейса.
  {
    "id": <long>,          // ID рейса.
    "ct": <long>,          // Время создания рейса (UNIX).
    "mt": <long>,          // Время обновления рейса (UNIX).  
    "n": <text>,           // Название.
    "d": <text>,           // Описание.
    "sh": <text>,          // Название расписания.
    "f": <uint>,           // Флаги рейса.
    "tz": <uint>,          // Часовой пояс.
    "u": <long>,           // Назначенный объект. Если не указан, в этом поле отображается первый объект из массива "cu", который отправляется с первой контрольной точки.
    "at": <uint>,          // Время активации.
    "vt": <uint>,          // Начало периода действия.
    "vp": <uint>,          // Период действия.
    "sts": <uint>,         // Флаги состояния рейса.

    "st": {                // Состояние рейса.
      "st": {              // Общее состояние рейса.
        "pi": <uint>,      // Индекс контрольной точки (4294967295, если рейс не начат).
        "ps": <uint>,      // Флаги состояния и флаги событий.
        "ut": <uint>       // Время последнего события.
      },
      "pts": {             // Состояние по контрольной точке.
        "<checkpoint_id>": {
          "st": <uint>,    // Флаги событий.
          "tm": <uint>     // Время последнего события.
        }
        // ... дополнительные контрольные точки
      }
    }
  }
]

Флаги состояния и флаги событий рейса описаны на странице get_round_data.

Ответ на запрос удаления рейса возвращается в следующем формате:

Copied!
[
  <long>,  // ID рейса.
  null
]

Если запрос не выполнен, возвращается код ошибки.

Коды ошибок

Код ошибки Описание
4 Одна из следующих ошибок:
  • неверные параметры JSON;
  • неверный параметр callMode;
  • отсутствует обязательный объект или объекты, которые можно назначить рейсу;
  • неверные или отсутствующие параметры расписания.
6 Внутренняя ошибка.
7 Внутренняя ошибка.

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