get_fuel_settings
Чтобы получить настройки расхода топлива объекта, используйте команду unit/get_fuel_settings.
svc=unit/get_fuel_settings¶ms={"itemId":<long>}
Параметры
Запрос должен содержать параметр itemId, в котором указывается ID объекта.
Ответ
При успешном выполнении запроса возвращаются настройки расхода топлива.
{
"calcTypes": <uint>, /* Способ расчета расхода топлива (см. ниже) */
"fuelLevelParams": { /* Определение заправок и сливов топлива */
"flags": <uint>, /* Флаги определения заправок и сливов (см. ниже) */
"ignoreStayTimeout": <uint>, /* Игнорировать сообщения после начала движения (секунды) */
"minFillingVolume": <double>, /* Минимальный объем заправки (литры) */
"minTheftTimeout": <uint>, /* Минимальное время простоя для определения слива (секунды) */
"minTheftVolume": <double>, /* Минимальный объем слива (литры) */
"filterQuality": <ubyte>, /* Степень фильтрации (диапазон: 0–255) */
"fillingsJoinInterval": <uint>, /* Таймаут для разделения последовательных заправок (секунды) */
"theftsJoinInterval": <uint>, /* Таймаут для разделения последовательных сливов (секунды) */
"extraFillingTimeout": <uint> /* Таймаут для определения итогового объема заправки (секунды) */
},
"fuelConsMath": { /* Расчет расхода топлива по математическим формулам */
"idling": <double>, /* Расход на холостом ходу (литры в час) */
"urban": <double>, /* Расход в городском цикле (литры на 100 км) */
"suburban": <double> /* Расход в загородном цикле (литры на 100 км) */
},
"fuelConsRates": { /* Расход топлива по сезонным нормам */
"consSummer": <double>, /* Летний расход (литры на 100 км) */
"consWinter": <double>, /* Зимний расход (литры на 100 км) */
"winterMonthFrom": <uint>, /* Начало зимнего периода (месяц: 0–11) */
"winterDayFrom": <uint>, /* Начало зимнего периода (день: 1–31) */
"winterMonthTo": <uint>, /* Конец зимнего периода (месяц: 0–11) */
"winterDayTo": <uint> /* Конец зимнего периода (день: 1–31) */
},
"fuelConsImpulse": { /* Импульсные датчики расхода топлива */
"maxImpulses": <uint>, /* Максимальное количество импульсов */
"skipZero": <uint> /* Пропускать первое нулевое значение */
}
}
Способы расчета расхода топлива:
| Флаг | Описание |
|---|---|
| 0x0 | Не использовать расход топлива в отчетах. |
| 0x01 | Рассчитывать расход математически. |
| 0x02 | Датчики уровня топлива. |
| 0x04 | Заменять невалидные значения рассчитанными математически. |
| 0x08 | Датчики абсолютного расхода топлива. |
| 0x10 | Импульсные датчики расхода топлива. |
| 0x20 | Датчики мгновенного расхода топлива. |
| 0x40 | Расход по нормам. |
Флаги заправок и сливов топлива:
| Флаг | Описание |
|---|---|
| 0x01 | Объединять значения одноименных датчиков уровня топлива. |
| 0x02 | Фильтровать значения датчиков уровня топлива. |
| 0x04 | Объединять значения одноименных датчиков расхода топлива. |
| 0x08 | Определять заправки только на остановках. |
| 0x10 | Рассчитывать расход топлива по времени. |
| 0x20 | Игнорировать фильтрацию значений датчика при расчете объема заправленного и слитого топлива (использовать исходные сообщения). |
| 0x40 | Игнорировать фильтрацию значений датчика при расчете объема заправленного топлива. |
| 0x80 | Игнорировать фильтрацию значений датчика при расчете объема слитого топлива. |
| 0x100 | Определять сливы в движении. |
| 0x200 | Рассчитывать заправки по времени, а не по пробегу. |
| 0x400 | Рассчитывать сливы по времени, а не по пробегу. |
| 0x800 | Рассчитывать расход топлива по времени, а не по пробегу. |
| 0x1000 | Заменять невалидные значения рассчитанными математически. |
| 0x2000 | Возвращать настройки топлива по умолчанию, если они заданы (адаптивная и медианная фильтрация). |
| 0x4000 | Адаптивная фильтрация. |
Если запрос выполнить не удалось, возвращается код ошибки 7. Он означает, что у пользователя нет права доступа Просмотр элемента и его основных свойств на объект.