ForHosting KIT · Ferramentas para dev

Calculadora de início de descida

Uma calculadora de início de descida responde à pergunta de planejamento que todo piloto de jato, turboélice ou aviação geral avançada formula antes da chegada: a quantas milhas náuticas do aeroporto ou da restrição de cruzamento deve deixar a altitude de cruzeiro para que um ângulo de trajetória constante atinja a altura alvo no prazo?

● BetaGrátis · no seu navegador

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Informe a altitude de cruzeiro e a altitude alvo em pés, um ângulo de descida em graus (três graus é a trajetória clássica de descida contínua e estilo ILS) e a velocidade solo média esperada em nós. A ferramenta converte a altitude a perder em distância ao longo da rota com a identidade trigonométrica distância igual a altura sobre tan do ângulo de trajetória, converte pés em milhas náuticas pela definição internacional e depois divide a distância pela velocidade solo para o tempo de descida e multiplica para uma taxa vertical equivalente em pés por minuto. Não há previsão de ventos em altitude, nem base de desempenho do FMS nem chamada de rede dentro do solver — apenas aritmética de forma fechada —, de modo que o widget gratuito do navegador e a API pré-paga devolvem o mesmo JSON arredondado em cada chamada. Use-a para briefings de portões TOD, problemas de planejamento de voo em sala de aula ou scripts leves de despacho que precisam de uma fórmula transparente em vez de uma estimativa opaca do sistema de gestão de voo.

Como usar

Insira os dados no formulário acima. A ferramenta os verifica antes de calcular e mostra o resultado na mesma página.

Confira os dados

Use os rótulos e as unidades indicados em cada campo. Se algo estiver ausente ou fora do intervalo permitido, a página mostra o que corrigir.

Repita o cálculo ou automatize

Use a ferramenta web para verificações individuais e a API quando precisar da mesma capacidade em um fluxo automatizado.

Casos de uso

Obtenha uma resposta agora

Insira um conjunto de valores e veja o resultado sem montar uma planilha ou um script.

Compare cenários

Altere um valor por vez e repita o cálculo para entender o que muda o resultado.

Automatize tarefas repetidas

Use a API quando precisar executar o mesmo cálculo dentro do seu produto ou fluxo.

Perguntas frequentes

Como usar esta capacidade?

Preencha os campos acima e execute nesta página. O formulário destaca qualquer dado que precise de correção.

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/travel/top-of-descent

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

curl -X POST https://api.kit.forhosting.com/travel/top-of-descent \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cruise_altitude":35000,"target_altitude":3000,"descent_angle":3,"ground_speed":280}'

const res = await fetch("https://api.kit.forhosting.com/travel/top-of-descent", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "cruise_altitude": 35000,
    "target_altitude": 3000,
    "descent_angle": 3,
    "ground_speed": 280
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/travel/top-of-descent",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "cruise_altitude": 35000,
    "target_altitude": 3000,
    "descent_angle": 3,
    "ground_speed": 280
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/travel/top-of-descent", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"cruise_altitude":35000,"target_altitude":3000,"descent_angle":3,"ground_speed":280}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"cruise_altitude":35000,"target_altitude":3000,"descent_angle":3,"ground_speed":280}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/travel/top-of-descent", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "cruise_altitude": 35000,
  "target_altitude": 3000,
  "descent_angle": 3,
  "ground_speed": 280
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "travel.top_of_descent",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →