Distanza haversine - km, mi e m dell'ortodromia tra due punti

Quando Le serve il percorso più breve sulla superficie terrestre tra due coordinate GPS, la matematica planare e la semplice distanza euclidea sbagliano: ignorano la curvatura e producono errori enormi sui tragitti da città a città e da paese a paese.

Che cosa calcola davvero la formula dell'haversine

La formula dell'haversine è un modo numericamente stabile per valutare l'angolo al centro tra due punti su una sfera a partire dalle loro latitudini e longitudini, per poi moltiplicare quell'angolo per il raggio della sfera e ottenere la lunghezza dell'arco. In parole semplici: dati il punto A e il punto B, risponde a quanto viaggerebbe seguendo il percorso più breve su un globo liscio anziché su una mappa piatta.

Non usa un modello ellissoidico come Vincenty o Karney su WGS84, quindi i risultati possono discostarsi di una piccola frazione di punto percentuale dalle librerie geodetiche che modellano lo schiacciamento polare: di norma va benissimo per i controlli di raggio dei punti vendita, per le fasce di ETA delle consegne e per i bucket analitici, e non sostituisce un rilievo topografico di precisione. L'output è sempre in tre unità: chilometri (km), miglia terrestri internazionali (mi, con 1609,344 metri per miglio) e metri (m).

Contratto di input, intervalli delle coordinate ed errori comuni

La latitudine deve rientrare nell'intervallo chiuso da −90 a 90; la longitudine deve rientrare da −180 a 180 inclusi. Anche i campi mancanti, i valori non finiti o le stringhe che non si interpretano come numeri falliscono la convalida prima che venga calcolata qualsiasi distanza.

Un errore frequente lato client è invertire latitudine e longitudine (per esempio incollando i centri delle città come lng,lat per abitudine simile al GeoJSON): la chiamata può riuscire se entrambi i numeri rientrano ancora nei due intervalli, ma la distanza risulterà priva di senso per le città che intendeva: verifichi sempre che lat sia nord-sud e lng est-ovest. Punti identici restituiscono correttamente distanza zero. Le coppie antipodali sono supportate; un clamping interno impedisce che i casi limite in virgola mobile producano NaN.

Dove si colloca la distanza di ortodromia in una pipeline di prodotto

Usi l'haversine come primitiva di distanza economica e verificabile all'interno dei controlli di raggio al checkout, della selezione del magazzino più vicino, dei segnali antifrode che confrontano la città di fatturazione con il GPS del dispositivo, dei riepiloghi di attività delle app sportive e delle attività di arricchimento CSV in blocco che devono avere i km o le miglia accanto a ogni coppia origine–destinazione. La abbini a un geocoder solo quando parte da indirizzi; una volta che ha già lat/lng, eviti di rifare la geocodifica solo per ottenere la distanza.

Per l'instradamento a più tappe, per i tempi di percorrenza su strada o per i percorsi svolta per svolta, mantenga un motore di routing dedicato: l'haversine è in linea d'aria, non è la distanza di guida. Per i confini catastali legali o il lavoro catastale, usi geodetiche ellissoidiche e un CRS locale.