Przejdź do głównej zawartości

Usługi paliwowe

Ta strona wyjaśnia usługi związane z paliwem w Fleet API zarówno dla odbiorców biznesowych, jak i technicznych.

Skróty i terminy​

  • API: Application Programming Interface.
  • ECU: Engine Control Unit. Komputer pokładowy kontrolujący i monitorujący pracę silnika.
  • CAN bus: Controller Area Network bus. Sieć pojazdu używana przez moduły elektroniczne do wymiany danych.

Kluczowe pojęcia paliwowe​

  • Fuel consumed: Wartość kumulacyjna z ECU oznaczająca całkowitą ilość paliwa spalonego przez silnik od punktu odniesienia.
  • Fuel level: Ilość paliwa w zbiorniku, odczytywana z sensora analogowego lub z CAN bus.
  • Fuel fills and estimated fuel used: Eventy i okresy zużycia wnioskowane na podstawie zmian fuel level w czasie.

Jak sprawdzić dostępność sensorów dla pojazdu​

Przed wywołaniem endpointów paliwowych można zweryfikować, czy dany pojazd ma wymagane sensory, używając:

W odpowiedzi sprawdź data.sensors.*:

  • data.sensors.fuel_canbus_consumed: true, gdy dostępne są dane fuel consumed z CAN bus.
  • data.sensors.fuel_canbus_level: true, gdy dostępne są dane fuel level z CAN bus.
  • data.sensors.fuel_analog_level: true, gdy zainstalowany jest analogowy sensor fuel level.
  • data.sensors.electric_battery: true, gdy zainstalowany jest sensor baterii elektrycznej.
  • data.sensors.electric_charging: true, gdy zainstalowany jest sensor statusu ładowania.

Mapowanie usług paliwowych​

  • Usługi fuel consumed wymagają data.sensors.fuel_canbus_consumed = true.
  • Usługi fuel level wymagają co najmniej jednego z warunków:
    • data.sensors.fuel_canbus_level = true, lub
    • data.sensors.fuel_analog_level = true.
  • Fuel fills / estimated fuel used również zależą od dostępności fuel level, więc wymagają co najmniej jednego z dwóch flagów powyżej.

Przykład​

{
  "data": {
    "vehicle_id": "123456",
    "sensors": {
      "fuel_canbus_consumed": true,
      "fuel_canbus_level": true,
      "fuel_analog_level": false,
      "electric_battery": false,
      "electric_charging": false
    }
  }
}

1) Fuel Consumed (wartość kumulacyjna ECU)​

Definicja​

fuel_consumed to całkowita objętość paliwa zużytego przez silnik pojazdu od ustalonego punktu odniesienia (zwykle uruchomienia pojazdu w produkcji lub wydania fabrycznego).
To monotonicznie rosnąca wartość kumulacyjna raportowana przez ECU pojazdu.

Czym to nie jest​

  • Aktualna ilość paliwa w zbiorniku.
  • Paliwo zużyte tylko podczas jednego tripu.
  • Paliwo zużyte od momentu włączenia ignition.

Czym to jest​

  • Całkowita ilość paliwa spalonego przez silnik w cyklu życia pojazdu (od punktu odniesienia ECU).
  • Wartość wyliczana wewnętrznie przez ECU na podstawie modeli czasu i przepływu wtrysku.
  • Wartość niezależna od eventów tankowania.

Interpretacja biznesowa​

  • Przydatna do długoterminowej analizy wydajności paliwowej i kosztów.
  • Najlepiej nadaje się do monitorowania efektywności w długim okresie lub w całym cyklu życia pojazdu.
  • Nie powinna być używana jako bezpośredni zamiennik aktualnego poziomu paliwa w zbiorniku.

Interpretacja dla dewelopera​

  • Traktuj jako licznik kumulacyjny.
  • Zużycie dla okresu obliczaj jako różnicę dwóch poprawnych odczytów.
  • Brak wartości jest możliwy, jeśli wymagana capability nie jest aktywna dla pojazdu.

Endpointy​

Dostępność​

Dane fuel consumed wymagają dostępności capability fuel-consumed Cartrack dla pojazdu.
Jeśli API nie zwraca wyniku, skontaktuj się z opiekunem handlowym Cartrack, aby potwierdzić dostępność.

2) Fuel Level (sensor analogowy lub CAN bus)​

Definicja​

Fuel level to mierzona ilość paliwa w zbiorniku w danym momencie, odczytywana z:

  • Analogowego sensora paliwa.
  • CAN bus.

Interpretacja biznesowa​

  • Przydatna w monitoringu operacyjnym, wykrywaniu kradzieży paliwa i nadzorze tankowań.
  • Zapewnia widoczność stanu zbiornika, a nie całkowitego spalania silnika.

Interpretacja dla dewelopera​

  • Traktuj jako telemetrię typu time-series.
  • Oczekuj wahań wynikających z ruchu pojazdu, falowania paliwa, charakterystyki sensora i częstotliwości próbkowania.

Endpoint​

Dostępność​

Usługi fuel level wymagają dostępnych odczytów fuel level dla pojazdu.
Jeśli nie ma danych, skontaktuj się z opiekunem handlowym Cartrack, aby potwierdzić dostępność.

3) Fuel Fills i Estimated Fuel Used (pochodne od fuel level)​

Definicja​

Cartrack identyfikuje:

  • Fuel fill periods na podstawie wzrostów fuel level.
  • Estimated fuel used periods na podstawie spadków fuel level.

Oba wyniki są estymowane na podstawie odczytów fuel level i wymagają dostępności tych danych.

Interpretacja biznesowa​

  • Pomaga uzgadniać tankowania i wzorce zużycia.
  • Wspiera analizę wyjątków (nieoczekiwane tankowania, nietypowe zużycie).

Interpretacja dla dewelopera​

  • Traktuj te dane jako analitykę pochodną, a nie bezpośrednie liczniki ECU.
  • Jakość danych zależy od jakości i pokrycia sygnału fuel level.

Endpointy​

Dostępność​

Fuel fills i estimated fuel used zależą od odczytów fuel level.
Jeśli API nie zwraca danych, potwierdź dostępność fuel level dla pojazdu z opiekunem handlowym Cartrack.