Custo de combustível da viagem

Informe distância, economia e preço para obter fuel_needed e fuel_cost em JSON estável para orçamentos, ferramentas de frota e apps de viagem.

Como o custo de combustível é calculado a partir de distância, economia e preço

O volume de combustível de uma jornada é a distância dividida pela economia quando a economia se escreve como distância por unidade de combustível. Uma viagem de trezentas milhas em um veículo de trinta milhas por galão precisa de dez galões; a três dólares e cinquenta centavos por galão o custo de combustível é trinta e cinco dólares. A mesma identidade funciona no métrico: duzentos quilômetros a dez quilômetros por litro precisam de vinte litros, vezes o preço do litro. Mantenha unidades coerentes—não misture milhas com quilômetros por litro sem converter antes. Envie os campos obrigatórios distance, fuel_economy e fuel_price como números JSON ou strings numéricas. Os aliases miles, km, trip_distance e d mapeiam para distance; economy, mpg, km_per_l, efficiency e fuel_efficiency mapeiam para fuel_economy; price, price_per_unit, gas_price e fuel_unit_price mapeiam para o preço unitário. Distância não positiva e fuel_economy não positivo são erros duros sob o contrato do produto porque dividiriam por zero ou inventariam um enchimento de tanque negativo. fuel_price negativo é igualmente rejeitado. Limites de magnitude mantêm resultados finitos no isolate Worker. Entradas idênticas sempre produzem o mesmo JSON: aritmética pura, sem rede, sem semente aleatória e sem relógio de parede.

Lendo os campos da resposta e escolhendo entradas realistas

O campo formula é seguro para mostrar ao lado dos números para os usuários verem que combustível é distância sobre economia e custo é combustível vezes preço. Prefira a economia média real a números otimistas de brochure quando a estrada incluir subidas, partidas a frio ou velocidades de rodovia. Em sucesso a resposta ecoa distance, fuel_economy e fuel_price após arredondamento estável, mais fuel_needed, fuel_cost, uma string formula legível e method igual a distance_over_economy_times_price. Use fuel_needed quando se importar com capacidade do tanque, ansiedade de autonomia ou quantas paradas precisa; use fuel_cost ao orçar um passeio de férias, reembolsar quilometragem só de combustível ou comparar carros a um preço de bomba dado. Este endpoint não modela elevação, trânsito ou vento; é uma checagem aritmética transparente, não um motor de rotas. A moeda é a unidade que você usa para fuel_price; o motor é agnóstico a unidades e não converte dólares em euros. Campos obrigatórios ausentes, valores não finitos e distância ou economia não positivas falham com invalid_input e não são cobrados após o motor rejeitar a requisição.

Uso da API, preços, fluxos de viagem e limites práticos

Chame o estimador grátis no navegador para planejamento de férias, demos de sala e comparações rápidas de carros sem instalar planilha. Envie um corpo JSON com distance, fuel_economy e fuel_price (ou os aliases documentados). Use a API pré-paga quando um portal de viagens, painel de frota, app de despesas ou ferramenta de reservas precisar de um contrato estável sob saldo KIT a US$ 0,002 por item bem-sucedido; falhas de validação nunca consomem saldo. Combine este endpoint com um conversor de unidade de preço de combustível quando a cotação da bomba for por litro mas sua economia estiver em milhas por galão—converta o preço primeiro, depois chame aqui com unidades combinando. Para itinerários multi-trecho, some fuel_cost no cliente ou chame uma vez por trecho para cada segmento permanecer auditável. Autores que enviam SDKs podem mapear fuel_needed e fuel_cost em tabelas que mostrem volume e dinheiro lado a lado—a mesma forma que motoristas veem em uma folha simples de orçamento de viagem.