API de estimación de combustible
Estime combustible y valor del viaje con distancia, peso cargado, consumos en vacío/plena carga y precio por litro. Por separado o en Truck.
/api/v1/fuel/estimate- Créditos por solicitud
- 1
- Permisos necesarios
route
Uso y límites
1 crédito por cálculo separado; opción Truck incluida en el precio de ruta con distancia vial. Requiere consumos vacío/plena carga comparables. Interpolación lineal de carga; no modela velocidad, pendientes, tráfico, viento ni ralentí. Sin error validado ni conversión de moneda.
Cómo funciona la estimación de combustible
Envíe los pesos brutos en vacío y a plena carga, el consumo observado en L/100 km con ambos pesos, el peso real, la distancia, el precio por litro y la moneda. Use mediciones en condiciones comparables. El peso real debe estar dentro del intervalo de calibración; el consumo a plena carga no puede ser inferior al de vacío.
load_ratio = (loaded_weight_t - empty_weight_t) / (full_weight_t - empty_weight_t)
L_per_100km = empty_l_per_100km + load_ratio * (full_l_per_100km - empty_l_per_100km)
fuel_liters = distance_km * L_per_100km / 100
fuel_cost = fuel_liters * price_per_literEjemplo ficticio, no mediciones de un vehículo: vacío 12 t y 20 L/100 km; lleno 40 t y 34 L/100 km; real 26 t; 500 km; 1,10 AZN/L. Resultado: 27 L/100 km, 135 L y 148,50 AZN. Los decimales no indican precisión predictiva.
En Truck Routing, añada este objeto fuel opcional a la solicitud existente. El peso procede de vehicle.weight_t y la distancia de la ruta vial devuelta; no envíe distancia ni peso separados para el combustible. Sin fuel, la respuesta no cambia. Cada estimación REST o MCP independiente cuesta 1 crédito; añadir combustible a Truck no consume créditos adicionales.
{
"fuel": {
"empty_weight_t": 12,
"full_weight_t": 40,
"empty_l_per_100km": 20,
"full_l_per_100km": 34,
"price_per_liter": "1.10",
"currency": "AZN"
}
}Esta estimación lineal se basa en su calibración. No se modelan velocidad, pendiente, tráfico, viento, ralentí ni estilo de conducción. No hay un porcentaje de error validado. Usted aporta el precio; no se convierten monedas. El resultado es una estimación, no un pago ni una factura garantizada.
MCP: estimate_fuel
Ejemplo de solicitud
Envíe la clave API en Authorization: Bearer. Los consumos y precios son ejemplos ilustrativos, no mediciones del vehículo.
curl --fail-with-body -X POST "https://osrmroute.com/api/v1/fuel/estimate" \
-H "Authorization: Bearer $OSRMROUTE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"distance_km":500,"loaded_weight_t":26,"fuel":{"empty_weight_t":12,"full_weight_t":40,"empty_l_per_100km":20,"full_l_per_100km":34,"price_per_liter":"1.10","currency":"AZN"}}'method: user_calibrated_linear_load_v1
estimated: true
distance_km
loaded_weight_t
consumption_l_per_100km
fuel_liters
fuel_cost.amount (decimal string)
fuel_cost.currency
accuracy.validated_error_percent: null
basis
exclusions[]