Чтобы получить изменения событий по всем объектам, используйте команду events/check_updates:
svc=events/check_updates¶ms={"lang":<text>, "measure":<uint>, "detalization":<uint>}
Все параметры необязательны.
| Название | Описание | Значения по- умолчанию |
|---|---|---|
| lang | язык (двубуквенный код) | en |
| measure | единицы измерения: 0 - si, 1 - us, 2 - имперская | из настроек пользователя |
| detalization | флаги ответа (см.ниже) | 0x7 |
| Флаг | Описание |
|---|---|
| 0x1 | Базовый JSON: начало - конец события |
| 0x2 | Данные конкретного детектора |
| 0x4 | Пользовательские параметры (те, которые пользователь указал для этого события) |
| 0x10 | Полный JSON. Каждый детектор интерпретирует его по-своему |
| 0x20 | Форматированное значение |
Значениеtype | Описание | Как регистрируют события |
|---|---|---|
| 1 | Датчики переключатели: engine operation - датчик зажигания; digital - произвольный цифровой датчик; engine efficiency - датчик полезной работы двигателя; private mode - частный режим; alarm trigger - тревожная кнопка; counter - счетчик (переключатель на ВКЛ/на ВЫКЛ) | Регистрируют события от момента включения до вы- ключения. |
| 2 | Датчики мгновенные: odometer - относительный одометр; relative engine hours - относительные моточасы; instant fuel consumption - датчик мгновенного расхода топлива; counter - счетчик (мгновенный) | Регистрируют события от первого ненулевого зна- чения до последнего. |
| 3 | Датчики дифференциальные: mileage - датчик пробега; engine hours - абсолютные моточасы; impulse fuel consumption - импульсный датчик расхода топлива; absolute fuel consumption - датчик абсолютного расхода топлива; counter - счетчик (с/без переполнения); fuel level impulse sensor - импульсный датчик уровня топлива | Регистрируют события от начала роста значения до окончания. |
| 4 | Датчики аналоговые: temperature - датчик температуры; engine rpm - датчик оборотов двигателя; voltage - датчик напряжения; weight sensor - датчик веса; accelerometer - акселерометр; temperature coefficient - коэффициент температуры; custom - произвольный датчик | События не регистрируют. |
Возвращает базовый JSON (одинаков для всех групп датчиков)
"<type_name>": { "<sensor_id>": { "from": { "t":<uint>, /* время (UNIX-time) */ "y":<double>, /* широта */ "x":<double> /* долгота */ }, "to": { "t":<uint>, /* время (UNIX-time) */ "y":<double>, /* широта */ "x":<double> /* долгота */ }, "m":<uint>, /* время последнего полученного сообщения */ "f":<uint> /* служебный флаг */ } }
Возвращает данные конкретного детектора.
"ignition": { "<sensor_id>": { "state":<uint>, /* состояние: 0 - выкл, 1 - вкл */ "type": 1, /* тип датчика: датчик-переключатель */ "hours":<uint>, /* моточасы за всю историю, сек */ "switches":<uint>, /* количество срабатываний за всю историю */ "value":<bool> /* текущее значение */ } ... }
Перечислены 4 возможных типа датчиков для sensors:
"sensors": { "<sensor_id1>": { "state":<uint>, /* состояние: 0 - выкл, 1 - вкл */ "type": 1, /* тип датчика: датчик-переключатель */ "hours":<uint>, /* моточасы за всю историю, сек */ "switches":<uint>, /* количество срабатываний за всю историю */ "value":<bool> /* текущее значение */ }, "<sensor_id2>": { "type": 2, /* тип датчика: мгновенный датчик */ "counter":<uint>, /* сообщений подряд в событии */ "summary":<uint>, /* сумма значений событии */ "total_counter":<uint>, /* всего сообщений в истории */ "total_summary"<uint>, /* сумма значений в истории */ "value":<double> /* последнее значение; если -348201.3876 -- значение неизвестно */ }, "<sensor_id3>": { "type": 3, /* тип датчика: дифференциальный датчик */ "counter":<uint>, /* сумма значений в событии */ "total_counter":<uint>, /* сумма значений в истории */ "value":<double> /* последнее значение; если -348201.3876 -- значение неизвестно */ }, "<sensor_id4>": { "type": 4, /* тип датчика: аналоговый датчик */ "value":<double> /* последнее значение; если -348201.3876 -- значение неизвестно */ } }
"lls": { "<sensor_id>": { "value":<double>, /* последнее значение из сообщения, для которого посчитано level */ "level":<double>, /* среднее медианное значение (используются выставленные значения фильтрации ДУТ) */ "filled":<double> /* заправлено топлива */ } }
"trips": { "state":<bool>, /* состояние: 0 - стоянка, 1 - поездка, 2 - остановка */ "max_speed":<uint>, /* максимальная скорость за поездку */ "curr_speed":<uint>, /* текущая скорость */ "avg_speed":<uint>, /* средняя скорость относительно distance */ "distance":<uint>, /* пробег по GPS в поездке */ "odometer":<uint>, /* расстояние за все поездки */ "course":<uint>, /* направление движения */ "altitude":<uint> /* высота */ }
"counters": { "engine_hours": <uint>, /* счётчик моточасов */ "mileage": <uint>, /* счётчик пробега */ "bytes": <uint> /* cчётчик GPRS-трафика */ }
Возвращает пользовательские параметры. Зависит от того, что пользователь указал для конкретного события.
"<type_name>": { "<sensor_id>": { "p":{ /* определенный пользователем контент объекта */ "test":2, "foo":"bar", "trips":1 } } }
Возвращает полный JSON
Для датчиков type=2 и type=3 (кроме ДУТ):
"sensors": { "<sensor_id>": { "msgs": [ { "tm":<uint>, /* время сообщения, UNIX-time */ "v":<double> /* значение */ }, ... ] }, ... }
Для ДУТ:
"lls": { "<sensor_id>": { "msgs": [ { "tm":<uint>, /* время сообщения, UNIX-time */ "v":<double>, /* значение */ "l":<double> /* среднее медианное значение (используются выставленные значения фильтрации ДУТ) */ }, ... ] } }, ... }
Возвращает форматированные значения.
"ignition": { "sensor_id": { "format": { "value":<text> /* форматированное значение (чаще всего "Вкл"/"Выкл") */ } } }
"sensors": { "sensor_id": { "format": { "value":<text> /* форматированное значение, зависит от типа датчика и установленного формата */ } } }
"trips": { "format": { "distance":<text>, /* пробег относительно предыдущего сообщения */ "avg_speed":<text> /* средняя скорость относительно distance */ } }
"lls": { "sensor_id": { "format": { "value":<text>, /* форматированное значение, зависит от типа датчика и установленного формата */ "filled":<text> /* заправлено */ } } }
"counters": { "format": { "engine_hours":<uint>, /* форматированное значение счётчика моточасов */ "mileage":<text>, /* форматированное значение счётчика пробега */ "bytes":<uint> /* форматированное значение счётчика GPRS трафика */ } }
|
