Содержание
Сообщения
В данном разделе рассмотрены форматы всех типов сообщений системы Wialon. Сообщения определенного типа можно запросить используя флаги, их список представлен ниже:
Типы сообщений:
| Флаг | Описание |
|---|---|
| Сообщения объекта | |
| 0x0000 | сообщение с данными |
| 0x0100 | SMS |
| 0x0200 | команда |
| 0x0600 | событие |
| Сообщения ресурса | |
| 0x0300 | уведомление |
| 0x0500 | сообщение биллинга |
| 0x0900 | SMS для водителя |
| Журнал | |
| 0x1000 | записи журнала |
Для удаления определенных сообщений нужно иметь следующие ACL-флаги:
| Что удалить | Флаг сообщения | ACL-флаг |
|---|---|---|
| Сообщения с данными | 0x0000 | 0x800000 |
| SMS-Сообщения | 0x0100 | 0x800000 |
| Отправленные команды | 0x0200 | 0x800000 |
| Зарегистрированные события | 0x0600 | 0x2000000 |
| Журнал | 0x1000 | 0x800 |
Смотрите более подробную информацию по ACL-флагам.
Сообщениe с данными
Флаг - 0x0000
{ "t":<uint>, /* время сообщения (UTC) */ "f":<uint>, /* флаги (см. таблицу ниже)*/ "tp":"ud", /* тип сообщения (ud - сообщение с данными) */ "pos":{ /* местоположение */ "y":<double>, /* широта */ "x":<double>, /* долгота */ "z":<int>, /* высота над уровнем моря */ "s":<uint> /* скорость */ "c":<uint>, /* курс */ "sc":<ubyte> /* количество спутников */ }, "i":<uint>, /* входящие данные */ "o":<uint>, /* исходящие данные */ "p":{ /* параметры */ <text>:<double>, ... } }
Флаги сообщений с данными:
| Значение | Описание |
|---|---|
| 0x01 | доступна информация о местоположении |
| 0x02 | доступна информация о входящих данных |
| 0x04 | доступна информация о исходящих данных |
| 0x08 | доступна информация о состоянии |
| 0x10 | устанавливается, когда сообщение содержит тревожный бит |
| 0x20 | устанавливается, когда сообщение содержит информацию о коде водителя |
SMS сообщение
Флаг - 0x0100
{ "t":<uint>, /* время сообщения (UTC) */ "f":<uint>, /* флаги: у SMS сообщений нет флагов, поэтому будет стоять 0 */ "tp":"us", /* тип сообщения (us - SMS сообщение) */ "st":<text>, /* текст сообщения */ "mp":<text>, /* телефонный номер модема */ "p":{} /* параметры */ }
Команда
Флаг - 0x0200
{ "t":<uint>, /* время сообщения (UTC) */ "f":<uint>, /* флаги: у сообщений с командами нет флагов, поэтому будет стоять 0 */ "tp":"ucr", /* тип сообщения (ucr - команда) */ "ca":<text>, /* название команды */ "cn":<text>, /* тип команды */ "cp":<text>, /* параметры команды */ "ui":<uint>, /* ID пользователя */ "ln":<text>, /* название связи */ "lt":<text>, /* тип связи */ "et":<uint>, /* время выполнения */ "p":{} /* параметры */ }
Типы связи рассмотрены в разделе Команды: cоздание, редактирование и удаление.
Событие
Флаг - 0x0600
{ "t":<uint>, /* время сообщения (UTC) */ "f":<uint>, /* флаги (см. таблицу ниже))*/ "tp":"evt", /* тип сообщения (evt - событие) */ "et":<text>, /* текст события */ "x":<double>, /* долгота */ "y":<double>, /* широта */ "p":{} /* параметры */ }
Флаги событий:
| Значение | Описание |
|---|---|
| 0x0 | простое событие |
| 0x1 | нарушение |
| 0x2 | событие техобслуживания |
| 0x4 | событие контроля маршрута |
| 0x10 | устанавливается дополнительно к флагу 0x2: зарегистрировано техобслуживание |
| 0x20 | устанавливается дополнительно к флагу 0x2: произошла заправка |
Уведомление
Флаг - 0x0300
{ "t":<uint>, /* время сообщения (UTC) */ "f":<uint>, /* флаги: у сообщений с уведомлениями нет флагов, поэтому будет стоять 0 */ "tp":"xx", /* тип сообщения */ "p":{} /* параметры */ }
Cообщение биллинга
Флаг - 0x0500
{ "t":<uint>, /* время сообщения (UTC) */ "f":<uint>, /* флаги: 0x1 - устанавливается когда сообщение содержит запись о платеже */ "tp":"xx", /* тип сообщения */ "p":{} /* параметры */ }
SMS для водителя
Флаг - 0x0900
{ "t":<uint>, /* время сообщения (UTC) */ "f":<uint>, /* флаги: 0x1 - устанавливается когда сообщение отправлено */ "tp":"xx", /* тип сообщения */ "p":{ /* параметры */ "phone":<text>, /* телефонный номер */ "sms_text":<text>, /* текст смс */ "driver_name":<text>, /* имя водителя */ "driver_id":<uint> /* ID водителя */ } }
Журнал
Флаг - 0x1000
{ "t":<uint>, /* время сообщения (UTC) */ "f":4096, /* флаги: 4096 - сообщения журнала */ "tp":"xx", /* тип сообщения */ "p":{ /* параметры */ "user":<text>, /* имя пользователя */ "action":<text>, /* действие */ "host":<text>, /* хост */ "p1":<text>, /* параметры */ ... } }