Distância haversine - km, mi e m em círculo máximo entre dois pontos

Quando você precisa do caminho mais curto sobre a superfície da Terra entre duas coordenadas GPS, a matemática planar e a simples distância euclidiana estão erradas: elas ignoram a curvatura e produzem erros grandes em saltos de cidade para cidade e de país para país. A fórmula de haversine trata o planeta como uma esfera de raio fixo e retorna o comprimento do arco em círculo máximo — a distância padrão de primeira passagem usada em logística, APIs de localização de lojas, pré-filtros de roteamento de frotas e análise geoespacial.

O que a fórmula de haversine de fato calcula

A fórmula de haversine é uma maneira numericamente estável de avaliar o ângulo central entre dois pontos em uma esfera a partir de suas latitudes e longitudes, e depois multiplicar esse ângulo pelo raio da esfera para obter o comprimento do arco. Em termos simples: dados o ponto A e o ponto B, ela responde a que distância você viajaria se seguisse o caminho mais curto sobre um globo liso em vez de um mapa plano.

Esta capacidade usa o raio médio convencional da Terra de 6371 quilômetros, que é o valor documentado para haversine na maioria dos trechos de código GIS de código aberto, nos tutoriais no estilo PostGIS e nos SDKs móveis.

Ela não usa um modelo elipsoidal como Vincenty ou Karney sobre WGS84, portanto os resultados podem diferir por uma pequena fração de percentual das bibliotecas geodésicas que modelam o achatamento polar — em geral, adequado para verificações de raio de loja, faixas de ETA de entrega e categorias de análise, e não um substituto para levantamentos topográficos de precisão. A saída é sempre em três unidades: quilômetros (km), milhas terrestres internacionais (mi, usando 1609,344 metros por milha) e metros (m).

Contrato de entrada, intervalos de coordenadas e erros comuns

A latitude deve estar no intervalo fechado de −90 a 90; a longitude deve estar entre −180 e 180, inclusive. Campos ausentes, valores não finitos ou strings que não são interpretadas como números também falham na validação antes que qualquer distância seja calculada.

Um erro frequente do cliente é trocar latitude e longitude (por exemplo, colar centros de cidades como lng,lat por um hábito no estilo GeoJSON): a chamada pode ter êxito se ambos os números ainda estiverem dentro dos dois intervalos, mas a distância será sem sentido para as cidades pretendidas — sempre verifique novamente se lat é norte-sul e lng é leste-oeste. Pontos idênticos retornam corretamente distância zero. Pares antípodas são suportados; a limitação interna evita que casos-limite de ponto flutuante produzam NaN.

Onde a distância em círculo máximo se encaixa em um pipeline de produto

Use o haversine como uma primitiva de distância barata e auditável dentro de portas de raio de checkout, seleção do armazém mais próximo, sinais de fraude que comparam a cidade de cobrança com o GPS do dispositivo, resumos de atividade de aplicativos esportivos e trabalhos de enriquecimento de CSV em massa que precisam de km ou milhas ao lado de cada par origem–destino. Combine-o com um geocodificador apenas quando você parte de endereços; assim que já tiver lat/lng, evite geocodificar de novo só para obter a distância.

Para roteamento com várias paradas, tempo de viagem por estrada ou trajetos com direções passo a passo, mantenha um motor de roteamento dedicado — o haversine é em linha reta, não distância de percurso. Para limites legais de propriedade ou trabalho cadastral, use geodésicas elipsoidais e um CRS local.