API de estimativa de combustível
Estime combustível e valor da viagem com distância, peso carregado, consumos vazio/carga total e preço por litro. Separada ou no Truck.
/api/v1/fuel/estimate- Créditos por pedido
- 1
- Permissões necessárias
route
Utilização e limites
1 crédito separadamente; opção Truck incluída no preço da rota com distância rodoviária. Exige consumos vazio/carga total comparáveis. Interpolação linear de carga; velocidade, inclinação, trânsito, vento e marcha lenta não são modelados. Sem erro validado ou conversão monetária.
Como funciona a estimativa de combustível
Informe as massas brutas em vazio e com carga total, o consumo observado em L/100 km nas duas massas, a massa real, a distância, o preço por litro e a moeda. Use medições em condições comparáveis. A massa real deve estar no intervalo de calibração; o consumo com carga total não pode ser inferior ao consumo em vazio.
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_literExemplo fictício, sem medições reais do veículo: vazio 12 t a 20 L/100 km; cheio 40 t a 34 L/100 km; real 26 t; 500 km; 1,10 AZN/L. Resultado: 27 L/100 km, 135 L e 148,50 AZN. As casas decimais não comprovam a precisão da previsão.
No Truck Routing, adicione este objeto fuel opcional ao pedido existente. A massa vem de vehicle.weight_t e a distância da rota rodoviária devolvida; não envie distância nem massa separadas para o combustível. Sem fuel, a resposta não muda. Cada estimativa REST ou MCP separada custa 1 crédito; o combustível em Truck não consome créditos adicionais.
{
"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"
}
}Esta estimativa linear baseia-se na sua calibração. Velocidade, inclinação, trânsito, vento, marcha lenta e estilo de condução não são modelados. Não há percentagem de erro validada. O preço é fornecido por si; não há conversão de moedas. O resultado é uma estimativa, não um pagamento nem uma fatura garantida.
MCP: estimate_fuel
Exemplo de pedido
Envie a chave API em Authorization: Bearer. Os consumos e preços são exemplos ilustrativos, não medições do veículo.
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[]