Distância haversine de círculo máximo
Meça a distância de círculo máximo entre duas coordenadas com a fórmula exibida ao lado do resultado: de Nova York a Londres dá 5570,229874 km, além de metros, milhas e um ângulo central de 50,094212°. 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
- 40,7128
- Lon1
- -74,006
- Lat2
- 51,5074
- Lon2
- -0,1278
- Distância (m)
- 5.570.229,874
- Distância (km)
- 5.570,229874
- Distância (mi)
- 3.461,180378
- Ângulo central (°)
- 50,094212
A distância de círculo máximo é o caminho mais curto sobre a superfície de uma esfera entre duas coordenadas geográficas. Pilotos, planejadores logísticos, desenvolvedores GIS e cientistas de dados precisam de um número reproduzível de «quão longe está A de B» sem montar uma pilha de mapeamento completa. Esta calculadora de distância haversine de círculo máximo recebe dois pares de latitude e longitude, aplica a fórmula haversine numericamente estável com um raio esférico médio da Terra de 6 371 008.8 metros e devolve a distância em metros, quilômetros e milhas estatutárias, além do ângulo central em graus. Use quando um modelo esférico for suficiente e você quiser uma string de fórmula transparente ao lado do resultado.
O que a fórmula haversine de círculo máximo calcula
Em uma esfera perfeita de raio R, o caminho de superfície mais curto entre dois pontos é um arco de círculo máximo cujo ângulo central Δσ obedece a uma identidade trigonométrica simples em latitude e longitude. A lei esférica dos cossenos clássica funciona em aritmética exata, mas perde precisão em separações curtas quando cossenos de ângulos quase iguais se subtraem em ponto flutuante.
A forma haversine reescreve a mesma geometria com senos de semiângulo: defina a como sin²(Δφ/2) mais cos φ1 cos φ2 sin²(Δλ/2), limite a ao intervalo unitário para que o ruído de arredondamento não a empurre ligeiramente para fora de [0, 1], e defina o ângulo central c como duas vezes atan2 da raiz de a sobre a raiz de um menos a. A distância é R vezes c. Esse par atan2 permanece bem condicionado tanto em saltos urbanos de quilômetros quanto em pares quase antípodas.
Esta capacidade fixa R no raio médio IUGG da Terra 6 371 008.8 metros para que cada chamador compartilhe uma esfera documentada em vez de misturar 6371 km, 6378 km e variantes autálicas na mesma planilha. O modelo ignora topografia, achatamento elipsoidal e altitude; se você precisar de precisão geodésica WGS-84 no nível do centímetro, use uma inversa elipsoidal como Vincenty. Para roteamento, ETAs logísticos, demos educacionais e landings SEO que buscam distância haversine de círculo máximo, a resposta esférica costuma ser a superfície de produto correta.
Casos de uso
Logística e estimativas aproximadas de ETA
Calcule quilômetros em linha reta entre coordenadas de depósito e entrega antes de aplicar fatores rodoviários ou matrizes de transportadora.
Localizador de lojas e filtros de proximidade
Ordene filiais candidatas por distância de círculo máximo a partir da lat/lon do usuário sem embutir um GIS completo no cliente.
Perguntas frequentes
Qual raio da Terra esta calculadora usa?
Um raio esférico médio de 6 371 008.8 metros (Terra média IUGG).
É o mesmo que distância de condução ou de voo?
Não. É o arco de superfície mais curto em uma esfera (círculo máximo). Estradas, aerovias e terreno tornam o deslocamento real mais longo; use APIs de roteamento para isso.
E se minha latitude ou longitude estiver fora da faixa?
Latitudes devem estar em [−90, 90] e longitudes em [−180, 180]. Entrada inválida não é cobrada.
O que é o ângulo central mostrado junto da distância?
É o ângulo entre os dois pontos visto do centro da Terra: 50,094212° entre Nova York e Londres. Esse ângulo, em radianos, multiplicado pelo raio fixo de 6 371 008,8 metros dá a distância sobre a superfície.
Funciona bem com pontos muito próximos ou do outro lado do antimeridiano?
Sim. A forma haversine mantém a precisão em trechos de poucos quilômetros, onde a lei esférica dos cossenos perde dígitos, e também em pontos quase opostos. Cruzar o antimeridiano não exige ajustar as longitudes.
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/haversine-distance \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"lat1":40.7128,"lon1":-74.006,"lat2":51.5074,"lon2":-0.1278}'const res = await fetch("https://api.kit.forhosting.com/geo/haversine-distance", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"lat1": 40.7128,
"lon1": -74.006,
"lat2": 51.5074,
"lon2": -0.1278
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/geo/haversine-distance",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"lat1": 40.7128,
"lon1": -74.006,
"lat2": 51.5074,
"lon2": -0.1278
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/haversine-distance", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"lat1":40.7128,"lon1":-74.006,"lat2":51.5074,"lon2":-0.1278}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"lat1":40.7128,"lon1":-74.006,"lat2":51.5074,"lon2":-0.1278}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/haversine-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": 40.7128,
"lon1": -74.006,
"lat2": 51.5074,
"lon2": -0.1278
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.haversine_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.
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
Latitudes ou longitudes inválidas falham com invalid_input e não são cobradas.
O que a fórmula haversine de círculo máximo calcula
As saídas informam distance_m, distance_km e distance_mi (milha estatutária internacional de 1609.344 m), central_angle_deg para matemática de mapa, earth_radius_m para trilhas de auditoria e uma string compacta de fórmula.
Contrato de entrada, campos de resposta e regras de validação
Exemplo: Nova York perto de 40.7128, −74.0060 e Londres perto de 51.5074, −0.1278 produzem cerca de cinco mil quinhentos e setenta quilômetros de arco de círculo máximo—a cifra que você compara com mapas de rotas aéreas que cotam círculo máximo e não distância rodoviária. Pontos idênticos produzem distância zero e ângulo central zero. O cruzamento do antimeridiano é tratado pela própria trig esférica; você não precisa normalizar longitudes além da verificação de faixa ±180. Envie um corpo JSON com quatro números finitos obrigatórios: lat1 e lat2 em graus decimais entre −90 e 90, e lon1 e lon2 entre −180 e 180. A longitude também aceita os aliases lng1 e lng2 para que clientes escritos com nomes GIS comuns não precisem renomear. Campos ausentes, strings vazias, valores não finitos e coordenadas fora da faixa falham com invalid_input nomeando o campo; essas falhas não consomem saldo pré-pago. Em caso de sucesso o corpo ecoa as quatro coordenadas como números, depois distance_m arredondado a três casas decimais, distance_km e distance_mi a seis decimais para goldens estáveis entre motores, central_angle_deg a seis decimais, earth_radius_m igual a 6371008.8 e formula reescrevendo a identidade haversine com o raio fixo. Combine a resposta com seus próprios rótulos de unidade na UI; a API não converte para milhas náuticas nem pés neste contrato.
Quando chamar esta API em produtos e pipelines
Painéis de frota, estimadores de viagem e protótipos de localizador de lojas precisam de uma distância de círculo máximo barata e documentada sem embutir uma biblioteca de geodésia em cada runtime. Mantenha as requisições pequenas, fixe distâncias arredondadas em testes de integração e documente que os resultados são esféricos—não distância de condução, não ajustados a nível de voo e não elipsoidais. Materiais de sala de aula e treinamento GIS usam a string formula devolvida e o raio fixo para que os alunos reproduzam o número à mão com uma calculadora científica e verifiquem a API. Apps móveis e de borda preferem um endpoint determinístico mínimo a puxar Mapbox Matrix ou Google Distance Matrix quando só importa a distância em linha reta e a topologia viária não. Se o seu produto mais tarde exigir maior fidelidade, mantenha este endpoint no caminho rápido e escale rotas de precisão de longo curso para uma capacidade geodésica elipsoidal sem mudar a forma de entrada de quatro campos. A validação falha permanece gratuita; chamadas bem-sucedidas ficam em US$ 0,002 para que o preço nunca surpreenda um job de enriquecimento em massa que só precisava de metros esféricos.
Casos de integração
Educação e notebooks GIS
Mostre aos alunos a fórmula haversine estável com raio médio terrestre fixo e verifique tarefas frente ao arredondamento golden da API.
Perguntas técnicas
Como calculo a distância haversine de círculo máximo entre dois pontos?
Envie lat1, lon1, lat2 e lon2 em graus decimais. A API devolve distance_m, distance_km, distance_mi, central_angle_deg e o earth_radius_m fixo usado na fórmula.
Quanto custa a calculadora de distância haversine de círculo máximo?
A ferramenta no navegador é gratuita. Requisições API usam saldo pré-pago KIT a US$ 0,002 por chamada bem-sucedida; falhas de validação não consomem saldo.