Einheitsvektor in Breiten- und Längengrad
Wandeln Sie eine kartesische Richtung auf der Einheitskugel in geografische Koordinaten um, die Menschen und Kartensoftware lesen können.
Im Browser ausführen – kostenlos
Geben Sie die Komponenten x, y und z eines Einheitsvektors in einem rechtshändigen System an. Der Rechner liefert Breiten- und Längengrad mit der von Ihnen gewählten Anzeigegenauigkeit. Er prüft, ob der Vektor tatsächlich die Länge eins besitzt, toleriert nur geringfügige Gleitkommaabweichungen und verwendet eine dokumentierte Achsenkonvention. Die Berechnung ist deterministisch, benötigt weder Netzwerk noch Geocoding-Datenbank und kostet $0.002 je erfolgreicher API-Anfrage.
Die Achsenkonvention vor der Umrechnung verstehen
Ein Punkt auf einer Einheitskugel lässt sich mit drei kartesischen Komponenten statt mit zwei Winkeln speichern. Diese Fähigkeit verwendet die verbreitete rechtshändige, erdzentrierte Konvention: Die positive x-Achse zeigt zu Breitengrad null und Längengrad null, die positive y-Achse zu Breitengrad null und neunzig Grad Ost, die positive z-Achse zum Nordpol. Somit wird der Vektor (1, 0, 0) zu null Grad Breite und null Grad Länge, während (0, 1, 0) null Grad Breite und neunzig Grad östliche Länge ergibt. Eine negative y-Komponente legt das Ergebnis westlich des Nullmeridians ab; eine negative z-Komponente führt auf die Südhalbkugel. Der ausgegebene Längengrad liegt im üblichen Bereich von minus einhundertachtzig bis plus einhundertachtzig Grad. An den Polen ist die Länge mathematisch unbestimmt, da dort alle Meridiane zusammentreffen. Die Berechnung gibt dennoch den stabilen atan2-Wert aus den übergebenen x- und y-Komponenten zurück. Prüfen Sie vor einer geografischen Interpretation, ob Vektoren aus Grafik-, Astronomie-, Robotik- oder Simulationssoftware dieselbe Achsenfolge benutzen. Manche Systeme vertauschen y und z oder kehren eine Achse um. Dieses Werkzeug rechnet Koordinaten um, erkennt oder korrigiert jedoch kein undokumentiertes Quellkoordinatensystem.
So funktionieren Prüfung und sphärische Umrechnung
Zunächst prüft der Rechner, ob x, y und z endliche JSON-Zahlen zwischen minus eins und plus eins sind. Danach bestimmt er ihren euklidischen Betrag mit der Hypotenusenfunktion für drei Komponenten. Ein echter Einheitsvektor hat den Betrag eins, doch reale Verarbeitungsketten erzeugen nach Matrixmultiplikation oder Serialisierung häufig harmlose Gleitkommaabweichungen. Deshalb werden Beträge akzeptiert, die höchstens ein Millionstel von eins abweichen, und vor der Winkelberechnung normalisiert. Größere Abweichungen gelten als ungültige Eingabe, statt einen beliebigen Vektor stillschweigend auf die Kugel zu projizieren. Der Breitengrad ist der Arkussinus des normalisierten z-Werts. Der Längengrad wird mit atan2 aus normalisiertem y und x berechnet; dadurch bleibt der richtige Quadrant erhalten und der Antimeridian wird ohne manuelle Vorzeichenregel überquert. Beide Winkel werden von Radiant in Grad umgerechnet und auf die gewünschte Genauigkeit gerundet: standardmäßig zehn Nachkommastellen, wahlweise null bis fünfzehn. Negativ null wird für saubere JSON-Antworten und stabile Tests zu null. Die Antwort enthält ausgeschriebene Felder, die Kürzel lat und lon, die Genauigkeit sowie eine Kennzeichnung der Konvention. Netzwerk, Zufall, Uhrzeit, Datum-Abfrage und iterative Näherung werden nicht verwendet.
Das Ergebnis sicher in Karten und Datenabläufen nutzen
Einheitsvektoren vermeiden Sprünge beim Umlauf des Längengrads, ermöglichen eine gleichmäßige Richtungsinterpolation und passen natürlich in dreidimensionale Systeme. Benutzeroberflächen, GIS-Exporte, Protokolle und Kartenbeschriftungen benötigen dagegen meist Breiten- und Längengrad. Dieser Rechner verbindet beide Darstellungen. Sie können einen Kamerastrahl oder eine Auswahl auf einem Globus in lesbare Koordinaten verwandeln, normalisierte Positionen aus Simulationsdaten entschlüsseln oder nachvollziehbare Testfälle für sphärische Geometrie erzeugen. Prüfen Sie neben dem Betrag auch die Bedeutung der Quelldaten: Eine normalisierte Oberflächennormale und eine erdzentrierte Position können numerisch gleich aussehen, aber verschiedene Sachverhalte beschreiben. Hat der Quellvektor eine beliebige Länge, normalisieren Sie ihn bewusst im erzeugenden System und dokumentieren Sie diese Entscheidung, anstatt die Abweichung durch diesen Endpunkt zu verbergen. Die strenge Längenprüfung soll falsche Einheiten, fehlende Normalisierung und beschädigte Datensätze früh aufdecken. Das Ergebnis beschreibt ausschließlich eine Winkelrichtung; Höhe, Gelände, geodätische Datum-Umrechnung und Ortsnamen sind nicht enthalten. Rufen Sie bei Stapeldaten die Fähigkeit einmal je Element auf und behalten Sie genügend Dezimalstellen. Interaktive Prüfungen laufen im Browser, automatisierte Anfragen verwenden denselben deterministischen Löser für $0.002 je erfolgreicher Anfrage.
Anwendungsfälle
Eine Auswahl auf einem 3D-Globus beschriften
Wandeln Sie eine normalisierte Auswahlrichtung in Breiten- und Längengrad für einen Hinweis, ein Diagnosefeld oder eine exportierte Markierung um.
Simulationskoordinaten entschlüsseln
Überführen Sie Einheitskugel-Positionen aus wissenschaftlichen oder technischen Daten anhand einer dokumentierten Achsenkonvention in lesbare Winkelkoordinaten.
Testfälle für sphärische Geometrie erstellen
Erzeugen Sie stabile Sollwerte für Breiten- und Längengrad, wenn Tests Richtungen als normalisierte kartesische Vektoren speichern.
Häufige Fragen
Was kostet eine Umrechnung?
Eine erfolgreiche API-Anfrage kostet $0.002. Dieselbe deterministische Berechnung kann im Browser ausgeführt werden.
Welche Formel wird verwendet?
Der Breitengrad ist asin(z), der Längengrad atan2(y, x). Zuvor wird der akzeptierte Vektor normalisiert, um kleinste Gleitkommaabweichungen zu entfernen.
Muss der Vektor exakt die Länge eins haben?
Sein Betrag darf höchstens ein Millionstel von eins abweichen. So werden normale Rundungsfehler zugelassen und nicht normalisierte Vektoren abgewiesen.
Welche Koordinatenkonvention gilt?
Positives x bedeutet Breite 0 und Länge 0, positives y bedeutet Breite 0 und Länge 90 Ost, positives z bezeichnet den Nordpol.
Welcher Längengrad wird an einem Pol ausgegeben?
Am exakten Pol ist die Länge nicht definiert. Die Antwort enthält dennoch das stabile atan2-Ergebnis aus den angegebenen x- und y-Komponenten.
Für Entwickler — API-Zugang
Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.
Endpunkt
Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.
Aufruf aus Ihrem Stack
curl -X POST https://api.kit.forhosting.com/geo/unit-vector-to-latlon \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"x":1,"y":0,"z":0}'const res = await fetch("https://api.kit.forhosting.com/geo/unit-vector-to-latlon", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"x": 1,
"y": 0,
"z": 0
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/geo/unit-vector-to-latlon",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"x": 1,
"y": 0,
"z": 0
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/unit-vector-to-latlon", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"x":1,"y":0,"z":0}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"x":1,"y":0,"z":0}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/unit-vector-to-latlon", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Beispiel-Anfrage
{
"x": 1,
"y": 0,
"z": 0
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.unit_vector_to_latlon",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.
Preis
Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.
Fehler
| HTTP | Code | Bedeutung |
|---|---|---|
401 | unauthorized | Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer). |
402 | insufficient_balance | Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht. |
404 | unknown_type | Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog. |
429 | rate_limited | Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt. |