Servicios de Identificacion de Conductores

Esta pagina explica como funciona la asignacion de conductores en la Fleet API, incluyendo etiquetas de conductor, conductor predeterminado, asignacion por app movil y vinculacion por API.

Acronimos y Terminos

• API: Interfaz de Programacion de Aplicaciones.
• RFID: Identificacion por Radiofrecuencia.

¿Que Endpoint Debo Usar?

Utilice este mapeo segun la forma en que desee identificar al conductor de un vehiculo:

• Snapshot del conductor actual en toda la flota:
  • Get Vehicle's Status: location, fuel, odometer and more
• Configurar o actualizar el conductor predeterminado (fallback) de un vehiculo:
  • Update a Vehicle's Details
• Auditar lecturas de etiquetas RFID en el tiempo:
  • Get Driver Tags Events
• Asignar conductor desde una integracion de terceros (comportamiento tipo RFID):
  • Link Driver to a Vehicle
• Limpiar o consultar vinculaciones creadas por API:
  • Unlink Driver from a Vehicle
  • Retrieve Current Linkages

Metodos de Asociacion de Conductores

Los conductores pueden asociarse a vehiculos de varias formas:

1. Conductor predeterminado del vehiculo:
   • Asignacion persistente/de respaldo.
   • Se usa cuando no se detecta una asignacion temporal activa.
2. Lectura de etiqueta RFID en el vehiculo (requiere fitment compatible):
   • El conductor etiqueta con el encendido en ON.
   • La asociacion permanece hasta ignition OFF, o hasta que otra etiqueta la sobrescriba.
3. Asignacion en la app movil de conductor de Cartrack:
   • El conductor se asigna a si mismo desde la aplicacion.
4. API de Vehicle Driver Linkage:
   • Un sistema de terceros vincula un conductor a un vehiculo.
   • Es util para reproducir por integracion el comportamiento tipo RFID.

Como las Etiquetas de Conductor Ayudan a Identificar al Conductor

Las etiquetas de conductor permiten identificar quien conduce actualmente, sin depender solo de la propiedad estatica/predeterminada del vehiculo.

• Capturan el contexto de conductor por uso mientras la ignicion esta en ON.
• Pueden sobrescribir un conductor temporal previo dentro del mismo ciclo de ignicion.
• Sus eventos pueden auditarse historicamente mediante el endpoint de driver tags events.

Esto ayuda a mejorar la trazabilidad de viajes y los reportes por conductor en vehiculos compartidos.

Resolucion de Conductor en Vehicle Status

/vehicles/status es un servicio snapshot y devuelve el contexto de conductor actual para cada vehiculo.

• Si existe una asociacion temporal activa (flujo RFID o flujo linkage API), ese conductor se muestra como conductor actual.
• Si no hay asociacion temporal activa, el conductor predeterminado del vehiculo se usa como valor fallback.
• La asociacion RFID se limpia en ignition OFF.

Patron de Integracion Recomendado

Para la mayoria de integraciones:

1. Define y mantiene conductores predeterminados como linea base.
2. Usa un solo flujo de asignacion temporal para identificar al conductor activo.
3. Haz polling de vehicle status para snapshots operativos.
4. Consulta driver tag events para auditoria historica e investigaciones.

Restriccion de Integracion

Los endpoints de Vehicle Driver Linkage no deben usarse junto con otros servicios de asignacion conductor-vehiculo de Cartrack (por ejemplo, app movil de conductor o driver tags) dentro del mismo flujo operativo.