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. |