ForHosting KIT · Ferramentas para dev

Distância total entre pares de pontos geográficos

A calculadora de distância total entre pares mede a distância de grande círculo entre cada par não ordenado de um conjunto de pontos geográficos e soma essas medidas.

● BetaGrátis · no seu navegador
Use pelo WebAPIE-mailTelegramApp em breve

Ela foi criada para análise de conectividade, comparação de redes de locais, diagnóstico de agrupamentos e qualquer fluxo que exija uma medida reproduzível da dispersão geográfica. Informe coordenadas decimais de latitude e longitude; o resultado apresenta a quantidade de pontos, o número de pares avaliados e a distância combinada em quilômetros, milhas e metros.

O que a distância total entre pares revela

A distância total entre pares resume em um único número todas as separações geográficas diretas dentro de um conjunto de pontos. Para cada ponto, a calculadora forma pares com todos os pontos seguintes, mede o caminho mais curto sobre uma Terra esférica e acrescenta essa medida apenas uma vez. Com quatro locais, por exemplo, existem seis pares não ordenados; inverter um par não cria outra contribuição. O resultado é útil quando a questão envolve a dispersão espacial geral, e não uma rota, um perímetro ou a distância a partir de um centro escolhido. Um grupo compacto gera um total menor que um grupo muito distribuído com a mesma quantidade de locais. Como o total também cresce quando novos pontos são adicionados, compare conjuntos com números iguais de pontos para uma avaliação direta da dispersão ou use a contagem de pares informada para calcular externamente a distância média entre pares. Coordenadas duplicadas são aceitas e contribuem com distância zero para seu par, preservando observações repetidas em vez de removê-las silenciosamente.

Como o cálculo é realizado

Cada par é avaliado pela fórmula de Haversine com um raio médio da Terra de 6,371.0088 quilômetros. Latitude e longitude são convertidas de graus decimais para radianos, as diferenças entram na fórmula esférica e o ângulo central resultante é multiplicado por esse raio. Assim se obtém a distância de grande círculo: o menor caminho pela superfície de uma esfera, não uma linha reta através da Terra nem uma distância rodoviária, pedestre ou de rede. A implementação restringe o valor intermediário de Haversine ao intervalo matemático correto, evitando problemas de ponto flutuante em pontos quase idênticos ou quase antípodas. Em seguida, ela acumula os valores não arredondados em quilômetros antes de gerar totais estáveis e arredondados em quilômetros, milhas e metros. As longitudes podem variar de -180 a 180, portanto os pares que atravessam o antimeridiano são tratados naturalmente pelo cálculo trigonométrico periódico. Esse modelo esférico é consistente e apropriado para análises amplas de conectividade, embora um levantamento de alta precisão deva usar um método geodésico elipsoidal.

Como preparar os pontos e interpretar o resultado

Forneça de dois a 1,000 registros, cada um com campos numéricos de latitude e longitude. A latitude deve ficar entre -90 e 90 graus, e a longitude entre -180 e 180 graus. Use graus decimais com sinal: coordenadas ao norte e a leste são positivas, enquanto coordenadas ao sul e a oeste são negativas. Não insira símbolos de grau, letras de pontos cardeais nem strings numéricas, pois a validação estrita evita conversões ambíguas. A calculadora informa n(n−1)/2 pares, permitindo confirmar que o conjunto completo foi avaliado. Lembre-se de que o total depende tanto da dispersão geográfica quanto do número de observações: duplicar uma amostra de distribuição semelhante pode gerar muito mais que o dobro de pares. Para comparar conjuntos de tamanhos diferentes, divida a distância total pela contagem de pares para obter a distância média entre pares ou mantenha ambos os valores em sua análise. No limite de 1,000 pontos, a calculadora avalia 499,500 pares, impondo um limite prático ao trabalho quadrático e ainda atendendo a conjuntos consideráveis de instalações, sensores ou áreas de serviço.

Comparar redes de instalações

Meça se conjuntos do mesmo tamanho de armazéns, clínicas ou escritórios estão geograficamente concentrados ou dispersos.

Avaliar a coesão de grupos

Use a soma e a contagem de pares como dados para um diagnóstico reproduzível de distância média em agrupamentos geográficos.

Acompanhar a distribuição de sensores

Compare registros com a mesma quantidade de dispositivos para verificar se uma rede de campo expandiu ou encolheu.

Quanto custa uma solicitação de API?

Cada solicitação de API custa US$ 0,002. A calculadora do navegador pode executar localmente a mesma lógica determinística.

Cada par é contado duas vezes?

Não. Cada par não ordenado contribui uma vez, portanto n pontos geram n(n−1)/2 cálculos de distância.

Qual modelo de distância é usado?

A calculadora usa a fórmula de Haversine e um raio médio da Terra de 6,371.0088 quilômetros.

Posso incluir coordenadas duplicadas?

Sim. Registros duplicados permanecem no conjunto, e a distância entre coordenadas idênticas contribui com zero.

Esta é uma distância rodoviária ou de viagem?

Não. Ela mede a menor distância superficial de grande círculo e não segue estradas, fronteiras, relevo ou redes de transporte.

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/total-pairwise-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/total-pairwise-distance \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"points":[{"latitude":0,"longitude":0},{"latitude":0,"longitude":1},{"latitude":1,"longitude":0}]}'
{
  "points": [
    {
      "latitude": 0,
      "longitude": 0
    },
    {
      "latitude": 0,
      "longitude": 1
    },
    {
      "latitude": 1,
      "longitude": 0
    }
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.total_pairwise_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.

min_points2
max_points1000
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.

Ver a documentação completa do KIT →