Coste de combustible del viaje

Introduzca distancia, consumo y precio para obtener fuel_needed y fuel_cost en JSON estable para presupuestos, herramientas de flota y apps de viaje.

Cómo se calcula el coste de combustible a partir de distancia, consumo y precio

El volumen de combustible de un trayecto es la distancia dividida por el consumo cuando el consumo se escribe como distancia por unidad de combustible. Un viaje de trescientas millas en un vehículo de treinta millas por galón necesita diez galones; a tres dólares y cincuenta céntimos por galón el coste de combustible es treinta y cinco dólares. La misma identidad funciona en métrico: doscientos kilómetros a diez kilómetros por litro necesitan veinte litros, por el precio del litro. Mantenga unidades coherentes—no mezcle millas con kilómetros por litro sin convertir antes. Envíe los campos obligatorios distance, fuel_economy y fuel_price como números JSON o cadenas numéricas. Los alias miles, km, trip_distance y d se asignan a distance; economy, mpg, km_per_l, efficiency y fuel_efficiency se asignan a fuel_economy; price, price_per_unit, gas_price y fuel_unit_price se asignan al precio unitario. Una distancia no positiva y un fuel_economy no positivo son errores duros bajo el contrato del producto porque dividirían por cero o inventarían un llenado de depósito negativo. Un fuel_price negativo se rechaza igual. Los topes de magnitud mantienen los resultados finitos en el isolate Worker. Entradas idénticas producen siempre el mismo JSON: aritmética pura, sin red, sin semilla aleatoria y sin reloj de pared.

Lectura de los campos de respuesta y elección de entradas realistas

El campo formula es seguro para mostrar junto a los números de modo que los usuarios vean que el combustible es distancia sobre consumo y el coste es combustible por precio. Prefiera el consumo medio real a las cifras optimistas de folleto cuando la carretera incluya cuestas, arranques en frío o velocidades de autopista. En éxito la respuesta repite distance, fuel_economy y fuel_price tras un redondeo estable, más fuel_needed, fuel_cost, una cadena formula legible y method igual a distance_over_economy_times_price. Use fuel_needed cuando le importe la capacidad del depósito, la ansiedad de autonomía o cuántas paradas necesita; use fuel_cost al presupuestar un viaje de vacaciones, reembolsar kilometraje solo de combustible o comparar coches a un precio de surtidor dado. Este endpoint no modela elevación, tráfico ni viento; es una comprobación aritmética transparente, no un motor de rutas. La moneda es la unidad que use para fuel_price; el motor es agnóstico a unidades y no convierte dólares a euros. Campos obligatorios ausentes, valores no finitos y distancia o consumo no positivos fallan con invalid_input y no se cobran tras el rechazo del motor.

Uso de la API, precios, flujos de viaje y límites prácticos

Llame al estimador gratuito en el navegador para planificar vacaciones, demos de aula y comparaciones rápidas de coches sin instalar una hoja de cálculo. Envíe un cuerpo JSON con distance, fuel_economy y fuel_price (o los alias documentados). Use la API prepaga cuando un portal de viajes, panel de flota, app de gastos o herramienta de reservas necesite un contrato estable bajo saldo KIT a $0.002 por ítem exitoso; los fallos de validación nunca consumen saldo. Combine este endpoint con un convertidor de unidades de precio de combustible cuando la cotización del surtidor sea por litro pero su consumo esté en millas por galón—convierta el precio primero, luego llame aquí con unidades coincidentes. Para itinerarios multi-tramo, sume fuel_cost en el cliente o llame una vez por tramo para que cada segmento quede auditable. Los autores que envían SDK pueden mapear fuel_needed y fuel_cost a tablas que muestren volumen y dinero lado a lado—la misma forma que los conductores ven en una hoja simple de presupuesto de viaje.