ForHosting KIT · Entwickler-Tools

Peilung auf den Bereich 0 bis 360 Grad normalisieren

Wandeln Sie eine negative Peilung, einen Winkel über einer Umdrehung oder einen bereits üblichen Azimut in einen einheitlichen Wert von null bis unter 360 Grad um.

● BetaKostenlos · im Browser
Nutzen Sie es über WebAPIE-MailTelegramApp bald

Der Rechner berücksichtigt vollständige 360-Grad-Drehungen, ohne die dargestellte Richtung zu verändern. Das eignet sich für Navigation, Vermessung, Kartografie, Robotik und Tabellen mit unterschiedlichen Winkelkonventionen. Geben Sie einen endlichen Gradwert ein; Sie erhalten den ursprünglichen Wert und sein normalisiertes Gegenstück durch eine deterministische Berechnung ohne externe Abfrage.

Den normalisierten Bereich verstehen

Eine Peilung beschreibt eine Richtung auf einem vollständigen Kreis. Winkel, die sich um ein ganzzahliges Vielfaches von 360 Grad unterscheiden, zeigen daher genau in dieselbe Richtung. So sind 10 Grad, 370 Grad und -350 Grad gleichwertig. Die Normalisierung wählt aus dieser unbegrenzten Familie eine einheitliche Darstellung. Der Rechner verwendet das halboffene Intervall von einschließlich 0 Grad bis ausschließlich 360 Grad. Norden wird deshalb als 0 Grad ausgegeben, niemals als 360; Osten, Süden und Westen entsprechen 90, 180 und 270 Grad. Diese Konvention verhindert zwei kanonische Werte an der Grenze. Die Richtung wird weder gedreht noch gerundet oder neu interpretiert. Es werden nur vollständige Drehungen addiert oder subtrahiert, bis der Wert im Zielbereich liegt. Dezimalstellen bleiben erhalten: Aus 721.25 Grad werden folglich 1.25 Grad.

Winkel eingeben und Ergebnis prüfen

Geben Sie eine einzelne endliche numerische Peilung in Grad an. Der Wert darf bereits zwischen 0 und 360 liegen, negativ sein oder mehrere positive beziehungsweise negative Umdrehungen enthalten. Werte im Zielbereich bleiben unverändert; lediglich negatives Null wird als gewöhnliche Null dargestellt. Von 725.5 Grad werden zwei Drehungen abgezogen, sodass 5.5 Grad verbleiben. Bei -10 Grad ergibt das Addieren einer Drehung 350 Grad. Die Implementierung nutzt direkt den entsprechenden Restwert, sodass die Rechenzeit nicht von der Zahl der Umdrehungen abhängt. Prüfen Sie vor der Verwendung, ob die Quelle tatsächlich Grad und die erwartete Peilungskonvention nutzt. Radiant wird nicht umgerechnet, und eine gegen den Uhrzeigersinn gemessene Quelle kann nicht erkannt werden. Fehlende, nichtnumerische, unendliche oder NaN-Werte werden abgelehnt.

Normalisierte Peilungen sicher verwenden

Ein normalisiertes Ergebnis vereinfacht Vergleiche, Speicherung, Sortierung, Anzeige und weitere Formeln, ändert jedoch nur den numerischen Überlauf. Es wandelt magnetisch Nord nicht in geografisch Nord um, berücksichtigt weder Deklination noch Gitterkonvergenz und berechnet keine Route. Bewahren Sie solche Angaben separat auf. Kreisförmige Vergleiche erfordern an der Grenze besondere Sorgfalt: 359 Grad und 1 Grad liegen nur 2 Grad auseinander, obwohl gewöhnliche Subtraktion 358 ergibt. Normalisieren Sie beide Werte und verwenden Sie anschließend eine Formel für die Kreisdifferenz. Speichern Sie bei automatischer Bereinigung den Originalwert mit, wenn Nachvollziehbarkeit wichtig ist. Jede API-Anfrage verarbeitet ein Element und kostet $0.002. Die Berechnung verwendet weder Netzwerk, Datum, Zufall noch veränderliche Tabellen. Identische endliche Eingaben liefern daher stets identische Ergebnisse. Eine gewünschte Anzeigerundung sollte erst danach passend zur Messgenauigkeit erfolgen.

Navigationsdaten bereinigen

Vereinheitlichen Sie negative und mehrfache Peilungen, bevor Fahrzeug-, Schiffs- oder Flugdaten gespeichert oder verglichen werden.

Roboterorientierung begrenzen

Wandeln Sie aufsummierte Drehungen in eine kanonische Ausrichtung für Anzeigen und Steuerungsgrenzen um.

Kartografische Felder vorbereiten

Normalisieren Sie importierte Azimutspalten vor ihrer Nutzung in GIS, Prüfungen oder Richtungsberechnungen.

Welchen Bereich verwendet das Ergebnis?

Das Ergebnis ist mindestens 0 Grad und stets kleiner als 360 Grad. Eine vollständige Drehung wird als 0 Grad dargestellt.

Wie werden negative Peilungen behandelt?

Bei Bedarf werden vollständige 360-Grad-Drehungen addiert. Beispielsweise wird -10 Grad zu 350 Grad.

Was geschieht mit Werten über 360 Grad?

Vollständige Drehungen werden entfernt, ohne die Richtung zu ändern. Beispielsweise wird 725.5 Grad zu 5.5 Grad.

Werden Radiant in Grad umgerechnet?

Nein. Die Eingabe wird als Grad verstanden; rechnen Sie Radiant vor der Nutzung dieser Fähigkeit separat um.

Korrigiert die Normalisierung die magnetische Deklination?

Nein. Sie begrenzt nur den Zahlenwinkel; Korrekturen für magnetisch, geografisch oder Gitternord erfolgen separat.

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.

POSThttps://api.kit.forhosting.com/geo/normalize-bearing

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

curl -X POST https://api.kit.forhosting.com/geo/normalize-bearing \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bearing":725.5}'
{
  "bearing": 725.5
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.normalize_bearing",
  "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.

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

HTTPCodeBedeutung
401unauthorizedDer API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
402insufficient_balanceIhr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
404unknown_typeUnbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
429rate_limitedZu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →