ForHosting KIT · Viagens e geografia

Distância latitude longitude

Transforme dois pinos de latitude e longitude em um único número em quilômetros: (40,7128; -74,006) e (51,5074; -0,1278) ficam a 5570,22218 km pelo círculo máximo, um valor pronto para guardar, comparar ou testar. Grátis no seu navegador.

  • Grátis
  • Funciona no seu navegador
  • Sem cadastro
  • Seus dados não saem do seu aparelho
Use pelo WebAPIE-mailTelegramApp em breve
Se você digitar
Lat1
40,7128
Lon1
-74,006
Lat2
51,5074
Lon2
-0,1278
Você obtém
Km
5.570,22218
Raio da Terra (km)
6.371

Latitude e longitude são as coordenadas que quase todo chip GPS, exportação GIS e check-in móvel já guarda, mas converter dois desses pinos em uma distância em quilômetros é o ponto em que muitos produtos erram em silêncio. Tratar graus decimais como um plano estica um grau de longitude como se fosse constante do equador ao polo, então a mesma variação de longitude percorre um trecho de solo bem diferente em Quito e em Oslo. Esta calculadora de distância latitude-longitude aplica a fórmula haversine em uma esfera de raio médio 6371 quilômetros e devolve somente o comprimento do arco de círculo máximo em quilômetros. Envie quatro números em graus decimais, leia uma cifra em quilômetros que você pode fixar em testes e dispense tiles de mapa, geocodificadores e solucionadores elipsoidais quando o contrato de que precisa é um quilômetro esférico em linha reta.

O que a distância latitude-longitude em uma esfera realmente mede

O caminho mais curto entre dois pontos na Terra não é a reta que você desenha em um mapa impresso. Mapas impressos e da web achatam uma superfície curva, então um comprimento de régua em milímetros de mapa é um artefato de projeção, não um comprimento no solo.

A distância de latitude e longitude em uma esfera mede em vez disso o ângulo central entre duas posições geográficas e multiplica esse ângulo pelo raio da esfera para obter o comprimento de arco — o quilômetro de círculo máximo que as pessoas querem dizer quando perguntam a que distância dois pinos GPS ficam em linha reta.

Dadas as latitudes φ1 e φ2 e as longitudes λ1 e λ2 convertidas em radianos, o haversine do ângulo central satisfaz hav(c) igual a hav(φ2 menos φ1) mais o produto de cos φ1, cos φ2 e hav(λ2 menos λ1), em que hav de um ângulo é o quadrado do seno da metade desse ângulo.

A avaliação numericamente estável usada aqui é a igual ao seno ao quadrado da metade da diferença de latitude mais cos φ1 vezes cos φ2 vezes o seno ao quadrado da metade da diferença de longitude; em seguida c é duas vezes atan2 da raiz de a sobre a raiz de um menos a; e os quilômetros são R vezes c, com R fixo em 6371 quilômetros, o raio médio convencional da Terra em tutoriais GPS e trechos GIS esféricos.

Essa esfera não é o elipsoide WGS-84, então o achatamento polar é ignorado e os resultados podem diferir por uma fração pequena de um por cento das geodésicas de Vincenty ou Karney; para raios de loja, faixas de analítica e filtros em linha reta essa folga costuma ser aceitável. Coordenadas idênticas produzem zero. Pares antípodas produzem um resultado perto de πR.

A aritmética é pura e determinística: sem relógio, sem semente aleatória, sem rede, e os mesmos quatro números sempre geram a mesma cifra de quilômetros arredondada.

Contrato de entrada, faixas de coordenadas e o erro de latitude de noventa graus

A latitude é a coordenada norte-sul e deve ficar no intervalo fechado de menos noventa a mais noventa. A longitude é a coordenada leste-oeste e deve ficar no intervalo fechado de menos cento e oitenta a mais cento e oitenta. Recortar inventaria uma posição que o chamador nunca enviou e faria uma checagem de raio posterior parecer ter rodado sobre GPS de verdade.

Longitude fora de mais ou menos cento e oitenta é rejeitada do mesmo jeito. Um bug frequente de cliente é inverter latitude e longitude ao colar um par no estilo GeoJSON; a chamada ainda pode ter sucesso se os dois números couberem nas duas faixas, mas o resultado em quilômetros não bate com as cidades que você pretendia, então mantenha lat como norte-sul e lon como leste-oeste.

Combine o quilômetro com a sua própria conversão de unidades se precisar de milhas ou metros; este produto responde a pergunta de distância latitude-longitude em quilômetros e não emite mapas, rumos nem tempo de viagem.

Onde a distância em quilômetros ajuda

Localizadores de loja, barreiras de raio de entrega e apps de marketplace já guardam as coordenadas do comprador e do estabelecimento e só precisam de um quilômetro em linha reta antes de gastar dinheiro com roteamento viário. A logística e os pré-filtros de armazém descartam hubs que ficam fora de um limiar de círculo máximo para que motores caros de tempo de direção rodem só na lista curta.

Resumos de esporte e trilha, sinais de fraude que comparam uma cidade de cobrança a um pino GPS do dispositivo e jobs em massa de enriquecimento de CSV que acrescentam uma coluna km ao lado de cada par origem-destino seguem o mesmo padrão: você já tem latitudes e longitudes e precisa de um quilômetro determinístico que consiga explicar em um chamado de suporte. Chame a calculadora grátis de distância latitude longitude no navegador para demos de sala e checagens rápidas sem instalar uma pilha GIS.

