POST AI agent ready /v1/geo/distance

API da calculadora de distância - Haversine entre coordenadas

Forneça dois pares de latitude/longitude e receba a distância entre eles calculada usando a fórmula de Haversine. Suporta quilômetros, milhas e milhas náuticas. Preciso para quaisquer dois pontos da Terra. Nenhuma chamada de serviço externo; o cálculo é executado inteiramente no servidor.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/geo/distance \
  -H "Content-Type: application/json" \
  -d '{"from":{"lat":40.7128,"lng":-74.006},"to":{"lat":51.5074,"lng":-0.1278},"unit":"km"}'

When to use this API

Classifique lojas ou restaurantes próximos por distância do usuário

Calcule a distância das coordenadas do usuário até cada local do seu banco de dados. Classifique pelo resultado para mostrar primeiro as opções mais próximas. É executado no lado do servidor para que você não precise de uma chave de API do Google Maps.

Valide o raio de entrega para um checkout de e-commerce

Antes de confirmar um pedido, calcule a distância entre o seu armazém e o endereço de entrega. Rejeite ou aplique uma sobretaxa se a distância exceder a sua zona de entrega.

Crie um rastreador de distância de viagem para aplicativos de fitness ou logística

Envie pontos de referência GPS sequenciais e some as distâncias para calcular a duração total da viagem. Funciona para rotas de corrida, rastreamento de frota ou aplicativos de ciclismo.

Frequently asked questions

Quão precisa é a fórmula de Haversine?

A fórmula de Haversine assume uma esfera perfeita e tem precisão de cerca de 0,3% para a maioria das distâncias na Terra. Para precisão submétrica, use a fórmula de Vincenty, que leva em conta a forma elipsoidal da Terra.

Qual sistema de coordenadas esse ponto final espera?

Graus decimais WGS84. A latitude varia de -90 a 90 (sul para norte). A longitude varia de -180 a 180 (oeste para leste). Este é o mesmo sistema usado por dispositivos GPS e Google Maps.

Posso calcular distâncias para mais de dois pontos?

Este endpoint lida com um par de pontos por solicitação. Para rotas multiponto, chame o ponto final para cada par consecutivo e some as distâncias.

Qual é a diferença entre km, mi e nm?

km = quilômetros (1 km = 1000 metros). mi = milhas estatutárias (1 mi = 1,609 km). nm = milhas náuticas (1 nm = 1,852 km). As milhas náuticas são padrão na aviação e na navegação marítima.

Este endpoint chama um serviço de mapeamento externo?

Não. O cálculo de Haversine é executado inteiramente no servidor, sem chamadas de API externas. Isso significa zero latência adicional e nenhum limite de taxa de terceiros.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.