Calcolatore di distanza cross-track su rotta di cerchio massimo

Latitudini o longitudini fuori intervallo falliscono con invalid_input e non vengono addebitate.

Cosa significa la distanza cross-track e come fornire i tre punti

Immagini un cerchio massimo tracciato attraverso l'inizio A e la fine B della rotta su un modello sferico della Terra. Da qualsiasi terzo punto P può abbassare una perpendicolare lungo un altro cerchio massimo che incontra la linea di rotta ad angolo retto in senso sferico. La lunghezza di tale perpendicolare, scalata per il raggio della sfera, è la distanza cross-track. La latitudine deve essere compresa tra meno novanta e novanta inclusi; la longitudine tra meno centottanta e centottanta inclusi. Se A e B coincidono, la rotta è indefinita e il motore rifiuta la richiesta. La forma con segno indica su quale lato della rotta orientata si trova: i valori positivi significano a sinistra viaggiando da A verso B, i valori negativi a destra, e le magnitudini vicine allo zero vengono riportate come on_track per stabilità numerica. Invii i campi obbligatori lat e lon per il punto di interrogazione, start_lat e start_lon per A, ed end_lat ed end_lon per B, tutti in gradi decimali. Alias come latitude, longitude, lat1, lon1, lat2 e lon2 sono accettati quando il Suo client usa già quei nomi. Qualsiasi coordinata al di fuori di tali intervalli genera invalid_input con un messaggio che indica il campo e il limite, così i chiamanti non troncano mai silenziosamente rumore GPS errato in uno scarto fasullo. Il campo opzionale radius_m vale per impostazione predefinita sei milioni trecentosettantunomila metri, il raggio medio della Terra usato in molti esempi aeronautici; lo aumenti o lo riduca solo quando intende modellare un'altra sfera. Ingressi identici producono sempre un JSON identico, perché il calcolo è aritmetica pura, senza orologio da parete né servizio cartografico esterno.

Lettura dei metri con segno, delle etichette di lato, della distanza lungo la rotta e dei rilevamenti

Preferisca i metri per i corridoi dei droni e il monitoraggio su scala di pista; preferisca i chilometri per le rotte oceaniche o aeree a lungo raggio. In caso di successo, la risposta riporta ogni coordinata e il raggio utilizzato, quindi indica cross_track_m e cross_track_km come scarto perpendicolare con segno. absolute_m e absolute_km sono la magnitudine senza segno, utili per i controlli di soglia in cui interessa solo quanto ci si è allontanati. Il campo side vale left, right o on_track secondo la convenzione di segno positive_left_of_path_A_to_B documentata nel payload. along_track_m misura il progresso da A lungo il cerchio massimo infinito verso B e può essere negativo o maggiore della lunghezza del segmento quando P si proietta al di fuori dell'arco finito A–B; lo usi con path_length_m quando Le servono sia il contesto laterale sia quello longitudinale. path_bearing_deg è il rilevamento iniziale da A a B in gradi dal nord in senso orario sull'intervallo da zero a trecentosessanta, e angular_cross_track_deg riformula lo scarto in gradi angolari per i test unitari che si confrontano con le tabelle dei manuali. method è sempre spherical_cross_track, così il codice a valle può verificare l'algoritmo senza ispezionare le forme. I fallimenti di validazione non inventano mai una distanza: campi mancanti, numeri non finiti, coordinate fuori intervallo ed estremi coincidenti falliscono in modo chiuso con invalid_input e non vengono addebitati nell'API prepagata.

Uso dell'API, prezzi, flussi di navigazione e limiti pratici

Il modello è sferico, non ellissoidale, quindi per rilievi con precisione submetrica dovrebbe applicare una libreria geodetica locale ENU o completa; per corridoi di navigazione, compiti e avvisi di flotta, la sfera della Terra media corrisponde alle formule pubblicate nei riferimenti standard di piloti e marinai. Invii un corpo JSON con le sei coordinate obbligatorie e il radius_m opzionale; usi il calcolatore di distanza cross-track gratuito nel browser per dimostrazioni in aula, lavoro sulle carte e verifiche rapide senza installare una libreria geospaziale. Usi l'API prepagata quando un cruscotto delle operazioni di volo, un sistema di traffico navale, un router di consegne dell'ultimo miglio o un harness di simulazione necessita di un contratto stabile con saldo KIT a $0.002 per elemento riuscito; i fallimenti di validazione non consumano mai saldo dopo che il motore ha rifiutato la richiesta. Abbini questo endpoint al Suo geocodificatore o feed AIS quando Le servono nomi di luoghi o rotte in tempo reale: questo prodotto misura solo la geometria sulla sfera. Gli autori che distribuiscono SDK possono mappare cross_track_m e side direttamente nelle regole di avviso: scatti quando absolute_m supera la semilarghezza del corridoio e colori la mappa in verde, ambra o rosso dagli stessi campi che vedono gli studenti quando risolvono a mano il triangolo sferico.