Cross-Track-Distanz-Rechner

Breiten- oder Längengrade außerhalb des Bereichs schlagen mit invalid_input fehl und werden nicht berechnet.

Was die Cross-Track-Distanz bedeutet und wie Sie die drei Punkte angeben

Stellen Sie sich einen Großkreis vor, der durch den Routenanfang A und das Routenende B auf einem sphärischen Erdmodell verläuft. Von jedem dritten Abfragepunkt P können Sie ein Lot entlang eines anderen Großkreises fällen, das die Kurslinie im sphärischen Sinne rechtwinklig trifft. Die Länge dieses Lots, skaliert mit dem Kugelradius, ist die Cross-Track-Distanz. Der Breitengrad muss zwischen minus neunzig und neunzig einschließlich liegen; der Längengrad zwischen minus einhundertachtzig und einhundertachtzig einschließlich. Fallen A und B zusammen, ist die Route undefiniert und die Engine lehnt die Anfrage ab. Die vorzeichenbehaftete Form sagt Ihnen, auf welcher Seite der gerichteten Route Sie sich befinden: Positive Werte bedeuten links auf dem Weg von A nach B, negative Werte rechts, und Beträge nahe null werden aus numerischer Stabilität als on_track gemeldet. Senden Sie die Pflichtfelder lat und lon für den Abfragepunkt, start_lat und start_lon für A sowie end_lat und end_lon für B, alle in Dezimalgrad. Aliase wie latitude, longitude, lat1, lon1, lat2 und lon2 werden akzeptiert, wenn Ihr Client diese Namen bereits verwendet. Jede Koordinate außerhalb dieser Bereiche löst invalid_input mit einer Meldung aus, die Feld und Grenze nennt, sodass Aufrufer fehlerhaftes GPS-Rauschen niemals stillschweigend zu einem falschen Versatz beschneiden. Das optionale Feld radius_m hat standardmäßig den Wert sechs Millionen dreihunderteinundsiebzigtausend Meter, den mittleren Erdradius vieler Luftfahrtbeispiele; erhöhen oder verringern Sie ihn nur, wenn Sie absichtlich eine andere Kugel modellieren. Identische Eingaben erzeugen stets identisches JSON, da die Berechnung reine Arithmetik ohne Wanduhr und ohne externen Kartendienst ist.

Vorzeichenbehaftete Meter, Seitenkennzeichnungen, Along-Track-Distanz und Kurse lesen

Bevorzugen Sie Meter für Drohnenkorridore und Überwachung auf Pistenmaßstab; bevorzugen Sie Kilometer für ozeanische oder Langstreckenflugrouten. Im Erfolgsfall spiegelt die Antwort jede Koordinate und den verwendeten Radius wider und meldet dann cross_track_m und cross_track_km als vorzeichenbehafteten senkrechten Versatz. absolute_m und absolute_km sind der Betrag ohne Vorzeichen, praktisch für Schwellwertprüfungen, bei denen nur die Größe der Abweichung zählt. Das Feld side lautet left, right oder on_track gemäß der in der Nutzlast dokumentierten Vorzeichenkonvention positive_left_of_path_A_to_B. along_track_m misst den Fortschritt von A entlang des unendlichen Großkreises in Richtung B und kann negativ oder größer als die Segmentlänge sein, wenn P außerhalb des endlichen Bogens A–B projiziert wird; verwenden Sie es zusammen mit path_length_m, wenn Sie lateralen und longitudinalen Kontext zugleich benötigen. path_bearing_deg ist der Anfangskurs von A nach B in Grad ab Nord im Uhrzeigersinn auf dem Intervall von null bis dreihundertsechzig, und angular_cross_track_deg formuliert den Versatz in Winkelgraden für Unit-Tests um, die sich mit Lehrbuchtabellen vergleichen. method ist immer spherical_cross_track, sodass nachgelagerter Code den Algorithmus prüfen kann, ohne Formen zu erraten. Validierungsfehler erfinden niemals eine Distanz: fehlende Felder, nicht endliche Zahlen, Koordinaten außerhalb des Bereichs und zusammenfallende Endpunkte schlagen geschlossen mit invalid_input fehl und werden in der Prepaid-API nicht berechnet.

API-Nutzung, Preise, Navigations-Workflows und praktische Grenzen

Senden Sie einen JSON-Body mit den sechs Pflichtkoordinaten und dem optionalen radius_m; nutzen Sie den kostenlosen Cross-Track-Distanz-Rechner im Browser für Unterrichtsdemos, Kartenarbeit und schnelle Überschlagsprüfungen ohne Installation einer Geobibliothek. Verwenden Sie die Prepaid-API, wenn ein Flugbetriebs-Dashboard, ein Schiffsverkehrssystem, ein Router für die letzte Meile oder ein Simulations-harness einen stabilen Vertrag mit KIT-Guthaben zu $0.002 pro erfolgreichem Element benötigt; Validierungsfehler verbrauchen nach der Ablehnung durch die Engine niemals Guthaben. Kombinieren Sie diesen Endpoint mit Ihrem eigenen Geokodierer oder AIS-Feed, wenn Sie Ortsnamen oder Live-Tracks benötigen: Dieses Produkt misst nur Geometrie auf der Kugel. Das Modell ist sphärisch, nicht ellipsoidisch; für Vermessungsarbeiten im Submeterbereich sollten Sie stattdessen eine lokale ENU- oder vollständige geodätische Bibliothek einsetzen; für Navigationskorridore, Hausaufgaben und Flottenwarnungen entspricht die mittlere Erdkugel den Formeln in den Standardreferenzen für Piloten und Seefahrer. Autoren, die SDKs ausliefern, können cross_track_m und side direkt in Alarmregeln abbilden: auslösen, wenn absolute_m die halbe Korridorbreite überschreitet, und die Karte anhand derselben Felder grün, gelb oder rot einfärben, die Studierende sehen, wenn sie das sphärische Dreieck von Hand lösen.