Lewati ke konten utama

Layanan Bahan Bakar

Halaman ini menjelaskan layanan terkait bahan bakar di Fleet API untuk audiens bisnis dan teknis.

Akronim dan Istilah​

  • API: Application Programming Interface.
  • ECU: Engine Control Unit. Komputer pada kendaraan yang mengontrol dan memantau operasi mesin.
  • CAN bus: Controller Area Network bus. Jaringan kendaraan yang digunakan modul elektronik untuk bertukar data.

Ringkasan Konsep Bahan Bakar​

  • Fuel consumed: Nilai kumulatif dari ECU yang merepresentasikan total bahan bakar yang dibakar mesin sejak titik referensi.
  • Fuel level: Jumlah bahan bakar di tangki, dibaca dari sensor analog atau dari CAN bus.
  • Fuel fills dan estimated fuel used: Event dan periode pemakaian yang diinferensikan dari tren fuel level dari waktu ke waktu.

Cara Mengecek Ketersediaan Sensor per Kendaraan​

Sebelum memanggil endpoint bahan bakar, Anda dapat memverifikasi apakah setiap kendaraan memiliki sensor yang diperlukan dengan menggunakan:

Di respons, cek data.sensors.*:

  • data.sensors.fuel_canbus_consumed: true jika data fuel consumed dari CAN bus tersedia.
  • data.sensors.fuel_canbus_level: true jika data fuel level dari CAN bus tersedia.
  • data.sensors.fuel_analog_level: true jika sensor fuel level analog terpasang.
  • data.sensors.electric_battery: true jika sensor baterai listrik terpasang.
  • data.sensors.electric_charging: true jika sensor status pengisian listrik terpasang.

Pemetaan Layanan Bahan Bakar​

  • Layanan fuel consumed membutuhkan data.sensors.fuel_canbus_consumed = true.
  • Layanan fuel level membutuhkan setidaknya salah satu dari:
    • data.sensors.fuel_canbus_level = true, atau
    • data.sensors.fuel_analog_level = true.
  • Fuel fills / estimated fuel used juga bergantung pada ketersediaan fuel level, sehingga membutuhkan setidaknya salah satu dari dua flag di atas.

Contoh​

{
  "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 (nilai kumulatif ECU)​

Definisi​

fuel_consumed adalah total volume bahan bakar yang dikonsumsi mesin kendaraan sejak titik referensi yang ditentukan (umumnya saat commissioning kendaraan atau rilis pabrik).
Nilai ini merupakan nilai kumulatif yang meningkat secara monoton dan dilaporkan oleh ECU kendaraan.

Bukan Ini​

  • Bahan bakar yang saat ini ada di tangki.
  • Bahan bakar yang digunakan hanya selama satu trip.
  • Bahan bakar yang digunakan sejak ignition dinyalakan.

Ini Adalah​

  • Total bahan bakar mesin yang terbakar sepanjang masa pakai kendaraan (dari titik referensi ECU).
  • Dihitung secara internal oleh ECU berdasarkan model timing injeksi dan aliran.
  • Tidak bergantung pada event pengisian bahan bakar.

Interpretasi Bisnis​

  • Berguna untuk analisis performa bahan bakar dan biaya jangka panjang.
  • Paling sesuai untuk pelacakan efisiensi jangka panjang atau seumur hidup kendaraan.
  • Tidak boleh digunakan sebagai pengganti langsung untuk bahan bakar tangki saat ini.

Interpretasi untuk Developer​

  • Perlakukan sebagai counter kumulatif.
  • Hitung penggunaan pada periode tertentu dengan mengurangkan dua bacaan yang valid.
  • Wajar jika tidak ada nilai saat capability yang diperlukan tidak diaktifkan pada kendaraan.

Endpoints​

Ketersediaan​

Data fuel consumed membutuhkan capability fuel-consumed Cartrack tersedia untuk kendaraan tersebut.
Jika API tidak mengembalikan hasil, hubungi perwakilan sales Cartrack Anda untuk konfirmasi ketersediaan.

2) Fuel Level (sensor analog atau CAN bus)​

Definisi​

Fuel level adalah jumlah bahan bakar terukur di tangki pada suatu waktu, dibaca dari:

  • Sensor bahan bakar analog.
  • CAN bus.

Interpretasi Bisnis​

  • Berguna untuk pemantauan operasional, deteksi pencurian bahan bakar, dan pengawasan pengisian ulang.
  • Memberikan visibilitas kondisi tangki, bukan total bahan bakar mesin yang terbakar seumur hidup.

Interpretasi untuk Developer​

  • Perlakukan sebagai telemetri time-series.
  • Harapkan variasi karena pergerakan kendaraan, slosh, karakteristik sensor, dan sampling.

Endpoint​

Ketersediaan​

Layanan fuel level membutuhkan bacaan fuel level yang tersedia untuk kendaraan.
Jika tidak ada data yang dikembalikan, hubungi account manager sales Cartrack Anda untuk konfirmasi ketersediaan.

3) Fuel Fills dan Estimated Fuel Used (diturunkan dari fuel level)​

Definisi​

Cartrack mengidentifikasi:

  • Periode fuel fill dari kenaikan fuel level.
  • Periode estimated fuel used dari penurunan fuel level.

Kedua output diestimasi dari bacaan fuel level dan membutuhkan ketersediaan data fuel level.

Interpretasi Bisnis​

  • Membantu rekonsiliasi aktivitas pengisian bahan bakar dan pola konsumsi.
  • Mendukung analisis pengecualian (pengisian tak terduga, penggunaan yang tidak biasa).

Interpretasi untuk Developer​

  • Perlakukan sebagai analytics turunan, bukan counter ECU langsung.
  • Kualitas data bergantung pada kualitas dan cakupan sinyal fuel level.

Endpoints​

Ketersediaan​

Fuel fills dan estimated fuel used bergantung pada bacaan fuel level.
Jika tidak ada data yang dikembalikan, konfirmasikan ketersediaan fuel level pada kendaraan ke account manager sales Cartrack Anda.