# Отчет по объему топлива

## Перед началом

{% hint style="info" %}
Перед созданием топливного отчёта убедитесь, что платформа правильно настроена, чтобы события могли корректно распознаваться:

* Проверьте [настройки датчика](/docs/expert-center/ru/vehicle-telematics-technology/fuel-management/fuel-control-in-navixy/sensors-setup-and-configuration.md)
* Проверьте [настройки определения стоянки](https://app.gitbook.com/s/446mKak1zDrGv70ahuYZ/guide/devices-and-settings/location-and-movement/parking-detection-block)
  {% endhint %}

### Заправки и сливы в отчётах

Система отчётности предлагает более сложный подход к анализу, используя большой объём сохранённых данных. В ходе анализа учитываются все параметры.

Для выявления и фиксации сливов топлива платформа использует скорость снижения уровня топлива и абсолютную погрешность. «Слив» происходит, когда уровень топлива снижается больше, чем абсолютная погрешность, и быстрее, чем один из заданных порогов для сливов по времени или пробегу.

В отчёте событие «заправка» фиксируется, когда уровень топлива увеличивается больше, чем абсолютная погрешность. Платформа объединяет последовательные события заправки или слива, то есть если одно и то же условие срабатывает многократно, оно будет сведено в одно общее событие заправки или слива.

### Игнорирование заправок и сливов в движении

После того как вы включите одну или обе опции игнорирования, для отчётов и уведомлений в дополнение к стандартному алгоритму будет использоваться следующий алгоритм:

* Если заправка начинается во время [времени стоянки](/docs/user/ru/guide/events-and-notifications/movement-monitoring/parking-state-detection.md), она будет отображена в отчёте и зафиксирована правилом. Кроме того, если заправка начинается в течение X минут от тайм-аута фильтра до стоянки или в течение X минут от тайм-аута фильтра после начала поездки, она также будет зафиксирована правилом и показана в отчёте.
* Однако если заправка начинается раньше, чем за X минут до тайм-аута фильтра до стоянки, или позже, чем через X минут после тайм-аута фильтра с момента начала поездки, она будет отфильтрована.
* Если тайм-аут фильтра не указан, все заправки, начавшиеся во время поездок, будут отфильтрованы.

## Создание отчёта по объёму топлива в Navixy

Отчёт об уровне топлива отображает подробную информацию по всем датчикам топлива, установленным в автомобиле и подключённым к GPS-трекеру. Отчёт будет содержать данные о сливах, заправках, начальном и конечном объёме топлива за определённый период и по дням, общем расходе топлива и расходе топлива на 100 км или за час.

Задачи, которые решает отчёт:

* Фиксировать фактический расход топлива транспортных средств и сравнивать его с заявленным производителем расходом топлива.
* Рассчитывать амортизацию при перевозке товаров и грузов, что будет полезно логистическим компаниям и любому бизнесу для расчета себестоимости продукции.
* Рассчитывать выплаты сотрудникам за топливо и смазочные материалы, если они используют собственные транспортные средства.
* Выявить недобросовестных водителей, которые могут сливать ваше топливо для перепродажи.
* Фиксировать расход топлива у единиц оборудования. Например, у генераторных установок.
* Учитывать выдачу топлива транспортным средствам на базе.
* Определить, какая техника нуждается в ремонте, если её расход топлива постоянно высок.

{% hint style="info" %}
Вы также можете сформировать отчёт с помощью API Navixy. Подробнее можно узнать в [Центре разработчиков](https://www.navixy.com/docs/developers)
{% endhint %}

![Отчёт по топливу](/files/d90245b7f77798d3ac0c85974e9de7de5b641f18)

## Что влияет на показатели в отчёте

В отчёте отображаются графики, построенные на основании показаний датчика, передаваемых устройством. На основе полученных данных, заданных настроек датчиков топлива и параметров самого отчёта выполняются расчёты сливов, заправок и расхода топлива. Чтобы платформа могла корректно выполнять расчёты и отображать информацию, необходимо настроить следующее:

* Чтобы платформа поддерживала чтение конкретного датчика топлива, важно проверить, включает ли список поддерживаемых входов какой-либо модели возможность считывать уровень топлива с этого конкретного датчика.
* Непрерывная передача данных об уровне топлива между устройством и платформой имеет решающее значение. Если данные поступают нерегулярно или являются неточными, это может привести к проблемам с отображением графика или к некорректным расчётам на платформе.
* На записанные значения в отчёте влияют настройки датчика уровня топлива, которые важны для расчёта сливов и заправок. Вы можете изменить настройки датчика в любой момент и сформировать свежий отчёт. Кроме того, полученные результаты напрямую зависят от параметров отчёта, что делает их важным фактором, который следует учитывать.

{% hint style="info" %}
После изменения настроек датчика у вас есть возможность заново сформировать отчёт за тот же период с другими настройками. Это позволяет без проблем применить изменения к записанным данным.
{% endhint %}

## Как работает считывание топлива и отчёт

Чтобы предоставить информацию в отчёте, платформа выполняет следующее:

1. Собирает и хранит необработанные данные с устройств и датчиков топлива.\
   В зависимости от значений игнорирования, заданных в настройках датчика, при выводе информации она может отфильтровывать необработанные показания датчика. Также к необработанным данным датчика может применяться коэффициент. Все параметры настраиваются вручную вами. Платформа не вносит изменений самостоятельно и записывает данные как есть.
2. Затем необработанные данные преобразуются в значения, указанные вами в таблице калибровки, для формирования отчёта. Если таблица калибровки не заполнена, платформа не будет выполнять никаких преобразований и отобразит сохранённые значения в том виде, в котором они были получены.
3. На основании выбранных вами параметров отчёта платформа строит график сохранённых значений.
4. Затем к этому графику применяются настройки датчика топлива — значения погрешности и порогов. Именно так платформа рассчитывает сливы и заправки для отчёта.
5. Выполняются расчёты сливов, заправок и расхода топлива за период.

### Как работает определение заправок в отчёте

Для определения заправок отчёт использует параметр датчика — погрешность — и таблицу калибровки.\
Последнее значение в таблице калибровки — это максимальная ёмкость бака для датчика. Если таблица калибровки не заполнена, платформа считает максимальной ёмкостью бака 100 литров. Таким образом, если максимальная ёмкость вашего топливного бака составляет 100 литров, все изменения уровня топлива между соседними показаниями этого датчика будут сравниваться с уровнем погрешности 5% от 100 литров. Платформа сравнивает показания по сегментам из двух последовательных точек. Если уровень топлива увеличился более чем на 5 литров, заправка будет отмечена в отчёте.

### Как работает определение сливов в отчёте

Платформа использует параметры датчика порогов слива для выявления сливов в отчётах. Пороговые значения слива используются в отчётах, потому что они более сложные и сравнивают информацию о времени и расстоянии. Оба порога одновременно используются в отчёте об уровне топлива, и если уровень топлива изменяется более чем на абсолютную погрешность быстрее, чем хотя бы один из порогов, — будет определён слив.

Рассмотрим пример. Для датчика уровня топлива указаны следующие значения:

* Ёмкость бака — 370 литров;
* Погрешность — 2%, следовательно, абсолютная погрешность составляет 370 \* 0.02 = 7.4 л;
* Порог по времени для сливов — 100 литров в час или 16.6 за 10 минут;
* Порог по пробегу для сливов — 60 литров на 100 км или 6 литров на 10 км;
* Начало слива: в 1:20, уровень топлива 333.85 л, пробег 73.4
* Окончание слива: в 1:30, уровень топлива 324.98 л, пробег 79.77

Разница:

* Время: 10 минут
* Уровень топлива: 8.88 — больше, чем абсолютная погрешность, поэтому если превышен хотя бы один из порогов, слив будет определён.
* Пробег 6.37

Платформа начинает проверять скорость изменения уровня топлива:

По времени: 8.88 л / 10 минут = 0.888 в минуту или 8.88 за 10 минут — ниже порога, слив не определяется.\
По пробегу: 8.88 л / 6.37 км = 1.39 на километр или 139 на 100 километров, что выше порога, поэтому слив определяется.

## Параметры отчета

В отчете используются следующие параметры:

* Ось X на графике
  * Пробег — отчёт строится на основе полученных данных о пробеге, а сливы учитываются на основе порогов по пробегу. Средний расход будет рассчитан в л/100 км.
  * Время — отчёт строится на основе полученных данных о времени, а сливы учитываются на основе порогов по времени. Средний расход будет рассчитан в л/ч.
* Детализация по датам — отображение сводных данных о движении топлива за каждый день выбранного периода.
* Показывать общий отчет — позволяет включать или отключать страницу с общей информацией по всем устройствам.
* Показывать только общий отчёт — отображение итоговых данных о движении топлива за период по всем выбранным устройствам.
* Расход по данным зажигания — для расчёта среднего расхода топлива будут использоваться показания датчика зажигания, а не время поездки. Используйте для техники, которая часто стоит с работающим двигателем длительное время — экскаваторов, тракторов и т. д.
* Показать пробег доступно только для отчёта по времени. При включении на графике дополнительно будет отображаться пробег.
* Использовать умный фильтр — короткие поездки до 300 м и до 4 точек не будут учитываться в отчёте. Длина и время таких поездок не будут включаться в статистику.
* Показать скорость — добавляет на график в отчёте показание скорости. Это поможет при диагностике расхода топлива, а также при определении, был ли это ложный слив (например, реальный слив маловероятен при скорости 90 км/ч).
* Сгладить график — эта опция рекомендуется для устройств без встроенного механизма усреднения. Если график неровный и уровень топлива постоянно скачет вверх и вниз на 5–10%, попробуйте включить эту функцию. Обратите внимание, что сглаживание снижает точность определения заправок и сливов, но позволяет получить приемлемую картину для неточных датчиков.
* Фильтр выбросов — если вы наблюдаете сильные кратковременные изменения уровня топлива на графике, включите эту опцию. Если вы хотите отфильтровать только самые большие выбросы — сдвиньте ползунок влево. Если наоборот, слабые — вправо.

![Параметры отчёта по объёму топлива](/files/c1a904b837a121144877030aeb8f3bad0ac53fed)

После изменения настроек датчика вы можете снова сформировать отчёт за тот же период с другими настройками, и изменения будут применены к записанным данным.

## График расхода топлива по датчику

Графическое представление показывает показания датчика топлива, отображаемые отдельно для каждого датчика. Если составной датчик топлива настроен с физическими датчиками, будут видны только данные составного датчика, а отдельные показания датчиков внутри составного датчика отображаться не будут.

Кроме того, диаграмма предоставляет числовые данные по сливах и заправках в соответствии с порядком в таблице заправок и сливов. Числовое значение отображается по завершении заправки или слива, а не в начальной точке, что обеспечивает наглядность представления.

* При заправке число будет отображаться зелёным,
* При сливе число будет отображаться красным.

![График расхода топлива](/files/b846d4af1e05c5e29cb42bcd976f7d8eae6c895c)

Если платформа не получила никаких данных от датчика, это будет выделено на графике как заштрихованная область. Кроме того, при наведении на эту область будет отображаться уведомление. Это означает, что датчик топлива не передавал никаких данных на платформу в течение указанного промежутка времени.

{% hint style="info" %}
Существует несколько факторов, которые могут привести к этому:

* Устройство не отправляло данные с датчика топлива в течение этого периода. Например, провод датчика ненадёжно закреплён или данные от датчика не отправлялись в соответствии с настройкой beacon.
* Устройство вообще не отправляло никаких данных в течение этого периода. Например, оно было выключено или снято с объекта мониторинга.
  {% endhint %}

Если какие-либо значения были отфильтрованы согласно настройке датчика уровня топлива, платформа отобразит здесь последние неотфильтрованные данные.

При наведении курсора на любую из точек отчёта будет отображена точная информация, записанная в этой точке. В зависимости от того, на основе каких параметров построен отчёт, в нём будет отображаться разная информация:

**Ось X = пробег**

Если для оси X используется пробег, график покажет изменение уровня топлива по пробегу автомобиля. Вы также можете отображать показания скорости при наведении на любую из точек отчёта.

Точка из приведённого ниже примера читается так:

На 504.95 км от начала периода отчёта уровень топлива в баке составлял 44 литра. Зажигание было включено, а скорость составляла 59 км/ч.

*пример точки на графике расхода топлива по пробегу*

![Точка на графике с осью X по пробегу](/files/1a8bef9bf4b2ad1b97464bb8c2eb4b786e84f657)

**Ось X = время**

Если для оси X используется время, график покажет изменение уровня топлива с течением времени. Вы также можете отображать в точке показания скорости и пробега.

Точка из приведённого ниже примера читается так:

1 сентября 2023 года в 21:59 уровень топлива составлял 33.4 литра. Зажигание было включено, а скорость — 56 км/ч. Пробег с начала периода отчёта составил 309.28 км.

*пример точки на графике расхода топлива по времени*

![Точка на графике с осью X по времени](/files/ee49959f95a8f59297208b51b28f90e103e3f399)

## Таблица заправок и сливов

В этой таблице будет отображаться информация о зафиксированных сливах и заправках за период.

*пример таблицы заправок и сливов*

![Таблица заправок и сливов](/files/01c94a54b263527ddcd72af80be5f0941b1eee86)

**Столбцы**

В этой таблице информация представлена в следующих столбцах:

* Номер — порядковый номер, который также будет отображаться на графике.
* Время — когда был зафиксирован слив или заправка.
* Заправка/слив
* Объём, л — количество литров по определённому событию.
* Начальный объём, л — уровень топлива в начале события.
* Конечный объём, л — уровень топлива в конце события.
* С начала периода, км — сколько километров устройство проехало с начала периода отчёта.
* Адрес. При нажатии на адрес откроется карта с отображением места, где произошло событие. Перед адресом могут быть указаны геозоны, если адрес находится внутри них.

**Строки**

Строки можно прочитать следующим образом:

Номер 1 на графике — это автозаправочная станция. Событие произошло 1 сентября 2023 года в 08:42. Начальный объём составлял 16.5 литра, а конечный — 47.6 литра. Объём заправки составил 31.1 литра. Это произошло на расстоянии 194.61 км от начала отчётного периода в Варшаве, Польша.

## Детализация таблицы по датам

Таблица с детализацией по датам будет отображать рассчитанную информацию по дням в соответствии с показаниями и настройками отчёта.

*пример таблицы с детализацией расхода топлива по датам*

![Детализация таблицы по датам](/files/42178ed078dc8c565e2cc20f4ee79024e665a0ce)

**Столбцы**

Информация в таблице организована в следующих столбцах:

* Дата — день отчёта
* Данные GPS и расхода
  * Пробег, км — информация о пробеге, рассчитанном по GPS на стороне beacon.
  * Нормативный расход, л — сколько литров израсходовало бы транспортное средство, если бы расходовало топливо в соответствии с заводскими характеристиками.
  * расход, л/100 км — норматив расхода топлива транспортного средства, указанный производителем. Он берется платформой из [карточки](/docs/user/ru/guide/fleet-management/vehicles.md) транспортного средства.
* Данные датчика уровня топлива — данные, которые платформа получила от датчика уровня топлива.
  * Начальный объём, л — начальный уровень топлива за день.
  * Конечный объём, л — конечный уровень топлива за день.
  * Расход, л — фактический расход уровня топлива за день. Рассчитывается по формуле
  * `((начальный уровень топлива + (объём заправки - объём слива)) - конечный уровень топлива`
  * Расход, л/100 км — фактический расход уровня топлива на 100 км. Рассчитывается по формуле
  * `((начальный уровень топлива + (объём заправки - объём слива)) - конечный уровень топлива)/пробег * 100`
* Заправки — информация о количестве и общем объёме зарегистрированных заправок.
* Сливы — информация о количестве и общем объёме зарегистрированных сливов.

**Строки**

Информацию в первой строке можно проанализировать следующим образом:

1 сентября 2023 года пробег автомобиля составил 344.77 км. Согласно датчику, начальный объём топлива был 40.8 литра, а конечный — 28.5 литра. При этом автомобиль один раз заправлялся на 31.1 литра. Сливов зафиксировано не было. Общий расход топлива за день составил 43.4 литра, а фактический расход по датчику — 12.59 литра на 100 км.

**Итог**

Для расчёта общего расхода отчёт берёт начальный объём в первый день периода и конечный объём в последний день периода, общий пробег и общий объём заправок и сливов. Общий расход — это сумма расхода топлива по дням. После этого с помощью формулы вычисляется средний расход на 100 км.

Итоговую строку можно прочитать так:

Общий пробег за период составил 1710.78 км. По датчику уровень топлива в начале периода — 40.8 литра, в конце периода — 22.6 литра. Общее количество заправок — 6 на объём 193 литра. Фактический расход топлива составил 211.4 литра, а фактический средний расход — 12.36 л/100 км.

Если данные датчика отсутствуют в отчёте, платформа укажет это за соответствующий период. Если уровень топлива изменился в период отсутствия данных от датчика, платформа не сможет корректно спрогнозировать реальные изменения.

## Таблица статистических данных

В этой таблице представлена статистическая информация об уровнях топлива по дням и за период.

![Данные статистики таблицы](/files/555802963d7e72738007d793fae6e403f265f5cf)

**Столбцы**

Данные сгруппированы в следующие столбцы:

* Дата
* Минимум, л — минимальный уровень топлива за период.
* Максимум, л — максимальный уровень топлива за период.
* Среднее, л — среднее значение уровня топлива за период. Оно основано на всех полученных значениях датчика.

**Строки**

Данные из строки можно прочитать так:

1 сентября 2023 года минимальный уровень топлива в баке составил 16.5 литра, что также было наибольшим минимальным значением за весь период. А максимум в этот день составил 47.6 литра. Среднее значение уровня топлива в баке составило 33.55 литра.

## Качество показаний датчика уровня топлива \[LAB]

В этом разделе представлена информация об оценке качества показаний датчика уровня топлива для необработанных данных датчика и таблицы калибровки.

**Индекс качества датчика топлива (FSQI)** рассчитывается путём анализа шума необработанных данных со всех типов датчиков уровня топлива, включая OEM и автономные датчики уровня топлива.

Эта информация может быть полезна клиентам, которые анализируют расчёты топлива и графики и хотят лучше понять природу данных топлива, например, почему график неровный.

Если данных достаточно для расчёта оценки качества показаний датчика, алгоритм выдаст количественный и качественный результат:

* Количественный результат будет представлен в виде оценки от 1.0 до 10.0, где 1 означает низкое качество показаний датчика, а 10 — высокое качество показаний датчика уровня топлива.
* Качественный показатель выражается одной из трёх характеристик: **низкое**, для датчиков с оценкой качества от 1.0 до 3.9, **среднее** для датчиков с оценкой от 4.0 до 7.9 и **высокое**, с оценкой от 8.0 до 10.0 соответственно.

Если данных недостаточно для расчёта, например если датчик был недавно установлен, система отобразит следующее сообщение: "Недостаточно данных для оценки качества показаний датчика топлива. Наиболее вероятные причины: недостаточное количество поездок автомобиля за выбранный период, слишком редкий интервал получения данных о топливе или низкое качество калибровки датчика на платформе. Минимально рекомендуемый период для оценки качества показаний — от 14 дней активной эксплуатации автомобиля."

Также отчёт о качестве данных датчика уровня топлива содержит рекомендации. Эта информация позволяет клиенту провести первичный анализ работы оборудования. Предоставленная информация будет полезна клиентам при принятии решений, особенно если результаты расчётов не соответствуют их ожиданиям.

Ещё один раздел относится к **Качество калибровочной таблицы.**

Таблица калибровки — это табличное представление, которое содержит информацию о соотношении между необработанными данными датчика, полученными с датчика уровня топлива, и фактическим уровнем топлива в баке.

Основная цель таблицы калибровки — устранить возможные неточности или смещения в данных датчика. Это особенно важно из-за чувствительности датчиков уровня топлива к внешним факторам, таким как колебания температуры, изменения давления и механические вибрации. Используя таблицу калибровки, можно получить точные и надёжные расчёты уровня топлива даже при работе датчика не в оптимальных условиях.

Качественное заполнение таблицы калибровки имеет большое значение в области расчётов топлива, поскольку оно гарантирует точность, согласованность и надёжность результатов таблицы калибровки.

Для получения дополнительной информации о том, как заполнить таблицу калибровки, обратитесь к специальному разделу [Калибровка датчика уровня топлива (тарировка)](/docs/expert-center/ru/vehicle-telematics-technology/fuel-management/fundamentals-of-fuel-management/fuel-level-sensor-calibration-tare.md)

\*LAB означает экспериментальная функция.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://navixy.com/docs/expert-center/ru/vehicle-telematics-technology/fuel-management/fuel-control-in-navixy/analyzing-fuel-data/fuel-volume-report.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.