Peilung zu 32-Strich-Rose

Nicht endliche Werte einschließlich NaN sowie plus und minus Unendlich werden mit einem klaren invalid_input-Fehler abgewiesen, damit fehlerhafte Sensordumps nicht als Norden erscheinen.

Wie Grad auf die 32-Strich-Kompassrose abgebildet werden

Null Grad bedeutet Norden; neunzig Osten; einhundertachtzig Süden; zweihundertsiebzig Westen. Werte außerhalb von null bis dreihundertsechzig werden modulo dreihundertsechzig reduziert, und negative Kurse wickeln sich ebenso, sodass ein Sensor, der minus fünf Punkt sechs zwei fünf meldet, weiterhin auf North by West landet. Die zweiunddreißig Rosenpunkte sitzen auf Zentren alle elf Punkt zwei fünf Grad: N bei null, NbE bei elf Punkt zwei fünf, NNE bei zweiundzwanzig Punkt fünf, NEbN bei dreiunddreißig Punkt sieben fünf, NE bei fünfundvierzig, und so weiter bis NbW bei dreihundertachtundvierzig Punkt sieben fünf. Jeder Sektor ist elf Punkt zwei fünf Grad breit; die Implementierung wählt das nächste Zentrum mit Standard-Half-up-Rundung und wickelt dreihundertsechzig zurück nach Norden. Senden Sie ein Pflichtfeld namens bearing als JSON-Zahl oder numerische Zeichenkette. Die Aliase degrees, deg, azimuth, heading und angle werden akzeptiert, wenn Ihr Upstream-Schema diese Namen verwendet. Bei Erfolg erhalten Sie direction als kurzes klassisches Kürzel, full_name als englische Phrase beim Rezitieren der Box, bearing_in als den akzeptierten endlichen Wert, bearing_deg als den normalisierten Winkel von null inklusive bis dreihundertsechzig exklusive, index von null bis einunddreißig, points gleich zweiunddreißig, sector_center_deg, sector_from_deg, sector_to_deg und method auf thirty_two_point_compass_rose. Identische endliche Eingaben erzeugen stets dasselbe JSON, weil der Pfad reine Arithmetik ist, ohne Netz, ohne Zufallsseed und ohne Wanduhr. Diese feinere Rose ist das vollständige Boxing der klassischen Navigationsausbildung, nicht die gröbere Sechzehn-Label-Menge vieler Verbraucherkarten.

Validierung, Fehler und Lesen der Antwortfelder

Die einzige harte Ablehnung ist ein bearing, der keine endliche Zahl ist. Endliche Gleitkommawerte einschließlich großer Magnituden und wissenschaftlicher Notation, die zu einem endlichen Number parsen, werden akzeptiert und anschließend normalisiert. Verwenden Sie direction, wenn eine Kartenlegende, Statuszeile, CSV-Spalte oder Drill-Anweisung ein kompaktes traditionelles Kürzel wie NEbE oder WSW braucht. Es vergröbert auch nicht auf ein reines Sechzehn-Punkt-Landing, berechnet keine Peilung aus zwei Koordinaten und löst keine Großkreis-Geodäsie auf einer Kugel. Fehlende Eingabe, leere Zeichenketten, Booleans, Objekte, nichtnumerischer Text, NaN sowie positives oder negatives Infinity scheitern mit invalid_input und werden nach Ablehnung durch die Engine nicht berechnet. Verwenden Sie full_name, wenn ein Ausbildungshandbuch, ein Barrierefreiheitslabel oder eine Sprachausgabe Northeast by East in klassischem Englisch aussprechen soll. Verwenden Sie bearing_deg, um den gewickelten Winkel neben dem Label zu zeigen, und bearing_in, wenn Audit-Logs die Rohablesung vor dem Modulo bewahren sollen. Das Feld index eignet sich für Paletten, um die Rose geordnete Icon-Sheets oder Unit-Tests, die die Sektorzugehörigkeit ohne String-Vergleich prüfen. Sektorgrenzen beschreiben das Winkelfenster des gewählten Zentrums mit der Halbbreite fünf Punkt sechs zwei fünf Grad; Norden umschließt den Nullmeridian, sodass sector_from_deg dreihundertvierundfünfzig Punkt drei sieben fünf und sector_to_deg fünf Punkt sechs zwei fünf ist. Dieses Produkt wandelt keinen Kompassnamen in Grad um; diese umgekehrte Suchintention ist ein separater Endpoint.

API-Nutzung, Preise, Workflows und praktische Grenzen

Nutzen Sie die Prepaid-API, wenn ein Segeltagebuch-Importer, ein Annotator historischer Karten, ein Drohnen-Telemetrie-Normalisierer oder ein Logistik-Dashboard einen stabilen Vertrag unter KIT-Saldo zu $0.002 pro erfolgreichem Item braucht. Koppeln Sie den Endpoint mit einem Koordinaten-Peilungsrechner, wenn Sie zuerst einen Heading aus zwei Punkten gewinnen und ihn dann mit der vollen klassischen Rose für Menschen beschriften; halten Sie die Schritte getrennt, damit jedes Landing eine eigene Suchintention trifft. Es gibt kein Größenlimit pro Anfrage jenseits gewöhnlichen JSONs, und die Arbeit sind wenige Gleitkommaoperationen in einem Worker-Isolate, sodass die Latenz analytisch und vorhersehbar bleibt.