บริการการระบุตัวตนผู้ขับขี่
หน้านี้อธิบายการทำงานของการกำหนดผู้ขับขี่ใน Fleet API รวมถึง driver tags, ผู้ขับขี่ค่าเริ่มต้น, การกำหนดผ่านแอปมือถือ และการเชื่อมโยงผ่าน API
Acronyms and Terms
- API: Application Programming Interface.
- RFID: Radio-Frequency Identification.
Which Endpoint Should I Use?
ใช้ mapping นี้ตามวิธีที่คุณต้องการระบุตัวตนผู้ขับขี่ของรถ:
- ดู snapshot ผู้ขับขี่ปัจจุบันทั้งฟลีท:
- ตั้งค่าหรืออัปเดตผู้ขับขี่ค่าเริ่มต้น (fallback) ของรถ:
- ตรวจสอบย้อนหลังเหตุการณ์อ่าน RFID driver tag:
- กำหนดผู้ขับขี่จากระบบภายนอก (พฤติกรรมแบบ RFID):
- ล้างห รือดูรายการ linkage ที่สร้างผ่าน API:
วิธีการผูกผู้ขับขี่กับรถ
ผู้ขับขี่สามารถผูกกับรถได้หลายวิธี:
- ผู้ขับขี่ค่าเริ่มต้นของรถ:
- เป็นการกำหนดแบบถาวร/สำรอง
- ใช้เมื่อไม่พบการกำหนดแบบชั่วคราวที่กำลังทำงานอยู่
- การอ่าน RFID driver tag ในรถ (ต้องมีการติดตั้งรองรับ):
- ผู้ขับขี่ทำการ tag ขณะ ignition ON
- การผูกจะคงอยู่จน ignition OFF หรือมี tag ใหม่มาแทนที่
- การกำหนดผ่าน Cartrack driver mobile app:
- ผู้ขับขี่กำหนดตัวเองกับรถในแอป
- Vehicle Driver Linkage API:
- ระบบภายนอกเชื่อมผู้ขับขี่เข้ากับรถ
- เหมาะสำหรับจำลองพฤติกรรมแบบ RFID จากบริการภายนอก
Driver Tags ช่วยระบุตัวตนผู้ขับขี่อย่างไร
Driver tags ช่วยระบุตัวตนผู้ขับขี่ที่กำลังขับอยู่จริงในเชิงปฏิบัติการ โดยไม่พึ่งเฉพาะการกำหนดเจ้าของรถแบบคงที่/ค่าเริ่มต้น
- เก็บบริบทผู้ขับขี่ตามการใช้งานในช่วงที่ ignition ON
- สามารถแทนที่ผู้ขับขี่ชั่วคราวคนก่อนหน้าในรอบ ignition เดียวกัน
- ตรวจสอบย้อนหลังเหตุการณ์ได้ผ่าน endpoint driver tags events
สิ่งนี้ช่วยเพิ่มความชัดเจนด้ านความรับผิดชอบของทริปและการรายงานระดับผู้ขับขี่สำหรับรถที่ใช้งานร่วมกัน
การเลือกผู้ขับขี่ใน Vehicle Status
/vehicles/status เป็นบริการแบบ snapshot ที่คืนค่าบริบทผู้ขับขี่ปัจจุบันของแต่ละรถ
- ถ้ามีการผูกแบบชั่วคราวที่กำลังใช้งานอยู่ (RFID flow หรือ linkage API flow) ระบบจะแสดงผู้ขับขี่คนนั้นเป็นผู้ขับขี่ปัจจุบัน
- ถ้าไม่มีการผูกแบบชั่วคราว ระบบจะใช้ผู้ขับขี่ค่าเริ่มต้นของรถเป็นค่า fallback
- การผูกแบบ RFID จะถูกล้างเมื่อ ignition OFF
รูปแบบการเชื่อมต่อที่แนะนำ
สำหรับการเชื่อมต่อส่วนใหญ่:
- ตั้งค่าและดูแลผู้ขับขี่ค่าเริ่มต้นเป็น baseline
- ใช้เพียงหนึ่ง flow สำหรับการกำหนดผู้ขับขี่ชั่วคราวเพื่อระบุตัวผู้ขับขี่ที่กำลังใช้งาน
- ทำ polling ที่ vehicle status เพื่อรับ snapshot การปฏิบัติการ
- Query driver tag events สำหรับการตรวจสอบย้อนหลังและการสืบค้น
ข้อจำกัดการเชื่อมต่อ
ไม่ควรใช้ Vehicle Driver Linkage endpoints ร่วมกับบริการกำหนดผู้ขับขี่-รถแบบอื่นของ Cartrack (เช่น driver mobile app หรือ driver tags) ภายใน flow การทำงานเดียวกัน