Pular para o conteúdo principal

Serviços de Combustível

Esta página explica os serviços relacionados com combustível na Fleet API, tanto para equipas de negócio como para equipas técnicas.

Acrónimos e Termos​

  • API: Application Programming Interface.
  • ECU: Engine Control Unit. O computador do veículo que controla e monitoriza o funcionamento do motor.
  • CAN bus: Controller Area Network bus. A rede interna do veículo usada pelos módulos eletrónicos para troca de dados.

Conceitos de Combustível em Resumo​

  • Fuel consumed: Valor cumulativo do ECU que representa o total de combustível queimado pelo motor desde um ponto de referência.
  • Fuel level: Quantidade de combustível no depósito, lida por sensor analógico ou por CAN bus.
  • Fuel fills e estimated fuel used: Eventos e períodos de consumo inferidos com base na evolução do fuel level ao longo do tempo.

Como Verificar a Disponibilidade de Sensores por Veículo​

Antes de chamar endpoints de combustível, pode confirmar se cada veículo tem os sensores necessários através de:

Na resposta, verifique data.sensors.*:

  • data.sensors.fuel_canbus_consumed: true quando há disponibilidade de dados CAN bus para fuel consumed.
  • data.sensors.fuel_canbus_level: true quando há disponibilidade de dados CAN bus para fuel level.
  • data.sensors.fuel_analog_level: true quando existe sensor analógico de fuel level instalado.
  • data.sensors.electric_battery: true quando existe sensor de bateria elétrica instalado.
  • data.sensors.electric_charging: true quando existe sensor de estado de carregamento elétrico instalado.

Mapeamento de Serviços de Combustível​

  • Os serviços de fuel consumed exigem data.sensors.fuel_canbus_consumed = true.
  • Os serviços de fuel level exigem pelo menos um dos seguintes:
    • data.sensors.fuel_canbus_level = true, ou
    • data.sensors.fuel_analog_level = true.
  • Fuel fills / estimated fuel used também dependem de disponibilidade de fuel level, portanto exigem pelo menos um dos dois flags acima.

Exemplo​

{
  "data": {
    "vehicle_id": "123456",
    "sensors": {
      "fuel_canbus_consumed": true,
      "fuel_canbus_level": true,
      "fuel_analog_level": false,
      "electric_battery": false,
      "electric_charging": false
    }
  }
}

1) Fuel Consumed (valor cumulativo do ECU)​

Definição​

fuel_consumed é o volume total de combustível consumido pelo motor do veículo desde um ponto de referência definido (normalmente, comissionamento do veículo ou saída de fábrica).
É um valor cumulativo monotonicamente crescente reportado pelo ECU do veículo.

O que Não É​

  • Combustível atualmente no depósito.
  • Combustível usado apenas numa viagem.
  • Combustível usado desde que a ignição foi ligada.

O que É​

  • Total de combustível queimado pelo motor ao longo da vida útil do veículo (a partir do ponto de referência do ECU).
  • Calculado internamente pelo ECU com base em modelos de timing e caudal de injeção.
  • Independente de eventos de abastecimento.

Interpretação de Negócio​

  • Útil para análise de desempenho de combustível e custos no longo prazo.
  • Mais adequado para análise de eficiência ao longo de períodos longos ou do ciclo de vida do veículo.
  • Não deve ser usado como substituto direto do combustível atual no depósito.

Interpretação para Programadores​

  • Trate como um contador cumulativo.
  • Calcule consumo de um período subtraindo duas leituras válidas.
  • Pode não existir valor se a capacidade necessária não estiver ativa no veículo.

Endpoints​

Disponibilidade​

Os dados de fuel consumed exigem que a capacidade de fuel consumed da Cartrack esteja disponível para o veículo.
Se a API não devolver resultado, contacte o seu representante comercial Cartrack para confirmar disponibilidade.

2) Fuel Level (sensor analógico ou CAN bus)​

Definição​

Fuel level é a quantidade medida de combustível no depósito num determinado momento, lida a partir de:

  • Sensor analógico de combustível.
  • CAN bus.

Interpretação de Negócio​

  • Útil para monitorização operacional, deteção de furto de combustível e controlo de abastecimentos.
  • Dá visibilidade do estado do depósito, e não do consumo total de combustível queimado pelo motor.

Interpretação para Programadores​

  • Trate como telemetria temporal (time-series).
  • Espere variação devido a movimento do veículo, oscilação de combustível, características do sensor e frequência de amostragem.

Endpoint​

Disponibilidade​

Os serviços de fuel level exigem disponibilidade de leituras de fuel level para o veículo.
Se não houver dados, contacte o seu account manager comercial Cartrack para confirmar disponibilidade.

3) Fuel Fills e Estimated Fuel Used (derivados de fuel level)​

Definição​

A Cartrack identifica:

  • Períodos de fuel fill a partir de aumentos de fuel level.
  • Períodos de estimated fuel used a partir de reduções de fuel level.

Ambos os resultados são estimados a partir de leituras de fuel level e exigem disponibilidade desses dados.

Interpretação de Negócio​

  • Ajuda na reconciliação de abastecimentos e padrões de consumo.
  • Suporta análise de exceções (abastecimentos inesperados, consumo anómalo).

Interpretação para Programadores​

  • Trate estes dados como analytics derivada, e não como contadores diretos do ECU.
  • A qualidade do resultado depende da qualidade e cobertura do sinal de fuel level.

Endpoints​

Disponibilidade​

Fuel fills e estimated fuel used dependem de leituras de fuel level.
Se não houver dados, confirme a disponibilidade de fuel level do veículo com o seu account manager comercial Cartrack.