Peilung zu Kompassrichtung

So mappen Grad auf die 16-Punkt-Kompassrose

Senden Sie ein Pflichtfeld namens bearing als JSON-Zahl oder numerische Zeichenkette. Aliase degrees, deg, azimuth, heading und angle werden akzeptiert, wenn Ihr Upstream-schema diese Namen nutzt. Bei Erfolg erhalten Sie direction als Kurzetikett, full_name als vollständigen Ausdruck, bearing_in als den akzeptierten endlichen Wert, bearing_deg als den normalisierten Winkel von null inklusive bis dreihundertsechzig exklusive, index von null bis fünfzehn, points gleich sechzehn, sector_center_deg, sector_from_deg, sector_to_deg und method auf sixteen_point_compass_rose. Identische endliche Eingaben erzeugen stets dasselbe JSON, weil der Pfad reine Arithmetik ohne Netz, ohne Zufallsseed und ohne Wanduhr ist.

Validierung, Fehler und Lesen der Antwortfelder

Die einzige harte Ablehnung ist eine Peilung, die keine endliche Zahl ist. Endliche Gleitkommawerte einschließlich großer Beträge und wissenschaftlicher Notation, die zu einer endlichen Number parsen, werden akzeptiert und dann normalisiert. Nutzen Sie direction, wenn ein Kartenpin, eine Statuszeile oder eine CSV-Spalte ein kompaktes Etikett wie NNE braucht. Es löst auch keine Großkreis-Geodäsie und keine Querabstandsentfernung auf einer Kugel. Fehlende Eingabe, leere Zeichenketten, Booleans, Objekte, nichtnumerischer Text, NaN und positives oder negatives Infinity scheitern mit invalid_input und werden nach Ablehnung durch die Engine nicht berechnet. Nutzen Sie full_name, wenn ein Bericht oder Screenreader den ausgeschriebenen Namen braucht. Nutzen Sie bearing_deg, wenn Sie den umwickelten Winkel neben dem Etikett zeigen müssen, und bearing_in, wenn Audit-Logs die Rohablesung vor dem Modul erhalten sollen. Das Feld index eignet sich für Paletten-Lookup, Icon-Blätter oder Unit-Tests, die Sektorzugehörigkeit ohne Zeichenkettenvergleich prüfen. Sektorgrenzen beschreiben das Winkel-Fenster des gewählten Zentrums unter der Halbbreite von elf Punkt zwei fünf Grad, wobei Nord den Nullmeridian umwickelt, sodass sector_from_deg dreihundertachtundvierzig Punkt sieben fünf und sector_to_deg elf Punkt zwei fünf ist. Dieses Produkt berechnet keinen Kurs aus zwei Koordinaten; für diese Absicht nutzen Sie einen Peilungsrechner zwischen Punkten.

API-Nutzung, Preise, Arbeitsabläufe und praktische Grenzen

Rufen Sie das kostenlose Browser-Werkzeug Peilung zu Kompassrichtung für Unterrichtsdemos, Feldnotizen und schnelle mentale Prüfungen ohne GIS-Software auf. Autoren, die SDKs ausliefern, können direction direkt in UI-Badges mappen und index für Sprite-Frames einer Kompassrosen-Grafik nutzen. Dokumentieren Sie im Client bevorzugt die Konvention null-gleich-Nord im Uhrzeigersinn, damit Nutzer, die in mathematischen Winkeln von Ost gegen den Uhrzeigersinn denken, einmal vor dem Aufruf umrechnen. Nutzen Sie die Prepaid-API, wenn ein mobiles Navigations-Backend, ein Drohnen-Telemetrie-Normalisierer, ein Segel-Log-Importer oder ein Logistik-Dashboard einen stabilen Vertrag unter KIT-Guthaben zu $0.002 pro erfolgreichem Element braucht. Koppeln Sie den Endpoint mit einem Koordinaten-Peilungsrechner, wenn Sie zuerst einen Kurs aus zwei Punkten erhalten und ihn dann für Menschen etikettieren; halten Sie die beiden Schritte getrennt, damit jede Seite einer eigenen Suchabsicht entspricht. Es gibt kein Größenlimit pro Anfrage jenseits gewöhnlichen JSON, und die Arbeit sind eine Handvoll Gleitkommaoperationen in einem Worker, sodass die Latenz analytisch und vorhersehbar bleibt.