Distance haversine - orthodromie en km, mi et m entre deux points

Lorsque vous avez besoin du plus court chemin sur la surface de la Terre entre deux coordonnées GPS, les calculs planaires et la simple distance euclidienne sont faux : ils ignorent la courbure et produisent de grandes erreurs sur les trajets de ville à ville et de pays à pays. Ce point de terminaison accepte deux couples latitude/longitude, valide leurs plages, et renvoie la distance en kilomètres, en miles terrestres et en mètres en un seul appel déterministe, sans tuiles cartographiques, sans géocodage tiers et sans saut réseau caché.

Ce que la formule de haversine calcule réellement

La formule de haversine est une manière numériquement stable d'évaluer l'angle au centre entre deux points d'une sphère à partir de leurs latitudes et longitudes, puis de multiplier cet angle par le rayon de la sphère pour obtenir la longueur de l'arc. En clair : étant donné un point A et un point B, elle répond à la question de savoir quelle distance vous parcourriez en suivant le plus court chemin sur un globe lisse plutôt que sur une carte plane.

Elle n'emploie pas de modèle ellipsoïdal tel que Vincenty ou Karney sur WGS84, si bien que les résultats peuvent différer d'une infime fraction de pourcent des bibliothèques géodésiques qui modélisent l'aplatissement polaire — ce qui convient généralement aux vérifications de rayon autour d'un point de vente, aux fourchettes de délai de livraison et aux paniers analytiques, mais ne remplace pas un relevé topographique de précision. La sortie comprend toujours trois unités : kilomètres (km), miles terrestres internationaux (mi, à raison de 1609,344 mètres par mile) et mètres (m).

Contrat d'entrée, plages de coordonnées et erreurs courantes

La latitude doit appartenir à l'intervalle fermé de −90 à 90 ; la longitude doit appartenir à −180 à 180 inclus. Les champs manquants, les valeurs non finies ou les chaînes qui ne s'analysent pas comme des nombres échouent également à la validation avant tout calcul de distance.

Un bogue client fréquent consiste à intervertir latitude et longitude (par exemple en collant des centres-villes sous la forme lng,lat par une habitude issue du GeoJSON) : l'appel peut réussir si les deux nombres tombent toujours dans les deux plages, mais la distance sera absurde pour les villes que vous visez — vérifiez toujours que lat est l'axe nord-sud et lng l'axe est-ouest. Des points identiques renvoient correctement une distance nulle.

Les couples antipodaux sont pris en charge ; un écrêtage interne empêche les cas limites de la virgule flottante de produire NaN.

La place de la distance orthodromique dans un pipeline produit

Utilisez le haversine comme une primitive de distance peu coûteuse et vérifiable au sein des barrières de rayon à la commande, de la sélection de l'entrepôt le plus proche, des signaux de fraude qui comparent la ville de facturation au GPS de l'appareil, des récapitulatifs d'activité des applications sportives et des travaux d'enrichissement CSV en masse qui ont besoin de kilomètres ou de miles à côté de chaque couple origine-destination.

Associez-le à un géocodeur seulement lorsque vous partez d'adresses ; une fois que vous disposez déjà de lat/lng, évitez de géocoder à nouveau juste pour obtenir une distance. Pour le routage à plusieurs arrêts, le temps de trajet routier ou les itinéraires détaillés, conservez un moteur de routage dédié — le haversine est à vol d'oiseau, non une distance de conduite. Pour les limites juridiques de propriété ou le travail cadastral, utilisez des géodésiques ellipsoïdales et un CRS local.