Calcolatore distanza Vincenty

Questa capacità prende due coppie di latitudine e longitudine, esegue l’iterazione classica di Vincenty con semiasse maggiore e schiacciamento WGS-84 fissi, e restituisce metri, chilometri e azimut iniziale e finale come JSON deterministico.

Cosa misura la distanza Vincenty e come fornire i due punti

Invii i campi obbligatori lat1 e lon1 per il primo punto WGS-84 e lat2 e lon2 per il secondo, tutti in gradi decimali. Alias come from_lat, to_lat, from_lon, to_lon, latitude1 e longitude1 sono accettati quando il client usa già quei nomi. Qualsiasi coordinata fuori da quegli intervalli solleva invalid_input con un messaggio che nomina il campo e il limite, così i chiamanti non ritagliano mai in silenzio un rumore GPS cattivo in una geodetica falsa. Entrate identiche producono sempre lo stesso JSON perché il percorso è aritmetica pura con costanti WGS-84 fisse, senza orologio di parete e senza servizio mappe esterno.

Lettura di metri, chilometri, azimut, iterazioni e convergenza

Preferisca i metri per corridoi di rilievo e lavoro a scala di pista; preferisca i chilometri per tratte interurbane e oceaniche. In caso di successo la risposta ecoa ogni coordinata di ingresso, poi distance_m e distance_km come lunghezza geodetica ellissoidica. initial_bearing_deg è l’azimut diretto al primo punto misurato in senso orario dal nord vero sull’intervallo da zero a trecentosessanta; final_bearing_deg è l’azimut inverso corrispondente al secondo punto dopo l’arrivo della geodetica. iterations conta quante aggiornamenti di longitudine ha servito il solver prima che il residuo scendesse sotto l’epsilon pubblicato, il che aiuta a diagnosticare coppie limite senza rifare il ciclo a mano. ellipsoid è sempre la stringa WGS-84, a_m è il semiasse maggiore in metri e f è lo schiacciamento, così il codice a valle può affermare il datum senza codificare costanti in ogni client. method è sempre vincenty_inverse e converged è true su ogni risposta riuscita. Quando due punti sono quasi antipodali l’iterazione classica può non stabilizzarsi mai; il motore si ferma a un tetto rigido di iterazioni e solleva invalid_input con un messaggio che nomina il fallimento quasi antipodale invece di restituire una distanza a metà. I fallimenti di validazione per campi mancanti, numeri non finiti e coordinate fuori intervallo falliscono pure in modo chiuso e non sono addebitati sotto l’API prepagata.

Uso API, prezzi, flussi GIS e limiti pratici

Invii un corpo JSON con le quattro coordinate obbligatorie, poi usi il calcolatore gratuito di distanza Vincenty nel browser per demo in aula, controlli di carta e verifica mentale rapida senza installare PROJ, GeographicLib o un GIS completo. Usi l’API prepagata quando una piattaforma logistica, uno strumento di pianificazione di volo, un flusso catastale o un harness di simulazione necessita di un contratto stabile sotto saldo KIT a $0.002 per elemento riuscito; i fallimenti di validazione e le antipodi non convergenti non consumano mai il saldo dopo il rifiuto del motore. Abbini questo endpoint al Suo geocoder quando servono nomi di luogo: questo prodotto misura solo geometria sull’ellissoide WGS-84. Per separazioni continentali ordinarie Vincenty è accurato a ben meno di un metro rispetto alle librerie geodetiche moderne; per la fascia sottile di casi quasi antipodali in cui l’iterazione del 1975 diverge, passi a un solver antipodale specializzato o a una geodetica in stile Karney piuttosto che forzare questo endpoint. Gli autori di SDK possono mappare distance_m e initial_bearing_deg direttamente in schede di percorso e test unitari — gli stessi numeri che gli studenti vedono lavorando un esempio di rilievo da coppie lat-lon pubblicate.