API оценки расхода топлива
Оцените топливо и стоимость поездки по расстоянию, фактической массе, расходу без груза/с полной загрузкой и цене за литр. Отдельно или в Truck.
/api/v1/fuel/estimate- Кредиты за запрос
- 1
- Необходимые разрешения
route
Использование и ограничения
Отдельный расчет: 1 кредит; опция Truck включена в цену маршрута и использует дорожное расстояние. Нужны сопоставимые показатели расхода без груза/с полной загрузкой. Линейная интерполяция по массе; скорость, уклон, трафик, ветер и холостой ход не моделируются. Подтвержденной погрешности и конвертации валют нет.
Как рассчитывается расход топлива
Передайте полную массу пустой и полностью загруженной машины, наблюдаемый расход в л/100 км для обеих масс, фактическую массу, расстояние, цену литра и валюту. Условия измерений должны быть сопоставимы. Фактическая масса должна лежать в диапазоне калибровки; расход при полной загрузке не может быть ниже расхода пустой машины.
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Условный пример, а не измерения автомобиля: пустой 12 т при 20 л/100 км; полный 40 т при 34 л/100 км; фактически 26 т; 500 км; 1,10 AZN/л. Результат: 27 л/100 км, 135 л и 148,50 AZN. Число знаков после запятой не означает точность прогноза.
В Truck Routing добавьте этот необязательный объект fuel к существующему запросу. Масса берётся из vehicle.weight_t, расстояние — из рассчитанного дорожного маршрута. Отдельные расстояние и массу для топлива передавать нельзя. Без fuel ответ маршрута не меняется. Отдельный расчёт REST или MCP стоит 1 кредит; топливо внутри Truck не требует дополнительных кредитов.
{
"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"
}
}Линейная оценка основана на вашей калибровке. Скорость, уклон, трафик, ветер, холостой ход и стиль вождения не учитываются. Подтверждённого процента погрешности нет. Цену задаёте вы; конвертации валют нет. Результат — оценка, а не платёж или гарантированный счёт за топливо.
MCP: estimate_fuel
Пример запроса
Передайте API-ключ в заголовке Authorization: Bearer. Расход и цена ниже приведены для примера и не являются измеренными данными автомобиля.
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[]