Saltar al contenido principal

Servicios de Combustible

Esta página explica los servicios relacionados con combustible en la Fleet API para audiencias de negocio y técnicas.

Acrónimos y Términos​

  • API: Interfaz de Programación de Aplicaciones.
  • ECU: Engine Control Unit. El computador a bordo que controla y supervisa el funcionamiento del motor.
  • CAN bus: Controller Area Network bus. La red del vehículo que utilizan los módulos electrónicos para intercambiar datos.

Conceptos de Combustible en Resumen​

  • Fuel consumed: Valor acumulado del ECU que representa el combustible total quemado por el motor desde un punto de referencia.
  • Fuel level: Cantidad de combustible en el tanque, leída desde un sensor analógico o desde el CAN bus.
  • Fuel fills y estimated fuel used: Eventos y periodos de consumo inferidos a partir de tendencias del fuel level en el tiempo.

Cómo Verificar la Disponibilidad de Sensores por Vehículo​

Antes de llamar endpoints de combustible, puedes verificar si cada vehículo tiene los sensores requeridos usando:

En la respuesta, revisa data.sensors.*:

  • data.sensors.fuel_canbus_consumed: true cuando hay datos de fuel consumed desde CAN bus.
  • data.sensors.fuel_canbus_level: true cuando hay datos de fuel level desde CAN bus.
  • data.sensors.fuel_analog_level: true cuando hay un sensor analógico de fuel level instalado.
  • data.sensors.electric_battery: true cuando hay un sensor de batería eléctrica instalado.
  • data.sensors.electric_charging: true cuando hay un sensor de estado de carga eléctrica instalado.

Mapeo de Servicios de Combustible​

  • Los servicios de fuel consumed requieren data.sensors.fuel_canbus_consumed = true.
  • Los servicios de fuel level requieren al menos uno de estos flags:
    • data.sensors.fuel_canbus_level = true, o
    • data.sensors.fuel_analog_level = true.
  • Fuel fills / estimated fuel used también dependen de la disponibilidad de fuel level, por lo que requieren al menos uno de los dos flags anteriores.

Ejemplo​

{
  "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 acumulado del ECU)​

Definición​

fuel_consumed es el volumen total de combustible consumido por el motor del vehículo desde un punto de referencia definido (normalmente la puesta en servicio del vehículo o la salida de fábrica).
Es un valor acumulado monotónicamente creciente reportado por el ECU del vehículo.

Qué No Es​

  • El combustible que hay actualmente en el tanque.
  • El combustible usado solo durante un viaje.
  • El combustible usado desde que se encendió la ignición.

Qué Sí Es​

  • El total de combustible quemado por el motor durante la vida útil del vehículo (desde el punto de referencia del ECU).
  • Calculado internamente por el ECU a partir de modelos de temporización e inyección de flujo.
  • Independiente de eventos de repostaje.

Interpretación de Negocio​

  • Útil para análisis de rendimiento de combustible y costos a largo plazo.
  • Más adecuado para seguimiento de eficiencia en periodos largos o durante la vida útil del vehículo.
  • No debe usarse como sustituto directo del combustible actual en el tanque.

Interpretación para Developers​

  • Trátalo como un contador acumulado.
  • Calcula el consumo de un periodo restando dos lecturas válidas.
  • Es normal no recibir valor cuando la capacidad requerida no está habilitada en el vehículo.

Endpoints​

Disponibilidad​

Los datos de fuel consumed requieren que la capacidad fuel-consumed de Cartrack esté disponible para ese vehículo.
Si la API no devuelve resultados, contacte a su representante comercial de Cartrack para confirmar disponibilidad.

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

Definición​

Fuel level es la cantidad de combustible medida en el tanque en un momento determinado, leída desde:

  • Un sensor analógico de combustible.
  • El CAN bus.

Interpretación de Negocio​

  • Útil para monitoreo operativo, detección de robo de combustible y control de repostajes.
  • Proporciona visibilidad del estado del tanque, no del combustible total quemado por el motor durante su vida útil.

Interpretación para Developers​

  • Trátalo como telemetría de series temporales.
  • Espera variaciones por movimiento del vehículo, oscilación del combustible, características del sensor y frecuencia de muestreo.

Endpoint​

Disponibilidad​

Los servicios de fuel level requieren lecturas de fuel level disponibles para el vehículo.
Si no se devuelve información, contacte a su account manager comercial de Cartrack para confirmar disponibilidad.

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

Definición​

Cartrack identifica:

  • Periodos de fuel fill a partir de incrementos en fuel level.
  • Periodos de estimated fuel used a partir de disminuciones en fuel level.

Ambas salidas son estimadas a partir de lecturas de fuel level y requieren disponibilidad de esos datos.

Interpretación de Negocio​

  • Ayuda a conciliar actividad de repostaje y patrones de consumo.
  • Soporta análisis de excepciones (repostajes inesperados, consumos inusuales).

Interpretación para Developers​

  • Trátalos como analítica derivada, no como contadores directos del ECU.
  • La calidad de los datos depende de la calidad y cobertura de la señal de fuel level.

Endpoints​

Disponibilidad​

Fuel fills y estimated fuel used dependen de lecturas de fuel level.
Si no hay datos, confirma la disponibilidad de fuel level del vehículo con su account manager comercial de Cartrack.