Skip to main content

Fuel Services

หน้านี้อธิบายบริการด้านเชื้อเพลิงใน Fleet API สำหรับทั้งผู้ใช้งานเชิงธุรกิจและผู้พัฒนา

Acronyms and Terms​

  • API: Application Programming Interface
  • ECU: Engine Control Unit คอมพิวเตอร์ในรถที่ควบคุมและตรวจสอบการทำงานของเครื่องยนต์
  • CAN bus: Controller Area Network bus เครือข่ายภายในรถที่โมดูลอิเล็กทรอนิกส์ใช้สื่อสารกัน

Fuel Concepts at a Glance​

  • Fuel consumed: ค่าแบบสะสมจาก ECU ที่แสดงปริมาณเชื้อเพลิงรวมที่เครื่องยนต์เผาไหม้ตั้งแต่จุดอ้างอิง
  • Fuel level: ปริมาณเชื้อเพลิงในถัง วัดจาก analog sensor หรือจาก CAN bus
  • Fuel fills and estimated fuel used: เหตุการณ์เติมน้ำมันและช่วงเวลาการใช้เชื้อเพลิงโดยประมาณ ที่อนุมานจากแนวโน้มของ fuel level

How to Check Sensor Availability Per Vehicle​

ก่อนเรียกใช้งาน fuel endpoints คุณสามารถตรวจสอบได้ว่าแต่ละคันมี sensors ที่ต้องใช้หรือไม่ โดยใช้:

ใน response ให้ตรวจสอบ data.sensors.*:

  • data.sensors.fuel_canbus_consumed: เป็น true เมื่อมีข้อมูล fuel consumed จาก CAN bus
  • data.sensors.fuel_canbus_level: เป็น true เมื่อมีข้อมูล fuel level จาก CAN bus
  • data.sensors.fuel_analog_level: เป็น true เมื่อรถติดตั้ง analog fuel sensor
  • data.sensors.electric_battery: เป็น true เมื่อรถติดตั้ง electric battery sensor
  • data.sensors.electric_charging: เป็น true เมื่อรถติดตั้ง electric charging status sensor

Fuel Service Mapping​

  • บริการ fuel consumed ต้องมี data.sensors.fuel_canbus_consumed = true
  • บริการ fuel level ต้องมีอย่างน้อยหนึ่งเงื่อนไขต่อไปนี้:
    • data.sensors.fuel_canbus_level = true, หรือ
    • data.sensors.fuel_analog_level = true
  • Fuel fills / estimated fuel used ก็ขึ้นกับความพร้อมของ fuel level เช่นกัน ดังนั้นต้องมีอย่างน้อยหนึ่ง flag จากสองตัวด้านบน

Example​

{
  "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 (ECU cumulative value)​

Definition​

fuel_consumed คือปริมาณเชื้อเพลิงรวมที่เครื่องยนต์ของรถใช้ไปตั้งแต่จุดอ้างอิงที่กำหนด (โดยทั่วไปคือช่วงเริ่มใช้งานรถหรือจากโรงงาน)
เป็นค่า cumulative ที่เพิ่มขึ้นทางเดียว (monotonic) และรายงานโดย ECU ของรถ

What It Is Not​

  • ไม่ใช่ปริมาณน้ำมันที่เหลือในถังปัจจุบัน
  • ไม่ใช่เชื้อเพลิงที่ใช้ในทริปเดียว
  • ไม่ใช่เชื้อเพลิงที่ใช้ตั้งแต่เปิด ignition

What It Is​

  • เป็นเชื้อเพลิงรวมที่เครื่องยนต์เผาไหม้ตลอดอายุการใช้งานรถ (จาก ECU reference point)
  • ECU คำนวณภายในจาก injection timing / flow models
  • ไม่ขึ้นกับเหตุการณ์เติมน้ำมัน

Business Interpretation​

  • เหมาะสำหรับวิเคราะห์ประสิทธิภาพเชื้อเพลิงและต้นทุนในระยะยาว
  • เหมาะกับการติดตาม efficiency ในช่วงเวลายาวหรือตลอดอายุรถ
  • ไม่ควรใช้แทนค่าปริมาณน้ำมันในถัง ณ ปัจจุบัน

Developer Interpretation​

  • ควรมองเป็น cumulative counter
  • การคำนวณการใช้เชื้อเพลิงในช่วงเวลา ให้ใช้การลบระหว่างสองค่าที่ถูกต้อง
  • อาจไม่มีค่า หากรถยังไม่เปิดใช้ capability ที่จำเป็น

Endpoints​

Availability​

ข้อมูล fuel consumed ต้องอาศัย capability ด้าน fuel consumed ของ Cartrack ที่พร้อมใช้งานในรถคันนั้น
หาก API ไม่ส่งค่ากลับมา กรุณาติดต่อผู้แทนฝ่ายขาย Cartrack เพื่อยืนยันความพร้อมใช้งาน

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

Definition​

Fuel level คือค่าปริมาณเชื้อเพลิงในถัง ณ เวลาหนึ่ง ซึ่งอ่านได้จาก:

  • analog fuel sensor
  • CAN bus

Business Interpretation​

  • มีประโยชน์สำหรับ monitoring การปฏิบัติงาน การตรวจจับการขโมยน้ำมัน และการกำกับการเติมน้ำมัน
  • ช่วยให้เห็นสถานะน้ำมันในถัง ไม่ใช่ค่าเชื้อเพลิงที่เผาไหม้สะสมตลอดอายุรถ

Developer Interpretation​

  • ควรมองเป็น time-series telemetry
  • ค่าที่ได้อาจแปรผันตามการเคลื่อนที่ การสั่นของน้ำมัน คุณลักษณะเซนเซอร์ และความถี่การเก็บข้อมูล

Endpoint​

Availability​

บริการ fuel level ต้องมีข้อมูล fuel level ของรถคันนั้นพร้อมใช้งาน
หากไม่พบข้อมูล กรุณาติดต่อ Cartrack sales account manager ของคุณเพื่อยืนยันความพร้อมใช้งาน

3) Fuel Fills and Estimated Fuel Used (derived from fuel level)​

Definition​

Cartrack ระบุ:

  • Fuel fill periods จากช่วงที่ fuel level เพิ่มขึ้น
  • Estimated fuel used periods จากช่วงที่ fuel level ลดลง

ทั้งสองผลลัพธ์เป็นค่าประมาณที่คำนวณจาก fuel level readings และต้องอาศัยความพร้อมของข้อมูล fuel level

Business Interpretation​

  • ช่วยตรวจสอบความสอดคล้องของการเติมน้ำมันและรูปแบบการใช้งานเชื้อเพลิง
  • รองรับการวิเคราะห์ความผิดปกติ (เติมผิดปกติ ใช้งานผิดปกติ)

Developer Interpretation​

  • ควรถือว่าเป็น derived analytics ไม่ใช่ ECU counter โดยตรง
  • คุณภาพข้อมูลขึ้นกับคุณภาพและความต่อเนื่องของสัญญาณ fuel level

Endpoints​

Availability​

Fuel fills และ estimated fuel used ขึ้นกับ fuel level readings
หากไม่พบข้อมูล กรุณายืนยันความพร้อมของ fuel level สำหรับรถคันนั้นกับ Cartrack sales account manager ของคุณ