ForHosting KIT · Ferramentas para dev

Calculadora de tempo até o waypoint em nós

Esta calculadora transforma a distância restante em milhas náuticas e a velocidade sobre o fundo em nós em uma duração clara.

● BetaGrátis · no seu navegador

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Ela retorna horas, minutos, segundos e um formato legível sem exigir coordenadas, serviço de rotas ou horário de partida. É útil para navegadores, operadores e desenvolvedores que já conhecem a distância a percorrer e precisam de uma estimativa reproduzível baseada na velocidade atual. Todo resultado é determinístico e usa a relação direta entre nós e milhas náuticas por hora.

Informe as milhas náuticas restantes e a velocidade atual

Comece pela distância ainda necessária até o waypoint ativo, em milhas náuticas, e pela velocidade atual sobre o fundo, em nós. Você pode obter a distância no chartplotter, no software de navegação, no plano de viagem ou em uma medição separada. A velocidade sobre o fundo representa o movimento real pela superfície terrestre e é mais apropriada do que a velocidade na água. Corrente, maré, vento, governo e estado do mar podem causar diferenças entre elas. A calculadora aceita distância zero, produzindo corretamente duração zero quando o waypoint já foi alcançado, mas a velocidade precisa ser maior que zero para haver um resultado finito. Valores decimais são aceitos, como 12.75 milhas náuticas e 6.4 nós. A precisão escolhida altera somente o arredondamento exibido, não a divisão interna. Para uma estimativa operacional útil, obtenha os dois valores aproximadamente no mesmo instante. Combinar uma distância antiga com uma velocidade recente pode gerar uma resposta matematicamente correta, porém pouco representativa.

Entenda a fórmula entre milha náutica e nó

Um nó equivale a uma milha náutica por hora; portanto, basta dividir as milhas náuticas restantes pela velocidade em nós. Se faltam 24 milhas e a embarcação mantém 8 nós, restam 3 horas. A resposta apresenta essa duração em horas, minutos e segundos decimais, além de uma etiqueta compacta com dias, horas, minutos e segundos. Isso facilita o uso em painel de passadiço, registro de bordo, limite de alerta ou aplicativo que processe segundos. Os campos numéricos são arredondados conforme a precisão solicitada, enquanto a etiqueta legível usa o segundo inteiro mais próximo. Nenhum relógio é consultado: o resultado representa tempo restante, e não horário de chegada. Se você precisar de uma chegada estimada, some os segundos retornados a uma marca temporal confiável do seu sistema. Manter duração e horário separados evita suposições ocultas sobre fusos, horário de verão, relógio do dispositivo e instante exato da observação.

Use a estimativa com segurança quando as condições mudarem

O resultado pressupõe velocidade sobre o fundo constante e uma distância que represente o caminho ainda necessário. Em viagens reais, ambas variam. Mudanças de rumo, esquemas de separação de tráfego, bordos, correntes, meteorologia, limites de velocidade, manobras e revisões de rota podem alterar a chegada. Recalcule quando o equipamento indicar uma mudança relevante e trate a resposta como projeção atual, não como promessa. Para leituras instáveis, seu aplicativo pode aplicar uma média móvel curta quando isso fizer sentido operacional. Não substitua a velocidade sobre o fundo pela velocidade na água, exceto se desejar deliberadamente esse outro tipo de estimativa. Confirme também que a distância está em milhas náuticas, e não em milhas terrestres ou quilômetros. A ferramenta não converte unidades automaticamente, não analisa o rumo e não decide se a embarcação avança para o waypoint. O equipamento de navegação de origem continua responsável por fornecer uma distância de rota válida e uma velocidade atual significativa.

Casos de uso

Acompanhamento de travessias marítimas

Transforme distância a percorrer e velocidade sobre o fundo em uma duração fácil de ler.

Painéis de telemetria de frotas

Calcule contagens regressivas consistentes com medições em milhas náuticas e nós.

Verificações de planejamento

Compare durações em diferentes velocidades constantes sem consultar mapa ou relógio.

Perguntas frequentes

Qual fórmula a calculadora utiliza?

Ela divide a distância restante em milhas náuticas pela velocidade sobre o fundo em nós, pois um nó equivale a uma milha náutica por hora.

A distância restante pode ser zero?

Sim. Zero milha náutica retorna duração zero e representa um waypoint já alcançado.

Por que a velocidade deve ser maior que zero?

Velocidade zero ou negativa não produz um tempo de avanço finito e é rejeitada como entrada inválida.

O resultado inclui um horário de chegada?

Não. Ele retorna o tempo restante sem consultar relógio. Some os segundos a uma marca temporal confiável se precisar do horário.

A ferramenta considera corrente ou vento?

Ela não os modela separadamente. Use a velocidade sobre o fundo, que já reflete o efeito líquido no avanço medido naquele momento.

Quanto custa um cálculo pela API?

Cada solicitação concluída custa US$ 0,002. O mesmo cálculo determinístico também pode ser executado no navegador.

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/time-to-waypoint

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/time-to-waypoint \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"distance_nm":24.5,"speed_knots":7}'

const res = await fetch("https://api.kit.forhosting.com/travel/time-to-waypoint", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "distance_nm": 24.5,
    "speed_knots": 7
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/travel/time-to-waypoint",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "distance_nm": 24.5,
    "speed_knots": 7
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/travel/time-to-waypoint", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"distance_nm":24.5,"speed_knots":7}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"distance_nm":24.5,"speed_knots":7}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/travel/time-to-waypoint", 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

{
  "distance_nm": 24.5,
  "speed_knots": 7
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "travel.time_to_waypoint",
  "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 →