Calculateur de distance Vincenty

Cette capacité prend deux paires de latitude et longitude, exécute l’itération classique de Vincenty avec demi-grand axe et aplatissement WGS-84 fixes, et renvoie mètres, kilomètres et caps initial et final en JSON déterministe.

Ce que mesure la distance Vincenty et comment fournir les deux points

Envoyez les champs obligatoires lat1 et lon1 pour le premier point WGS-84 et lat2 et lon2 pour le second, tous en degrés décimaux. Des alias tels que from_lat, to_lat, from_lon, to_lon, latitude1 et longitude1 sont acceptés lorsque votre client utilise déjà ces noms. Toute coordonnée hors de ces plages lève invalid_input avec un message nommant le champ et la borne, de sorte que les appelants ne rognent jamais en silence un bruit GPS mauvais en fausse géodésique. Des entrées identiques produisent toujours le même JSON car le chemin est de l’arithmétique pure avec constantes WGS-84 fixes, sans horloge murale ni service cartographique externe.

Lire mètres, kilomètres, caps, itérations et convergence

Préférez les mètres pour les corridors de levé et le travail à l’échelle de piste ; préférez les kilomètres pour les trajets interurbains et océaniques. En cas de succès la réponse renvoie chaque coordonnée d’entrée, puis distance_m et distance_km comme longueur géodésique ellipsoïdale. initial_bearing_deg est l’azimut direct au premier point mesuré dans le sens horaire depuis le nord vrai sur l’intervalle zéro à trois cent soixante ; final_bearing_deg est l’azimut inverse correspondant au second point après l’arrivée de la géodésique. iterations compte combien de mises à jour de longitude le solveur a besoin avant que le résidu tombe sous l’epsilon publié, ce qui aide à diagnostiquer les paires limites sans refaire la boucle à la main. ellipsoid est toujours la chaîne WGS-84, a_m le demi-grand axe en mètres et f l’aplatissement, pour que le code aval puisse affirmer le datum sans coder en dur les constantes dans chaque client. method est toujours vincenty_inverse et converged est true sur chaque réponse réussie. Lorsque deux points sont quasi antipodaux l’itération classique peut ne jamais se stabiliser ; le moteur s’arrête à un plafond dur d’itérations et lève invalid_input avec un message nommant l’échec quasi antipodal plutôt que de renvoyer une distance à demi faite. Les échecs de validation pour champs manquants, nombres non finis et coordonnées hors plage échouent aussi de façon fermée et ne sont pas facturés sous l’API prépayée.

Usage API, tarification, flux SIG et limites pratiques

Envoyez un corps JSON avec les quatre coordonnées obligatoires, puis utilisez le calculateur gratuit de distance Vincenty dans le navigateur pour des démos en classe, des contrôles de carte et une vérification mentale rapide sans installer PROJ, GeographicLib ou un SIG complet. Utilisez l’API prépayée lorsqu’une plateforme logistique, un outil de planification de vol, un flux cadastral ou un harness de simulation a besoin d’un contrat stable sous solde KIT à $0.002 par élément réussi ; les échecs de validation et les antipodes non convergents ne consomment jamais le solde après le rejet du moteur. Associez ce endpoint à votre propre géocodeur lorsque vous avez besoin de noms de lieux : ce produit ne mesure que la géométrie sur l’ellipsoïde WGS-84. Pour des séparations continentales ordinaires Vincenty est précis à bien moins d’un mètre par rapport aux bibliothèques géodésiques modernes ; pour la fine bande de cas quasi antipodaux où l’itération de 1975 diverge, passez à un solveur antipodal spécialisé ou à une géodésique de type Karney plutôt que de forcer cet endpoint. Les auteurs de SDK peuvent mapper distance_m et initial_bearing_deg directement dans des cartes d’itinéraire et des tests unitaires — les mêmes nombres que les étudiants voient en traitant un exemple de levé à partir de paires lat-lon publiées.