osrmroute
Продукты
Навигация

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 не требует дополнительных кредитов.

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"
  }
}

Линейная оценка основана на вашей калибровке. Скорость, уклон, трафик, ветер, холостой ход и стиль вождения не учитываются. Подтверждённого процента погрешности нет. Цену задаёте вы; конвертации валют нет. Результат — оценка, а не платёж или гарантированный счёт за топливо.

MCP: estimate_fuel

Подробнее о Fuel Estimate API

Пример запроса

Передайте API-ключ в заголовке Authorization: Bearer. Расход и цена ниже приведены для примера и не являются измеренными данными автомобиля.

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"}}'
Ответ
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[]

Поддержка OSRMRoute

Напишите нашей команде напрямую

МЫ ГОТОВЫ ПОМОЧЬ

Чем вам помочь?

Напишите нам. Ответы на обращения также отправляются на подтверждённую почту.

Ваши чаты

Ваши чаты появятся здесь.