Distância pitagórica equirretangular

Esta capacidade estima a que distância dois pontos na Terra estão um do outro tratando o mapa como um plano local. Ela converte a diferença de latitude e de longitude em metros usando uma escala de cosseno da latitude média e, então, aplica o teorema de Pitágoras a esses deslocamentos leste-oeste e norte-sul. O resultado é uma distância aproximada no solo, em metros e quilômetros, além dos deltas projetados, para que você possa auditar os passos intermediários. O algoritmo é totalmente determinístico: sem chamadas de rede, sem amostragem aleatória e sem relógio. Use-a quando precisar de uma distância rápida e barata para pontos próximos, ranqueamento em lote ou para ensinar a projeção equirretangular sem o custo de uma fórmula de círculo máximo completa.

Como funciona a fórmula pitagórica equirretangular

Numa esfera, os verdadeiros caminhos mais curtos são círculos máximos, mas, para muitas tarefas de produto e análise, uma aproximação plana local basta. Esta ferramenta usa a clássica projeção equirretangular: converte ambas as latitudes e longitudes para radianos, toma a diferença de latitude como o arco norte-sul numa esfera de raio médio fixo e escala a diferença de longitude pelo cosseno da latitude média, de modo que os metros leste-oeste encolham perto dos polos. Esses dois deslocamentos em metros tornam-se os catetos de um triângulo retângulo.

A hipotenusa é a distância no solo informada. Usamos um raio médio da Terra de seis milhões trezentos e setenta e um mil metros, a mesma constante que muitos manuais educacionais e de SIG usam para este método. Essa estabilidade importa para testes de referência, réplicas multirregião e ferramentas offline que não podem divergir.

Faixas de entrada, apelidos e quando a chamada falha

Envie graus decimais no globo WGS84. Latitudes ou longitudes fora de faixa falham da mesma forma, com uma mensagem que nomeia o campo problemático. Prefira números decimais estáveis a texto em graus-minutos-segundos ou referências de grade; converta esses formatos antes de chamar.

O exemplo de parâmetros usa um par curto de Manhattan para que o teste e a documentação permaneçam realistas. Para pontos idênticos, a distância é zero. Cruzar o antimeridiano com diferenças brutas de longitude pode inflar o resultado; para trajetos que dão a volta na linha de data, normalize as longitudes primeiro ou use um método de círculo máximo.

Quando usar esta aproximação em vez de uma fórmula esférica

Escolha a distância pitagórica equirretangular quando os pontos estiverem relativamente próximos, quando você precisar de velocidade máxima em vez de precisão máxima, ou quando estiver ensinando ou depurando projeções de mapa e quiser os deltas intermediários em metros. Verificações de raio de entrega dentro de uma cidade, agrupamento de sensores próximos, heurísticas grosseiras de tempo de viagem e tooltips de interface se encaixam bem.

Para rotas intercontinentais, trajetos polares ou navegação em que alguns por cento de erro importam, prefira uma distância de círculo máximo do tipo haversine ou Vincenty: esses métodos consideram a curvatura da Terra com mais cuidado. O erro cresce com a separação e com os extremos de latitude, porque a projeção plana ignora a convergência dos meridianos além do fator de escala da latitude média. Sempre documente o método ao armazenar resultados, para que auditorias posteriores saibam que você usou uma aproximação.

Entradas inválidas nunca consomem saldo, então você pode validar coordenadas de forma agressiva antes dos jobs em lote.