Reserva de combustível de voo

Números inválidos ou ausentes falham com invalid_input e não são cobrados.

O que significam combustível de etapa, alternativa, reserva e contingência

O combustível de etapa é o necessário para voar da origem ao destino no consumo previsto: burn_rate multiplicado pelo tempo de voo convertido em horas. A reserva final é uma quantidade de espera baseada no tempo que ainda deve restar nos tanques ao chegar ao destino ou à alternativa; os regulamentos costumam citá-la em minutos, de modo que esta calculadora toma reserve_minutes e converte em horas antes de multiplicar pelo consumo. O combustível de contingência, quando você informa contingency_percent, é uma fração do de etapa que cobre erros de vento, mudanças de rota e de nível; cinco por cento é uma cifra comum de planejamento, e zero por cento é aceito quando você quer um total bruto de etapa mais alternativa mais reserva.

Contrato de entrada, unidades e campos de resposta

Os valores são arredondados a doze casas decimais para goldens estáveis. Envie por POST um corpo JSON com três números finitos obrigatórios: burn_rate, o consumo horário em qualquer unidade coerente como galões por hora, litros por hora ou quilogramas por hora; flight_time, a duração prevista da etapa; e reserve_minutes, a reserva final exigida expressa em minutos. O opcional flight_time_unit é hours por padrão ou minutes quando a etapa é informada assim. O opcional alternate_time é o tempo do destino até a alternativa, valendo zero quando você planeja um voo sem alternativa; alternate_time_unit é hours por padrão ou minutes. O opcional contingency_percent é um número de zero a cem inclusive, com padrão zero. Cada campo numérico pode chegar como número JSON ou como string numérica; campos ausentes, strings vazias, valores não finitos, tempos negativos, burn_rate não positivo e contingência fora de zero a cem falham com invalid_input nomeando o campo e não são cobrados. Em caso de sucesso o corpo ecoa as entradas limpas e os tempos normalizados em horas, e depois informa trip_fuel, alternate_fuel, reserve_fuel, contingency_fuel e total_fuel na mesma unidade física de burn_rate. endurance_hours e endurance_minutes restabelecem quanto esse total dura no consumo dado. result duplica total_fuel para clientes que sempre leem um único campo numérico. Uma string formula reexpressa a identidade de quatro termos, method é trip_plus_alternate_plus_reserve_plus_contingency, e message resume a pilha em linguagem clara. Exemplo: burn_rate doze, flight_time dois ponto cinco hours, reserve_minutes quarenta e cinco, alternate_time zero ponto cinco hours e contingency_percent cinco produz combustível de etapa trinta, alternativa seis, reserva nove, contingência um ponto cinco e total quarenta e seis ponto cinco.

Onde uma API de reserva de combustível de voo agrega valor

Pilotos e instrutores de aviação geral usam uma calculadora de reserva de combustível de voo antes de travessias VFR e IFR para que a reserva legal e uma alternativa realista não sejam esquecidas quando alguém multiplica galões por hora pelo tempo estimado em rota num guardanapo. Mesas de despacho de charter e de companhia aérea precisam da mesma pilha de quatro termos para um único setor sem abrir um pacote completo de planejamento de voo: já têm o consumo, o tempo de etapa, o tempo até a alternativa e os minutos de reserva da empresa. Organizações de instrução e geradores de exame ATPL precisam de um oráculo determinístico que trate a reserva em minutos, aceite o tempo de etapa em hours ou em minutes e nunca omita em silêncio a contingência. Cadernos de engenharia que já armazenam o fluxo de combustível e os tempos estimados podem chamar uma API parse compacta em vez de rederivar a mesma aritmética em cada binding de linguagem. Como a implementação é parse pura de nível A, cada chamada bem-sucedida custa o US$ 0,002 publicado sem tokens de modelo e sem rede de saída, e a validação falha não consome saldo. Mantenha as solicitações pequenas, fixe total_fuel e o detalhamento de quatro termos nos testes, e você obtém combustível de planejamento reproduzível para briefings, plugins LMS e workers na borda sem levantar uma biblioteca própria de engenharia de desempenho. Este endpoint não calcula peso e balanceamento, desempenho de decolagem nem tempo ortodrômico; só converte a política de combustível que você já escolheu num total que pode carregar.