API estimation de carburant
Estimez le carburant et sa valeur avec distance, poids chargé, consommations à vide/pleine charge et prix au litre. Seule ou dans Truck.
/api/v1/fuel/estimate- Crédits par requête
- 1
- Autorisations requises
route
Utilisation et limites
1 crédit séparément; option Truck incluse dans le prix du trajet, avec sa distance routière. Références à vide/pleine charge comparables requises. Interpolation linéaire de charge; vitesse, pente, trafic, vent et ralenti non modélisés. Pas de marge d’erreur validée ni de conversion de devise.
Comment fonctionne l’estimation de carburant
Indiquez les masses totales à vide et à pleine charge, les consommations observées en L/100 km aux deux masses, la masse réelle, la distance, le prix au litre et la devise. Les conditions de mesure doivent être comparables. La masse réelle doit rester dans la plage d’étalonnage ; la consommation à pleine charge ne peut pas être inférieure à celle à vide.
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_literExemple fictif, sans mesures réelles du véhicule : à vide 12 t à 20 L/100 km ; pleine charge 40 t à 34 L/100 km ; masse réelle 26 t ; 500 km ; 1,10 AZN/L. Résultat : 27 L/100 km, 135 L et 148,50 AZN. Les décimales ne prouvent pas la précision de la prévision.
Pour Truck Routing, ajoutez cet objet fuel facultatif à la requête existante. La masse vient de vehicle.weight_t et la distance de l’itinéraire routier retourné ; ne transmettez pas de distance ni de masse distincte pour le carburant. Sans fuel, la réponse reste identique. Une estimation REST ou MCP séparée coûte 1 crédit ; le carburant dans Truck ne coûte aucun crédit supplémentaire.
{
"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"
}
}Cette estimation linéaire repose sur votre étalonnage. Vitesse, pente, trafic, vent, ralenti et style de conduite ne sont pas modélisés. Aucun pourcentage d’erreur n’est validé. Vous fournissez le prix ; aucune conversion de devise. Le résultat est une estimation, pas un paiement ni une facture garantie.
MCP: estimate_fuel
Exemple de requête
Envoyez la clé API dans l’en-tête Authorization: Bearer. Les consommations et prix ci-dessous sont illustratifs, pas des mesures du véhicule.
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[]