Сообщения
В этой главе описаны форматы всех типов сообщений. Вы можете запрашивать сообщения определенного типа с помощью флагов.
Все флаги используются только в десятичном формате (DEC).
Типы сообщений
Доступны следующие типы сообщений:
| Флаг в HEX | Флаг в DEC | Описание |
|---|---|---|
| 0x0000 | 0 | Сообщение с данными |
| 0x0100 | 256 | SMS |
| 0x0200 | 512 | Команда |
| 0x0400 | 1024 | Журнал пользователя |
| 0x0300 | 768 | Уведомление пользователя |
| 0x0500 | 1280 | Биллинговое сообщение |
| 0x0600 | 1536 | Событие |
| 0x0700 | 1792 | Обработка участка |
| 0x0800 | 2048 | Запись сервиса WDC |
| 0x0900 | 2304 | SMS от водителя |
| 0x1000 | 4096 | Запись журнала |
| 0x2000 | 8192 | Использование видео |
| 0x4000 | 16384 | Сообщение, которое вызвало срабатывание уведомления |
Для удаления определенных сообщений необходимо иметь следующие флаги прав доступа:
| Тип сообщения | Флаг сообщения HEX(DEC) | Флаг прав доступа HEX(DEC) |
|---|---|---|
| Сообщение с данными | 0x0000(0) | 0x800000(8388608) |
| SMS | 0x0100(256) | 0x800000(8388608) |
| Команда | 0x0200(512) | 0x800000(8388608) |
| Событие | 0x0600(1536) | 0x2000000(33554432) |
| Журнал | 0x1000(4096) | 0x800(2048) |
Дополнительную информацию о флагах прав доступа смотрите в разделе Флаги доступа.
Сообщения с данными
Флаг сообщений с данными — 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>
...
},
"lc": <int>, /* Контрольная сумма LBS-сообщения. */
"rt": <uint> /* Время регистрации сообщения (UTC). */
}
Флаги сообщений с данными:
| Значение в HEX | Значение в DEC | Описание |
|---|---|---|
| 0x01 | 1 | Доступны данные о местоположении. |
| 0x02 | 2 | Доступна информация о входных данных. |
| 0x04 | 4 | Доступна информация о выходных данных. |
| 0x10 | 16 | Сообщение содержит бит тревоги. |
| 0x20 | 32 | Сообщение содержит информацию о коде водителя в параметре avl_driver. |
| 0x20000 | 131072 | Сообщение было скорректировано по LBS. |
SMS
Флаг SMS-сообщений — 0x0100(256).
{
"t": <uint>, /* Время сообщения (UTC). */
"f": <uint>, /* Флаги: SMS-сообщения не имеют флагов, поэтому указывается значение 0. */
"tp": "us", /* Тип сообщения («us» обозначает SMS-сообщение). */
"st": <text>, /* Текст сообщения. */
"mp": <text>, /* Номер телефона модема. */
"p": {} /* Параметры. */
}
Команда
Флаг команд — 0x0200(512)
{
"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": {} /* Параметры. */
}
Типы каналов описаны на странице update_command_definition.
Событие
Флаг событий — 0x0600(1536).
{
"t": <uint>, /* Время сообщения (UTC). */
"f": <uint>, /* Флаги (см. ниже). */
"tp": "evt", /* Тип сообщения («evt» обозначает событие). */
"et": <text>, /* Текст события. */
"x": <double>, /* Долгота. */
"y": <double>, /* Широта. */
"p": {} /* Параметры. */
}
Флаги событий:
| Значение в HEX | Значение в DEC | Описание |
|---|---|---|
| 0x0 | 0 | Простое событие. |
| 0x1 | 1 | Нарушение. |
| 0x2 | 2 | Техобслуживание или заправка. |
| 0x4 | 4 | Прохождение маршрута. |
| 0x10 | 16 | Техобслуживание. Этот флаг устанавливается в дополнение к 0x2. |
| 0x20 | 32 | Заправка. Этот флаг устанавливается в дополнение к 0x2. |
Уведомление
Флаг уведомлений — 0x0300(768).
{
"t": <uint>, /* Время сообщения (UTC). */
"f": <uint>, /* Флаги: уведомления не имеют флагов, поэтому указывается значение 0. */
"tp": "xx", /* Тип сообщения. */
"p": {} /* Параметры. */
}
Биллинговые сообщения
Флаг биллинговых сообщений — 0x0500(1280).
{
"t": <uint>, /* Время сообщения (UTC). */
"f": <uint>, /* Флаги: 0x1 устанавливается, когда сообщение содержит биллинговую информацию. */
"tp": "xx", /* Тип сообщения. */
"p": {} /* Параметры. */
}
SMS-сообщение водителю
Флаг SMS-сообщений — 0x0900(2304).
{
"t": <uint>, /* Время сообщения (UTC). */
"f": <uint>, /* Флаги: 0x1 устанавливается, когда сообщение отправлено. */
"tp": "xx", /* Тип сообщения. */
"p": { /* Параметры. */
"phone": <text>, /* Номер телефона. */
"sms_text": <text>, /* Текст SMS. */
"driver_name": <text>, /* Имя водителя. */
"driver_id": <uint> /* ID водителя. */
}
}
Журнал
Флаг записей журнала — 0x1000(4096)
{
"t": <uint>, /* Время сообщения (UTC). */
"f": 4096, /* Флаги: 4096 обозначает запись журнала. */
"tp": "xx", /* Тип сообщения. */
"p": { /* Параметры. */
"user": <text>, /* Имя пользователя. */
"action": <text>, /* Действие. */
"host": <text>, /* Хост. */
"p1": <text>, /* Параметры. */
...
}
}
Сообщения WLN
Сообщения WLN имеют следующий формат:
REG;time;lon;lat;speed;course;double params;int params;text params;long params;boolean params;
Внутри раздела параметры отделяются друг от друга запятыми. Пример:
REG;1466585078;30.4367027283;59.7207145691;1;273;ALT:24.0,adc1:0.0,adc2:25.57,adc3:0.0,adc4:0.0,adc5:0.0,adc6:0.0,fuel1:0.0,fuel2:170.0,fuel3:0.0,odometer:7293607.0,acc:0.0,pwr_int:0.731,pwr_ext:25.751,hdop:1.7;in13:1,,SATS:5,count1:1,count2:0,temp1:0,temp2:23,temp3:0,sats_glonass:0,sats_gps:5;soft_version:"44";;;