update_units
Для добавления объектов в сессию используйте запрос events/update_units.
svc=events/update_units¶ms={"mode":"add",
"units":[
{
"id":<long>,
"detect":
{
"trips":<uint>,
"lls":<uint>,
"sensors":<uint>,
"ignition":<uint>,
"counters":<uint>
}
},
...
]}
Для удаления определенных объектов из сессии используйте следующую сигнатуру:
svc=events/update_units¶ms={"mode":"remove",
"units":[<long>]}
Для удаления всех объектов из сессии используйте следующую сигнатуру:
svc=events/update_units¶ms={"mode":"clear"}
Параметры
Параметр | Описание |
---|---|
mode | Режим: добавление объектов в сессию (add), удаление определенных объектов из сессии (remove), удаление всех объектов из сессии (clear). |
id | ID объекта. |
detect | Типы датчиков (что отслеживать). |
trips | Поездки (см. ниже). |
lls | Датчик уровня топлива (см. ниже). |
ignition | Датчик зажигания (см. ниже). |
sensors | Другие датчики, не упомянутые выше (см. ниже). |
counters | Счетчики. |
evt_flags | Флаги событий. |
Для работы с элементами detect (trips, lls, sensors, ignition), используйте ID конкретного датчика или укажите 0, чтобы добавить все датчики одного типа. С поездками всегда используйте 0, так как нет датчика поездок.
Чтобы добавить все датчики объекта, используйте:
"detect":{"*":0}
Пример 1
Чтобы добавить все датчики зажигания или другие датчики, используйте
"detect":{"ignition":0,"sensors":0}
или
"detect":{"ignition,sensors":0}
Пример 2
Чтобы добавить все датчики уровня топлива с ID 2 и другие датчики с ID 6:
"detect":{"lls":2,"sensors":6}
Возвращаемый результат
При успешном выполнении запроса возвращается следующий результат:
{
units:<uint> /* количество объектов, добавленных в сессию */
}
В обратном случае возвращается код ошибки.
Коды ошибок
Код | Описание |
---|---|
1 | Неправильный или устаревший SID запроса. |
4 | Ошибка валидации параметров. |
7 | Не удалось загрузить библиотеку adf_avl_events. |