Calculateur de distance cross-track sur route de grand cercle

Cette fonctionnalité prend la latitude et la longitude du point de requête ainsi que les coordonnées de début et de fin de la route sur la sphère WGS84, applique la formule sphérique classique avec la distance de haversine et les caps initiaux, et renvoie des mètres et des kilomètres avec une étiquette claire : gauche, droite ou sur la route. Les latitudes ou longitudes hors limites échouent avec invalid_input et ne sont pas facturées.

Ce que signifie la distance cross-track et comment fournir les trois points

Imaginez un grand cercle tracé par le début A et la fin B de la route sur un modèle sphérique de la Terre. Depuis tout troisième point P, vous pouvez abaisser une perpendiculaire le long d'un autre grand cercle qui rencontre la ligne de route à angle droit au sens sphérique. La longueur de cette perpendiculaire, mise à l'échelle par le rayon de la sphère, est la distance cross-track. Si A et B coïncident, la route est indéfinie et le moteur rejette la requête. La forme signée indique de quel côté de la route orientée vous vous trouvez : les valeurs positives signifient à gauche en voyageant de A vers B, les valeurs négatives à droite, et les magnitudes proches de zéro sont rapportées comme on_track pour la stabilité numérique. Envoyez les champs obligatoires lat et lon pour le point de requête, start_lat et start_lon pour A, et end_lat et end_lon pour B, tous en degrés décimaux. Des alias tels que latitude, longitude, lat1, lon1, lat2 et lon2 sont acceptés lorsque votre client utilise déjà ces noms. La latitude doit être comprise entre moins quatre-vingt-dix et quatre-vingt-dix inclus ; la longitude entre moins cent quatre-vingts et cent quatre-vingts inclus. Toute coordonnée hors de ces plages déclenche invalid_input avec un message qui nomme le champ et la borne, de sorte que les appelants ne tronquent jamais silencieusement un bruit GPS erroné en un faux écart. Le champ facultatif radius_m vaut par défaut six millions trois cent soixante et onze mille mètres, le rayon moyen de la Terre utilisé dans de nombreux exemples d'aviation ; ne l'augmentez ou ne le diminuez que lorsque vous modélisez intentionnellement une autre sphère. Des entrées identiques produisent toujours un JSON identique, car le calcul est une arithmétique pure, sans horloge murale ni service cartographique externe.

Lire les mètres signés, les étiquettes de côté, la distance le long de la route et les caps

Préférez les mètres pour les couloirs de drones et la surveillance à l'échelle d'une piste ; préférez les kilomètres pour les routes océaniques ou aériennes long-courrier. En cas de succès, la réponse reprend chaque coordonnée et le rayon utilisé, puis rapporte cross_track_m et cross_track_km comme l'écart perpendiculaire signé. absolute_m et absolute_km sont la magnitude sans signe, pratiques pour les contrôles de seuil qui ne s'intéressent qu'à l'ampleur de l'écart. Le champ side vaut left, right ou on_track selon la convention de signe positive_left_of_path_A_to_B documentée dans la charge utile. along_track_m mesure la progression depuis A le long du grand cercle infini vers B et peut être négatif ou supérieur à la longueur du segment lorsque P se projette en dehors de l'arc fini A–B ; utilisez-le avec path_length_m lorsque vous avez besoin du contexte latéral et longitudinal à la fois. path_bearing_deg est le cap initial de A vers B en degrés depuis le nord, dans le sens horaire, sur l'intervalle de zéro à trois cent soixante, et angular_cross_track_deg reformule l'écart en degrés angulaires pour les tests unitaires qui se comparent aux tables des manuels. method vaut toujours spherical_cross_track, afin que le code en aval puisse vérifier l'algorithme sans renifler les formes. Les échecs de validation n'inventent jamais de distance : champs manquants, nombres non finis, coordonnées hors limites et extrémités coïncidentes échouent en mode fermé avec invalid_input et ne sont pas facturés dans l'API prépayée.

Utilisation de l'API, tarifs, flux de navigation et limites pratiques

Le modèle est sphérique, pas ellipsoïdal ; pour les travaux topographiques submétriques, appliquez plutôt une bibliothèque géodésique locale ENU ou complète ; pour les couloirs de navigation, les devoirs et les alertes de flotte, la sphère de Terre moyenne correspond aux formules publiées dans les références standard des pilotes et des marins. Envoyez un corps JSON avec les six coordonnées obligatoires et le radius_m facultatif ; utilisez le calculateur de distance cross-track gratuit dans le navigateur pour les démonstrations en classe, le travail sur carte et les vérifications rapides sans installer de bibliothèque géospatiale. Utilisez l'API prépayée lorsqu'un tableau de bord d'opérations aériennes, un système de trafic maritime, un routeur de livraison du dernier kilomètre ou un harness de simulation a besoin d'un contrat stable avec solde KIT à $0.002 par élément réussi ; les échecs de validation ne consomment jamais de solde après le rejet de la requête par le moteur. Associez ce endpoint à votre propre géocodeur ou flux AIS lorsque vous avez besoin de noms de lieux ou de routes en direct : ce produit ne mesure que la géométrie sur la sphère. Les auteurs qui publient des SDKs peuvent mapper cross_track_m et side directement dans des règles d'alerte : déclenchez lorsque absolute_m dépasse la demi-largeur du couloir et colorez la carte en vert, orange ou rouge à partir des mêmes champs que voient les étudiants lorsqu'ils résolvent le triangle sphérique à la main.