Servicos de Identificacao de Condutor

Esta pagina explica como funciona a atribuicao de condutores na Fleet API, incluindo driver tags, condutor predefinido, atribuicao na app movel e vinculacao por API.

Acronimos e Termos

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

Que Endpoint Devo Usar?

Use este mapeamento de acordo com a forma como pretende identificar o condutor de um veiculo:

• Snapshot do condutor atual em toda a frota:
  • Get Vehicle's Status: location, fuel, odometer and more
• Definir ou atualizar o condutor predefinido (fallback) de um veiculo:
  • Update a Vehicle's Details
• Auditar leituras de RFID driver tags ao longo do tempo:
  • Get Driver Tags Events
• Atribuir condutor a partir de uma integracao de terceiros (comportamento tipo RFID):
  • Link Driver to a Vehicle
• Limpar ou consultar vinculacoes criadas por API:
  • Unlink Driver from a Vehicle
  • Retrieve Current Linkages

Metodos de Associacao de Condutores

Os condutores podem associar-se a veiculos de varias formas:

1. Condutor predefinido no veiculo:
   • Atribuicao persistente/de fallback.
   • Usada quando nao e detetada qualquer atribuicao temporaria ativa.
2. Leitura de RFID driver tag no veiculo (requer fitment especial):
   • O condutor faz tag com a ignicao em ON.
   • A associacao mantem-se ate ignition OFF, ou ate outra tag sobrepor a anterior.
3. Atribuicao pela app movel de condutor Cartrack:
   • O condutor atribui-se a si proprio ao veiculo na aplicacao.
4. Vehicle Driver Linkage API:
   • Um sistema de terceiros vincula um condutor a um veiculo.
   • Util para reproduzir por integracao o comportamento tipo RFID.

Como os Driver Tags Ajudam a Identificar o Condutor

Os driver tags oferecem uma forma operacional de identificar quem esta a conduzir no momento, sem depender apenas da atribuicao estatica/predefinida do veiculo.

• Capturam o contexto de condutor por utilizacao enquanto a ignicao esta em ON.
• Podem sobrepor um condutor temporario previamente atribuido no mesmo ciclo de ignicao.
• Os seus eventos podem ser auditados historicamente no endpoint de driver tags events.

Isto ajuda a melhorar a responsabilizacao das viagens e o reporting por condutor em veiculos partilhados.

Resolucao do Condutor no Vehicle Status

/vehicles/status e um servico de snapshot e devolve o contexto de condutor atual para cada veiculo.

• Se existir uma associacao temporaria ativa (fluxo RFID ou fluxo linkage API), esse condutor e apresentado como condutor atual.
• Se nao existir associacao temporaria ativa, o condutor predefinido do veiculo e usado como valor fallback.
• A associacao RFID e limpa em ignition OFF.

Padrao de Integracao Recomendado

Para a maioria das integracoes:

1. Defina e mantenha condutores predefinidos como baseline.
2. Use um unico fluxo de atribuicao temporaria para identificacao do condutor ativo.
3. Faca polling de vehicle status para snapshots operacionais.
4. Consulte driver tag events para auditoria historica e investigacoes.

Restricao de Integracao

Os endpoints de Vehicle Driver Linkage nao devem ser usados em conjunto com outros servicos Cartrack de atribuicao condutor-veiculo (por exemplo, app movel de condutor ou driver tags) no mesmo fluxo operacional.