osrmroute
Productos
Navegación

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.

Ejemplo ilustrativo
/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.

Fórmula de cálculo
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_liter

Ejemplo 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.

JSON · fuel
{
  "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

Detalles de Fuel Estimate API

Ejemplo de solicitud

Envíe la clave API en Authorization: Bearer. Los consumos y precios son ejemplos ilustrativos, no mediciones del vehículo.

cURL
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"}}'
Respuesta
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[]

Soporte OSRMRoute

Escriba directamente a nuestro equipo

ESTAMOS PARA AYUDAR

¿Cómo podemos ayudarle?

Envía un mensaje. Las respuestas a los tickets también se envían a tu correo verificado.

Tus chats

Tus chats aparecerán aquí.