Distância ao longo do trajeto
Projete Paris sobre o grande círculo de Londres a Nova York e a distância ao longo do trajeto é de −264,107681 km: o ponto mais próximo fica atrás de Londres. Você recebe ainda o desvio lateral, o comprimento total e a fração percorrida. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Lat1
- 51,5074
- Lon1
- -0,1278
- Lat2
- 40,7128
- Lon2
- -74,006
- Latitude
- 48,8566
- Longitude
- 2,3522
- Distância ao longo do trajeto
- -264,107681 km
- Distância ao longo do trajeto (m)
- -264.107,681392
- Distância lateral (cross-track)
- -219,786036
- Distância lateral (m)
- -219.786,03604
Esta calculadora de distância ao longo do trajeto mede a que distância ao longo de uma rota de grande círculo você percorreu, quando um ponto de consulta é projetado nessa rota. O modelo é uma esfera com raio configurável (padrão do raio médio da Terra do IUGG) e unidades de saída opcionais em metros, quilômetros, milhas terrestres, ou milhas náuticas. Toda avaliação é totalmente determinística: não há consultas de rede, amostragem, ou atalhos dependentes de data.
Onde a projeção ao longo do trajeto se encaixa em estudo de navegação, operações e software
Estudantes encontram distâncias ao longo do trajeto e laterais quando um livro-texto de navegação introduz trajetos de grande círculo, quando um exercício de planejamento de voo pede o progresso ao longo da rota na aproximação mais próxima de uma cidade ou ponto de referência, ou quando separam o progresso ao longo da rota do erro lateral antes de plotar. Professores podem pré-gerar gabaritos para triplas modestas de lat-lon, sem depender de aplicativos de mapa opacos que trocam silenciosamente entre modelos geodésicos e de rumo, ou mudam o raio da Terra.
Ferramentas de operações e despacho usam os mesmos números para relatar a que distância ao longo de um corredor uma célula de tempo ou NOTAM se encontra, e se o deslocamento é à esquerda ou à direita do trajeto.
Desenvolvedores chamam o mesmo contrato a partir de scripts para gerar vetores de teste determinísticos para renderizadores de trajeto, normalizar waypoints inseridos por usuários antes de demonstrações simples de rota de voo, ou atender enunciados de desafios de programação que exigem uma distância ao longo do trajeto, em vez de uma escala de mapa aproximada. A prática de competições costuma precisar de uma fonte rápida e offline de projeções esféricas, para que as soluções possam ser verificadas sem GIS proprietário sob pressão de tempo.
Ferramentas de produto e educação usam a avaliação quando um aprendiz digita três pontos e a interface precisa mostrar quilômetros ao longo da rota mais um deslocamento lateral.
Casos de uso
Progresso de trajeto de voo e marítimo
Meça a que distância ao longo de uma rota planejada de grande círculo ocorre a aproximação mais próxima de uma cidade, auxílio de navegação, ou célula de tempo, mais o deslocamento lateral.
Demonstrações de roteamento e software de tutoria
Projete pontos inseridos por usuários em um corredor esférico de grande círculo, para lições interativas e demonstrações simples de rota de voo.
Perguntas frequentes
Como a distância ao longo do trajeto difere da distância de grande círculo até o ponto?
A distância de grande círculo até o ponto é o arco direto do início do trajeto até o local de consulta. A distância ao longo do trajeto é o arco do início até o ponto mais próximo no grande círculo do trajeto, então ela ignora o deslocamento lateral (cross-track).
A distância ao longo do trajeto pode ser negativa, ou a fração pode exceder 1?
Sim. Uma distância ao longo do trajeto negativa significa que a projeção está atrás do início do trajeto. Uma fração fora de 0…1 significa que o ponto mais próximo no grande círculo infinito fica fora do segmento finito início-fim.
Quais intervalos de coordenadas são aceitos?
A latitude deve estar entre −90 e 90 graus, inclusive. A longitude deve estar entre −180 e 180 graus, inclusive. Extremos de trajeto coincidentes ou antípodas são rejeitados.
Qual raio da Terra e quais unidades são usados?
O raio padrão é 6371008,8 m (médio do IUGG). Substitua o raio quando um enunciado de problema usar outro modelo esférico.
Como descubro em que ponto da rota passo mais perto de um lugar?
Informe o início e o fim da rota e o lugar como terceiro ponto. A distância ao longo do trajeto diz a que distância do início acontece a maior aproximação, e a distância lateral diz quanto o lugar fica afastado da linha, à esquerda ou à direita.
Ferramentas relacionadas
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
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/geo/along-track-distance \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"lat1":51.5074,"lon1":-0.1278,"lat2":40.7128,"lon2":-74.006,"lat":48.8566,"lon":2.3522}'const res = await fetch("https://api.kit.forhosting.com/geo/along-track-distance", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"lat1": 51.5074,
"lon1": -0.1278,
"lat2": 40.7128,
"lon2": -74.006,
"lat": 48.8566,
"lon": 2.3522
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/geo/along-track-distance",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"lat1": 51.5074,
"lon1": -0.1278,
"lat2": 40.7128,
"lon2": -74.006,
"lat": 48.8566,
"lon": 2.3522
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/along-track-distance", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"lat1":51.5074,"lon1":-0.1278,"lat2":40.7128,"lon2":-74.006,"lat":48.8566,"lon":2.3522}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"lat1":51.5074,"lon1":-0.1278,"lat2":40.7128,"lon2":-74.006,"lat":48.8566,"lon":2.3522}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/along-track-distance", 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
{
"lat1": 51.5074,
"lon1": -0.1278,
"lat2": 40.7128,
"lon2": -74.006,
"lat": 48.8566,
"lon": 2.3522
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.along_track_distance",
"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
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Limites
lat_min | -90 |
lat_max | 90 |
lon_min | -180 |
lon_max | 180 |
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. |
Notas técnicas
Você informa o início e o fim do trajeto como latitude e longitude, mais o ponto de consulta; o mecanismo retorna a distância de superfície com sinal do início até o ponto mais próximo no grande círculo infinito que passa por esses extremos, junto com o deslocamento lateral (cross-track) com sinal, o comprimento total do trajeto, e a fração do segmento.
O que significa a distância ao longo do trajeto e o que a resposta contém
A distância ao longo do trajeto é o comprimento de arco medido do início de um trajeto de grande círculo até o pé da perpendicular de um ponto de consulta sobre esse grande círculo. Na navegação aérea e marítima, ela responde a perguntas como a que distância ao longo do trajeto planejado ocorre a aproximação mais próxima de uma célula de tempo ou de um auxílio à navegação, mesmo quando a aeronave ou o navio está deslocado da linha de centro. A distância lateral (cross-track) é o deslocamento complementar com sinal, à esquerda ou à direita do trajeto; ambas as grandezas vêm da mesma trigonometria esférica e são retornadas juntas, para que os consumidores não precisem rederivá-las. Esta calculadora retorna as coordenadas normalizadas do início do trajeto, fim do trajeto, e ponto de consulta, along_track_distance na unidade solicitada, o mesmo valor sempre ecoado em metros como along_track_distance_m, cross_track_distance e seu gêmeo em metros, o track_length completo do grande círculo entre os extremos do trajeto, a distância haversine distance_to_point do início até o local de consulta, fraction_along_track em relação ao segmento finito, path_bearing_deg e bearing_to_point_deg a partir do norte verdadeiro, a etiqueta de unidade, o raio usado em metros, a etiqueta de método along_track_great_circle, a precisão decimal aplicada, e uma string de fórmula curta. Não há iteração geodésica de elipsoide aqui, nem modelo de linha de rumo (rhumb-line): o mecanismo avalia as fórmulas esféricas de forma fechada dentro dos intervalos de coordenadas suportados, ou rejeita a entrada com invalid_input. Os casos rejeitados incluem coordenadas ausentes, valores não finitos, latitude fora de menos noventa a noventa graus, longitude fora de menos cento e oitenta a cento e oitenta graus, extremos de trajeto coincidentes que deixam a direção do trajeto indefinida, e extremos de trajeto antípodas que deixam o grande círculo não único. Se você precisa do comprimento de loxodromia de rumo constante, use uma ferramenta de distância rhumb; esta página responde apenas à projeção ao longo do trajeto de grande círculo, com saída de ponto flutuante estável adequada para planilhas de exercícios, testes unitários e consumidores de API que não podem inventar passos de plotagem de carta.
Como coordenadas, unidades e raio são interpretados para manter resultados reproduzíveis
Sinais de mais à esquerda opcionais e notação científica em strings numéricas são permitidos quando interpretados como decimais finitos; espaços embutidos, prefixos hexadecimais, e tokens não numéricos são rejeitados com uma mensagem clara, para que uma célula com erro não vire uma posição de trajeto errada. Um campo opcional radius define o raio da esfera em metros, quando você precisa de um raio da Terra de livro-texto diferente do padrão de seis milhões trezentos e setenta e um mil e oito vírgula oito metros. Internamente, o mecanismo converte graus para radianos, calcula o ângulo central haversine do início até o ponto de consulta, obtém os rumos iniciais de grande círculo do início até o fim e do início até o ponto, forma o ângulo ao longo do trajeto com sinal usando atan2 de seno de delta treze vezes cosseno da diferença de rumo sobre cosseno de delta treze, multiplica por R para metros de superfície, e da mesma forma forma o ângulo lateral com asin de seno de delta treze vezes seno da diferença de rumo. Os campos preferidos são lat1 e lon1 para o início do trajeto, lat2 e lon2 para o fim do trajeto, e lat e lon para o ponto de consulta, todos em graus decimais, mas os aliases como start_lat, end_lon, point_lat, lat3, e longitude são aceitos, para que planilhas, strings de consulta e formulários tipados possam reutilizar o mesmo contrato. A latitude deve estar entre menos noventa e noventa graus, inclusive; a longitude deve estar entre menos cento e oitenta e cento e oitenta, inclusive. Um campo opcional unit escolhe metros, quilômetros (o padrão), milhas terrestres, ou milhas náuticas, com aliases mais longos, como kilometers e nautical_miles, normalizados para etiquetas curtas. Precision opcional, com aliases decimals e dp, escolhe quantas casas decimais expor para distâncias e rumos, com padrão de seis e limite de quinze, para que os goldens em JSON permaneçam estáveis. 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 as fórmulas ao longo do trajeto você mesmo.
Onde a projeção ao longo do trajeto se encaixa em estudo de navegação, operações e software
Nesta página o trabalho roda inteiramente no seu navegador; pela API, cada consulta bem-sucedida custa US$ 0,002, a validação com falha não é cobrada, e nada é armazenado depois que a resposta é devolvida. Essa divisão — exploração interativa gratuita e uma API paga e idêntica — segue o padrão do resto do catálogo tier A do KIT e permite passar de uma demonstração em sala de aula para um pipeline automatizado sem mudar o resultado matemático. Combine-a com ferramentas de distância rhumb ou conversão de coordenadas quando precisar de passos geográficos relacionados, e com outros endpoints de análise ao montar um pequeno laboratório de auxiliares de navegação gratuitos e determinísticos.
Casos de integração
Fixtures de navegação determinísticas
Gere valores reproduzíveis de along_track_distance_m, cross_track_distance_m, e fraction_along_track para testes unitários e asserções de CI.
Perguntas técnicas
Quanto custa a calculadora de distância ao longo do trajeto?
É gratuita no navegador, nesta página. Pela API, uma solicitação bem-sucedida custa US$ 0,002; entradas inválidas não são cobradas.