Distancia haversine - km, mi y m de círculo máximo entre dos puntos

Cuando necesita el camino más corto sobre la superficie de la Tierra entre dos coordenadas GPS, la matemática plana y la simple distancia euclidiana están equivocadas: ignoran la curvatura y producen grandes errores en saltos de ciudad a ciudad y de país a país.

Qué calcula realmente la fórmula haversine

La fórmula haversine es una manera numéricamente estable de evaluar el ángulo central entre dos puntos sobre una esfera a partir de sus latitudes y longitudes, para luego multiplicar ese ángulo por el radio de la esfera y obtener la longitud del arco. Dicho de forma sencilla: dados el punto A y el punto B, responde cuánto recorrería usted si siguiera el camino más corto sobre un globo terráqueo liso en lugar de un mapa plano.

No emplea un modelo elipsoidal como Vincenty o Karney sobre WGS84, de modo que los resultados pueden diferir en una pequeña fracción de un por ciento respecto a las bibliotecas geodésicas que modelan el achatamiento polar; por lo general esto basta para comprobaciones de radio de tiendas, franjas de tiempo estimado de entrega y agrupaciones de analítica, y no sustituye a la topografía de grado profesional. La salida siempre son tres unidades: kilómetros (km), millas terrestres internacionales (mi, con 1609.344 metros por milla) y metros (m).

Contrato de entrada, rangos de coordenadas y errores frecuentes

La latitud debe estar en el intervalo cerrado de −90 a 90; la longitud debe estar en −180 a 180 inclusive. Los campos que faltan, los valores no finitos o las cadenas que no se interpretan como números también fallan la validación antes de calcular cualquier distancia.

Un fallo habitual del cliente es intercambiar latitud y longitud (por ejemplo, pegar centros de ciudades como lng,lat por costumbre al estilo GeoJSON): la llamada puede tener éxito si ambos números siguen dentro de los dos rangos, pero la distancia carecerá de sentido para las ciudades que usted pretendía; compruebe siempre que lat es norte-sur y lng es este-oeste. Los puntos idénticos devuelven correctamente distancia cero. Se admiten los pares antipodales; el acotamiento interno impide que los casos límite de coma flotante produzcan NaN.

Dónde encaja la distancia de círculo máximo en la tubería de un producto

Utilice haversine como una primitiva de distancia barata y auditable dentro de las barreras de radio en el pago, la selección del almacén más cercano, las señales de fraude que comparan la ciudad de facturación con el GPS del dispositivo, los resúmenes de actividad de apps deportivas y los trabajos masivos de enriquecimiento de CSV que necesitan km o millas junto a cada par origen-destino. Combínela con un geocodificador solo cuando parta de direcciones; una vez que ya tiene lat/lng, evite volver a geocodificar únicamente para obtener la distancia.

Para el enrutamiento con varias paradas, el tiempo de viaje por carretera o los caminos con indicaciones giro a giro, conserve un motor de enrutamiento dedicado: haversine es en línea recta, no distancia de conducción. Para los límites legales de propiedades o el trabajo catastral, use geodésicas elipsoidales y un CRS local.