API: Fuel Consumption

M: Listar lecturas de consumo de combustible

Límite de Tasa de Peticiones

Máximo de 20 peticiones por IP en 5 minutos

HTTP GET:

https://<hostname>/api/fuel-consumption

URL PARAMETERS:

	Nombre	Tipo	Requerido	Descripción
date	Fecha	Texto	sí	Fecha en formato YYYY-MM-DD
start_time	Hora de inicio	Texto	sí	Hora en formato HH:MM:SS
end_time	Hora de fin	Texto	sí	Hora en formato HH:MM:SS
fuel_cost	Costo de combustible	Número	no	Costo por unidad de combustible. 0 por defecto.
vehicle_ids	Lista de vehículos	Lista de números	no	Listado de ids de vehículos separados por coma. Todos por defecto.

OUTPUT:

Json con los campos:

• success: boolean
• timezone: string identificador TZ
• distance_units: "km" o "mi"
• fuel_consumption_units: "gal" o "L"
• currency_symbol: string
• summary: lista de Fuel Consumption Summary Object
• data: lista de Fuel Consumption Data Object

EJEMPLO CON CURL:

$ curl -u <api_key>:<password>
     -X GET
     https://<hostname>/api/fuel-consumption?date=2019-03-01&start_time=00:00&end_time=23:59&fuel_cost=7.7

RESPUESTA:

{
    "success": true,
    "timezone": "America/Guatemala",
    "distance_uom": "km",
    "fuel_consumption_uom": "gal",
    "currency_symbol": "Q",
    "summary": [
        {
            "vehicle_id": 364,
            "cost_by_distance": 3872.6,
            "cost_by_time": 5757.5,
            "efficiency": 0,
            "fuel_consumed": 7795.5,
            "fuel_expense": 60025.35,
            "ignition_on_hours": 10.4,
            "distance": 15.5,
            "sensor_type": "volume"
        },
    ]
}

O: Fuel Consumption Summary Object

Cada objeto de resumen de consumo de combustible tiene estos campos:

Campo	Tipo	Descripción
vehicle_id	Número	Id del vehículo.
cost_by_distance	Número	Costo promedio por unidad de distancia.
cost_by_time	Número	Costo promedio por unidad de tiempo.
efficiency	Número	Distancia entre combustible consumido.
fuel_consumed	Número	Combustible consumido.
fuel_expense	Número	Gasto de combusitble.
ignition_on_hours	Número	Tiempo de motor encendido en horas.
distance	Número	Distancia recorrida.
sensor_type	"consumption" o "volume"	Tipo del sensor que mandó la lectura.