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 TZdistance_units
:"km"
o"mi"
fuel_consumption_units
:"gal"
o"L"
currency_symbol
:string
summary
: lista de Fuel Consumption Summary Objectdata
: 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. |