Ir al contenido
POST AI agent ready /v1/geo/distance

API de calculadora de distancia: Haversine entre coordenadas

Proporcione dos pares de latitud/longitud y reciba la distancia entre ellos calculada utilizando la fórmula de Haversine. Admite kilómetros, millas y millas náuticas. Preciso para dos puntos cualesquiera de la Tierra. Sin llamadas de servicio externo; el cálculo se ejecuta completamente en el servidor.

Parameters

objectrequired

The origin point with lat (-90 to 90) and lng (-180 to 180).

objectrequired

The destination point with lat (-90 to 90) and lng (-180 to 180).

string

The distance unit for the result.

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

Ordenar tiendas o restaurantes cercanos por distancia del usuario

Calcule la distancia desde las coordenadas del usuario hasta cada ubicación en su base de datos. Ordene por resultado para mostrar primero las opciones más cercanas. Se ejecuta en el lado del servidor, por lo que no necesita una clave API de Google Maps.

Validar el radio de entrega para un pago de comercio electrónico

Antes de confirmar un pedido, calcula la distancia entre tu almacén y la dirección de entrega. Rechaza o aplica un recargo si la distancia excede tu zona de entrega.

Cree un rastreador de distancia recorrida para aplicaciones de fitness o logística

Envíe puntos de referencia GPS secuenciales y sume las distancias para calcular la duración total del viaje. Funciona para rutas de carrera, seguimiento de flotas o aplicaciones de ciclismo.

Frequently asked questions

¿Qué tan precisa es la fórmula de Haversine?
La fórmula de Haversine supone una esfera perfecta y tiene una precisión de aproximadamente el 0,3% para la mayoría de las distancias en la Tierra. Para una precisión submétrica, utilice la fórmula de Vincenty, que tiene en cuenta la forma elipsoidal de la Tierra.
¿Qué sistema de coordenadas espera este punto final?
Grados decimales WGS84. La latitud oscila entre -90 y 90 (de sur a norte). La longitud varía de -180 a 180 (de oeste a este). Este es el mismo sistema que utilizan los dispositivos GPS y Google Maps.
¿Puedo calcular distancias para más de dos puntos?
Este punto final maneja un par de puntos por solicitud. Para rutas multipunto, llame al punto final de cada par consecutivo y sume las distancias.
¿Cuál es la diferencia entre km, mi y nm?
km = kilómetros (1 km = 1000 metros). mi = millas terrestres (1 mi = 1,609 km). nm = millas náuticas (1 nm = 1,852 km). Las millas náuticas son estándar en la aviación y la navegación marítima.
¿Este punto final llama a un servicio de mapeo externo?
No. El cálculo de Haversine se ejecuta completamente en el servidor sin llamadas API externas. Esto significa cero latencia adicional y sin límites de velocidad de terceros.

Get your API key

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

Sign up free View full docs