Para caminhos curva a curva conserve um motor de roteamento; para limites legais de propriedade use um solucionador elipsoidal e um CRS local.

Localizador de lojas e raio de entrega em quilômetros

Compare o pino GPS de um comprador com a coordenada de cada loja e retenha só os estabelecimentos cuja distância de círculo máximo em quilômetros caiba no seu raio de entrega ou retirada.

Pré-filtro de hubs logísticos antes do roteamento viário

Descarte armazéns candidatos fora de um limiar de quilômetros em linha reta para que APIs pagas de tempo de direção rodem só na lista restante.

Enriquecimento CSV de pares origem-destino

Acrescente uma coluna de quilômetros a exportações de embarque, telemetria ou eventos a partir de latitudes e longitudes armazenadas, sem uma conta de faturamento de mapas.

O que acontece se uma latitude ultrapassar noventa graus?

A latitude deve ficar entre −90 e 90 inclusive; valores fora dessa faixa não são recortados e não são cobrados.

Qual fórmula e raio da Terra esta calculadora usa?

Não é uma geodésica elipsoidal de Vincenty nem de Karney, então o achatamento polar é ignorado.

O resultado inclui milhas ou tempo de viagem?

Não. O contrato responde a distância latitude-longitude somente em quilômetros. Converta as unidades você mesmo se precisar de milhas, e use um motor de roteamento para o tempo de direção.

Por que não posso tratar latitude e longitude como x e y planos?

Porque um grau de longitude não tem sempre o mesmo comprimento: ele encolhe do equador para os polos, então a mesma mudança de longitude cobre um terreno muito diferente em Quito e em Oslo. Medir sobre uma esfera evita essa distorção.

Qual é a maior distância que a calculadora pode retornar?

Para dois pontos exatamente opostos no globo, o resultado fica perto de π vezes 6371 quilômetros, meia volta na esfera. Pontos idênticos dão zero, e qualquer outro par fica entre esses dois valores.

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.

POSThttps://api.kit.forhosting.com/geo/latitude-longitude-distance

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

curl -X POST https://api.kit.forhosting.com/geo/latitude-longitude-distance \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat1":40.7128,"lon1":-74.006,"lat2":51.5074,"lon2":-0.1278}'
{
  "lat1": 40.7128,
  "lon1": -74.006,
  "lat2": 51.5074,
  "lon2": -0.1278
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.latitude_longitude_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.

por chamadaUS$ 0,002

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

HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.

A ferramenta do navegador é grátis; chamadas API bem-sucedidas custam US$ 0,002 por item. Uma latitude que ultrapassa noventa graus falha com invalid_input em vez de ser recortada até uma posição falsa.

O que a distância latitude-longitude em uma esfera realmente mede

Este endpoint devolve só quilômetros, a unidade que as pessoas digitam na busca ao procurar uma calculadora de distância latitude longitude.

Contrato de entrada, faixas de coordenadas e o erro de latitude de noventa graus

Faça POST de um corpo JSON com quatro números finitos obrigatórios em graus decimais: lat1 e lon1 para o primeiro ponto, lat2 e lon2 para o segundo. Cada campo pode chegar como número JSON ou como string numérica; campos ausentes, strings vazias e valores não finitos falham com invalid_input que nomeia o campo, e essas falhas não são cobradas. Se uma latitude ultrapassar noventa graus em qualquer sentido, a tarefa é rejeitada com uma mensagem invalid_input clara em vez de recortar o pino em silêncio sobre um polo. Outra armadilha é alimentar metros projetados ou deslocamentos de grade local em vez de graus geográficos; esta API espera somente graus decimais no estilo WGS84. Em caso de sucesso o corpo ecoa as quatro coordenadas, devolve km arredondado a seis casas decimais para goldens estáveis, reitera earth_radius_km como 6371 e nomeia o método em formula como haversine.

Onde uma API de círculo máximo em quilômetros se paga

Use a API pré-paga a partir de workers, notebooks e SDKs quando servidores precisarem do mesmo contrato sob saldo KIT a US$ 0,002 por item bem-sucedido; falhas de validação, inclusive uma latitude que ultrapassa noventa graus, nunca consomem saldo. Mantenha as solicitações pequenas, fixe o campo km arredondado nos testes e você poderá recalcular offline com o raio publicado e coincidir com a API. Isto não é distância de direção, nem uma loxodromia, nem uma geodésica cadastral. Para tudo no meio — painéis, SLA e filtros de API — valide faixas, meça o círculo máximo, devolva quilômetros e pronto.

Como obtenho a distância em quilômetros a partir de duas latitudes e longitudes?

Envie os campos finitos em graus decimais lat1, lon1, lat2 e lon2. A API devolve o comprimento de círculo máximo haversine em quilômetros usando um raio médio terrestre de 6371 km.

Quanto custa a calculadora de distância latitude longitude?

A ferramenta do navegador é grátis. Solicitações API usam saldo KIT pré-pago a US$ 0,002 por chamada bem-sucedida; entrada inválida não é cobrada.

Ver a documentação completa do KIT →