Uslugi Identyfikacji Kierowcy

Ta strona wyjasnia, jak dziala przypisywanie kierowcy w Fleet API, w tym driver tags, kierowca domyslny, przypisanie przez aplikacje mobilna oraz linkage API.

Skroty i Terminy

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

Ktorego endpointu uzyc?

Ponizsze mapowanie pomaga dobrac endpoint w zaleznosci od sposobu identyfikacji kierowcy pojazdu:

• Snapshot aktualnego kierowcy dla calej floty:
  • Get Vehicle's Status: location, fuel, odometer and more
• Ustawienie lub zmiana domyslnego (fallback) kierowcy pojazdu:
  • Update a Vehicle's Details
• Audyt odczytow RFID driver tags w czasie:
  • Get Driver Tags Events
• Przypisanie kierowcy z integracji zewnetrznej (zachowanie jak RFID):
  • Link Driver to a Vehicle
• Usuniecie lub podglad powiazan utworzonych przez API:
  • Unlink Driver from a Vehicle
  • Retrieve Current Linkages

Metody Powiazywania Kierowcy

Kierowcy moga byc powiazywani z pojazdami na kilka sposobow:

1. Domyslny kierowca pojazdu:
   • Trwale/przypisanie zapasowe.
   • Uzywane, gdy nie wykryto aktywnego przypisania tymczasowego.
2. Odczyt RFID driver tag w pojezdzie (wymaga odpowiedniego fitmentu):
   • Kierowca wykonuje tag przy ignition ON.
   • Powiazanie trwa do ignition OFF lub do odczytu kolejnego tagu, ktory je nadpisze.
3. Przypisanie przez aplikacje mobilna kierowcy Cartrack:
   • Kierowca przypisuje siebie do pojazdu w aplikacji.
4. Vehicle Driver Linkage API:
   • System zewnetrzny laczy kierowce z pojazdem.
   • Przydatne do odwzorowania zachowania typu RFID po stronie integracji.

Jak Driver Tags Pomagaja Identyfikowac Kierowce

Driver tags zapewniaja operacyjny sposob identyfikacji aktualnie prowadzacego kierowcy, bez polegania tylko na statycznym/domyslnym przypisaniu pojazdu.

• Rejestruja kontekst kierowcy per uzycie podczas ignition ON.
• Moga nadpisac poprzednie przypisanie tymczasowe w tym samym cyklu zaplonu.
• Ich eventy mozna audytowac historycznie przez endpoint driver tags events.

To pomaga zwiekszyc rozliczalnosc przejazdow i raportowanie per kierowca dla pojazdow wspoldzielonych.

Rozstrzyganie Kierowcy w Vehicle Status

/vehicles/status to usluga snapshot i zwraca aktualny kontekst kierowcy dla kazdego pojazdu.

• Jesli istnieje aktywne przypisanie tymczasowe (przeplyw RFID lub linkage API), ten kierowca jest zwracany jako aktualny.
• Jesli brak aktywnego przypisania tymczasowego, domyslny kierowca pojazdu jest uzywany jako fallback.
• Powiazanie RFID jest czyszczone przy ignition OFF.

Rekomendowany Wzorzec Integracji

Dla wiekszosci integracji:

1. Ustawiaj i utrzymuj kierowcow domyslnych jako baseline.
2. Uzywaj jednego przeplywu przypisania tymczasowego do identyfikacji aktywnego kierowcy.
3. Odpytuj vehicle status dla snapshotow operacyjnych.
4. Odpytuj driver tag events dla audytu historycznego i dochodzen.

Ograniczenie Integracji

Endpointy Vehicle Driver Linkage nie powinny byc uzywane razem z innymi uslugami przypisywania kierowcy do pojazdu Cartrack (np. aplikacja mobilna kierowcy lub driver tags) w tym samym przeplywie operacyjnym.