Calculadora de tempo total de voo com escalas

Listas inválidas, durações negativas ou uma escala diferente de zero na chegada final falham com invalid_input em vez de um total silencioso errado. Use grátis no navegador ao comparar rotas, ou chame a API a US$ 0,002 por solicitação bem-sucedida quando planilhas e ferramentas de reserva precisarem da mesma soma reproduzível.

O que significa o tempo total de viagem com escalas e o que a resposta contém

Os tempos de voo publicados quase sempre descrevem um único trecho aéreo ou de bloco. O passageiro vive algo maior: a primeira decolagem, cada espera intermediária em terra e a chegada final. Esse intervalo completo é o tempo total de viagem com escalas, e é o número necessário quando se pergunta quanto uma viagem realmente demora, se um voo noturno mais conexão vale a economia da tarifa, ou quanto de margem resta antes de uma reunião na cidade de destino. Esta calculadora responde essa pergunta com aritmética transparente. Você fornece um array ordenado de segmentos. No último segmento a escala é omitida ou zero porque a viagem termina ao chegar. Cada segmento carrega flight_minutes, a duração daquele trecho, e pode carregar layover_minutes, o tempo em terra após aquele trecho antes da próxima decolagem. O motor soma cada minuto de voo, soma cada minuto de escala intermediária e devolve total_travel_minutes como a soma, com campos de horas equivalentes e exibições legíveis para os totais de voo, escala e viagem. A resposta também ecoa segment_count, layover_count que é segment_count menos um em viagens multi-trecho ou zero em um direto, um array segments com índice baseado em um, flight_minutes e layover_minutes por trecho, uma tag de método flight_with_layovers e uma string de fórmula curta para logs. Não há feed GDS ao vivo, nem tabela de companhias raspada, nem aritmética de relógio: o caminho constrói um resultado finito a partir dos seus números ou rejeita a solicitação com invalid_input. Casos rejeitados incluem array segments ausente, lista vazia, mais de vinte trechos, itens que não são objetos, flight_minutes ausente, durações negativas, durações acima do teto de sete dias e uma escala positiva na chegada final. Se precisar de horários locais de chegada após mudança de fuso, combine uma única duração com travel.arrival_local_time; se precisar checar uma conexão contra o tempo mínimo de conexão, use travel.layover_time. Esta página permanece focada em somar o itinerário inteiro para que demos de navegador, planilhas e clientes de API compartilhem um único contrato estável.

Como segmentos e escalas são lidos e como o resultado permanece reproduzível

Cada item é um objeto. Os valores podem ser números finitos ou strings de duração H:MM como dois dois-pontos trinta para cento e cinquenta minutos; as horas em H:MM podem exceder vinte e três porque um único trecho de ultra-longa distância pode durar mais de um dia. Uma escala positiva no último segmento é rejeitada para que o tempo em terra pós-chegada não seja contado por engano como viagem. Limites de vinte segmentos e dez mil e oitenta minutos por duração mantêm entradas práticas para itinerários de passageiros e ainda cobrem tours mundiais multi-parada e conexões de superfície de vários dias informadas como minutos de escala. O nome de campo preferido é segments, mas legs, flights e itinerary são aceitos para que planilhas, query strings e formulários tipados reutilizem o mesmo contrato. A duração do voo é lida de flight_minutes com aliases flight, duration_minutes, minutes, duration, flight_min e block_minutes. O tempo intermediário em terra é lido de layover_minutes com aliases layover, connection_minutes, ground_minutes, wait_minutes, layover_min e connection. Uma lista de um segmento é um direto válido: layover_count é zero e a viagem total iguala aquele único voo. Uma lista de dois segmentos deve carregar layover_minutes no primeiro objeto; se omitido, a conexão assume zero para que uma célula ausente não invente uma espera. Combine a execução gratuita no navegador desta página com a API paga quando precisar do mesmo resultado matemático dentro de um pipeline automatizado sem reimplementar a validação de segmentos.

Onde totais multi-trecho se encaixam em planejamento, operações e software

Nesta página o trabalho roda inteiramente no seu navegador; pela API cada consulta bem-sucedida custa US$ 0,002, validação falha não é cobrada e nada é armazenado após a resposta retornar. Essa divisão — exploração interativa gratuita e uma API paga idêntica — combina com o restante do catálogo tier-A do KIT e permite passar de uma demo de planejamento de viagem a um pipeline automatizado sem mudar o resultado matemático.