Layanan Identifikasi Pengemudi

Halaman ini menjelaskan cara kerja penugasan pengemudi di Fleet API, termasuk driver tag, pengemudi default, penugasan lewat aplikasi seluler, dan linkage API.

Akronim dan Istilah

• API: Application Programming Interface.
• RFID: Radio-Frequency Identification.

Endpoint Mana yang Harus Digunakan?

Gunakan pemetaan ini berdasarkan cara Anda ingin mengidentifikasi pengemudi pada kendaraan:

• Snapshot pengemudi aktif saat ini untuk seluruh armada:
  • Get Vehicle's Status: location, fuel, odometer and more
• Menetapkan atau memperbarui pengemudi default (fallback) kendaraan:
  • Update a Vehicle's Details
• Audit riwayat pembacaan RFID driver tag:
  • Get Driver Tags Events
• Menugaskan pengemudi dari integrasi pihak ketiga (perilaku seperti RFID):
  • Link Driver to a Vehicle
• Menghapus atau melihat linkage yang dibuat via API:
  • Unlink Driver from a Vehicle
  • Retrieve Current Linkages

Metode Asosiasi Pengemudi

Pengemudi dapat diasosiasikan ke kendaraan dengan beberapa cara:

1. Pengemudi default pada kendaraan:
   • Penugasan persisten/fallback.
   • Digunakan ketika tidak ada penugasan sementara yang terdeteksi.
2. Pembacaan RFID driver tag di kendaraan (memerlukan fitment khusus):
   • Pengemudi melakukan tag saat ignition ON.
   • Asosiasi tetap aktif sampai ignition OFF, atau ditimpa oleh tag pengemudi lain.
3. Penugasan melalui aplikasi mobile driver Cartrack:
   • Pengemudi menugaskan dirinya sendiri ke kendaraan di aplikasi.
4. Vehicle Driver Linkage API:
   • Sistem pihak ketiga menautkan pengemudi ke kendaraan.
   • Berguna untuk meniru perilaku seperti RFID melalui integrasi.

Bagaimana Driver Tag Membantu Mengidentifikasi Pengemudi

Driver tag memberikan cara operasional untuk mengidentifikasi siapa yang sedang mengemudi, tanpa hanya mengandalkan kepemilikan kendaraan yang statis/default.

• Tag menangkap konteks pengemudi per penggunaan saat ignition ON.
• Tag dapat menimpa pengemudi sementara yang sebelumnya aktif pada siklus ignition yang sama.
• Event tag dapat diaudit secara historis melalui endpoint driver tags events.

Ini membantu meningkatkan akuntabilitas trip dan pelaporan berbasis pengemudi untuk kendaraan bersama.

Resolusi Pengemudi di Vehicle Status

/vehicles/status adalah layanan snapshot yang mengembalikan konteks pengemudi saat ini untuk setiap kendaraan.

• Jika ada asosiasi sementara yang aktif (alur RFID atau linkage API), pengemudi tersebut ditampilkan sebagai pengemudi saat ini.
• Jika tidak ada asosiasi sementara yang aktif, pengemudi default kendaraan digunakan sebagai nilai fallback.
• Asosiasi RFID akan dihapus saat ignition OFF.

Pola Integrasi yang Direkomendasikan

Untuk sebagian besar integrasi:

1. Tetapkan dan pelihara pengemudi default sebagai baseline.
2. Gunakan satu alur penugasan sementara untuk identifikasi pengemudi aktif.
3. Poll vehicle status untuk snapshot operasional.
4. Query driver tag events untuk audit historis dan investigasi.

Batasan Integrasi

Endpoint Vehicle Driver Linkage tidak boleh digunakan bersamaan dengan layanan penugasan pengemudi-kendaraan Cartrack lainnya (misalnya aplikasi mobile driver atau driver tags) dalam alur operasional yang sama.