Kraftstoffschätzung API
Kraftstoffmenge und Fahrtwert aus Entfernung, beladenem Gewicht, Leer-/Volllastverbrauch und Literpreis schätzen. Separat oder im Truck-Aufruf.
/api/v1/fuel/estimate- Anfrage-Credits
- 1
- Erforderliche Berechtigungen
route
Nutzung und Grenzen
Separat 1 Credit; die optionale Truck-Schätzung ist im Routenpreis enthalten und nutzt die Straßenentfernung. Vergleichbare Leer-/Volllastwerte sind erforderlich. Lineare Lastinterpolation; Geschwindigkeit, Steigung, Verkehr, Wind und Leerlauf sind nicht modelliert. Keine validierte Fehlerquote und keine Währungsumrechnung.
So funktioniert die Kraftstoffschätzung
Geben Sie Leer- und Volllastgesamtgewicht, den beobachteten Verbrauch in L/100 km bei beiden Gewichten, das tatsächliche Gesamtgewicht, Entfernung, Literpreis und Währung an. Die Messbedingungen müssen vergleichbar sein. Das tatsächliche Gewicht muss im Kalibrierungsbereich liegen; der Volllastverbrauch darf nicht unter dem Leerverbrauch liegen.
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_literKünstliches Rechenbeispiel, keine gemessenen Fahrzeugdaten: leer 12 t bei 20 L/100 km; voll 40 t bei 34 L/100 km; tatsächlich 26 t; 500 km; 1,10 AZN/L. Ergebnis: 27 L/100 km, 135 L und 148,50 AZN. Nachkommastellen belegen keine Prognosegenauigkeit.
Fügen Sie bei Truck Routing dieses optionale fuel-Objekt zur bestehenden Anfrage hinzu. Das Gewicht stammt aus vehicle.weight_t, die Entfernung aus der berechneten Straßenroute. Keine separate Kraftstoffentfernung oder Beladung angeben. Ohne fuel bleibt die Routenantwort unverändert. Separate REST- und MCP-Schätzungen kosten 1 Credit; Kraftstoff in Truck verursacht keine zusätzlichen Credits.
{
"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"
}
}Die lineare Schätzung beruht auf Ihrer Kalibrierung. Geschwindigkeit, Steigung, Verkehr, Wind, Leerlauf und Fahrstil werden nicht modelliert. Es gibt keine validierte Fehlerquote. Sie liefern den Preis; Währungen werden nicht umgerechnet. Ergebnisse sind Schätzungen, keine Zahlung oder garantierte Kraftstoffrechnung.
MCP: estimate_fuel
Beispielanfrage
Senden Sie den API-Schlüssel im Header Authorization: Bearer. Verbrauchs- und Preiswerte sind Beispiele, keine gemessenen Fahrzeugdaten.
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[]