Yakıt Tahmin API
Mesafe, yüklü ağırlık, boş/tam yüklü tüketim ve litre fiyatıyla yakıt miktarını ve yolculuk değerini tahmin edin. Ayrı veya Truck içinde kullanın.
/api/v1/fuel/estimate- İstek kredileri
- 1
- Gerekli izinler
route
Kullanım ve sınırlar
Ayrı hesap 1 kredi; Truck seçeneği rota fiyatına dahildir ve dönen yol mesafesini kullanır. Karşılaştırılabilir boş/tam yüklü tüketim verileri gerekir. Yüke göre doğrusal tahmin; hız, eğim, trafik, rüzgâr ve rölanti modellenmez. Doğrulanmış hata oranı veya döviz dönüşümü yoktur.
Yakıt tahmini nasıl hesaplanır?
Boş ve tam yüklü toplam ağırlıkları, her iki ağırlıkta gözlenen L/100 km tüketimini, gerçek yüklü ağırlığı, mesafeyi, litre fiyatını ve para birimini gönderin. Karşılaştırılabilir koşullardaki ölçümleri kullanın. Gerçek ağırlık kalibrasyon aralığında olmalı; tam yüklü tüketim boş tüketimden düşük olamaz.
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Ölçülmüş araç verisi olmayan örnek: boş 12 t ve 20 L/100 km; tam yüklü 40 t ve 34 L/100 km; gerçek 26 t; 500 km; 1,10 AZN/L. Sonuç: 27 L/100 km, 135 L ve 148,50 AZN. Ondalık basamaklar tahmin doğruluğu anlamına gelmez.
Truck Routing için mevcut isteğe bu isteğe bağlı fuel nesnesini ekleyin. Ağırlık vehicle.weight_t alanından, mesafe dönen yol rotasından alınır; ayrı yakıt mesafesi veya yüklü ağırlık göndermeyin. fuel olmadan rota yanıtı değişmez. Ayrı REST ve MCP tahminleri 1 kredidir; Truck içinde yakıt ek kredi tüketmez.
{
"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"
}
}Bu doğrusal tahmin sizin kalibrasyonunuza dayanır. Hız, yol eğimi, trafik, rüzgâr, rölanti ve sürüş tarzı modellenmez. Doğrulanmış hata yüzdesi yoktur. Fiyatı siz sağlarsınız; kur dönüşümü yapılmaz. Sonuç tahmindir, ödeme veya garantili yakıt faturası değildir.
MCP: estimate_fuel
İstek örneği
API anahtarını Authorization: Bearer başlığında gönderin. Aşağıdaki tüketim ve fiyatlar örnektir; ölçülmüş araç verileri değildir.
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[]