ForHosting KIT · Strumenti per sviluppatori

Normalizzare una rotta tra 0 e 360 gradi

Converta una rotta negativa, un angolo superiore a una rivoluzione o un azimut già convenzionale in un valore coerente compreso tra zero e meno di 360 gradi.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Il calcolatore aggiunge o sottrae giri completi di 360 gradi senza cambiare la direzione rappresentata. È utile quando dati di navigazione, rilievo, cartografia, robotica o fogli di calcolo adottano convenzioni angolari miste. Inserisca un valore finito in gradi per ricevere sia il numero originale sia l’equivalente normalizzato con un calcolo deterministico privo di consultazioni esterne.

Comprendere l’intervallo normalizzato

Una rotta descrive una direzione lungo un cerchio completo, quindi gli angoli separati da un multiplo intero di 360 gradi indicano esattamente la stessa direzione. Per esempio, 10 gradi, 370 gradi e -350 gradi sono equivalenti. La normalizzazione sceglie un solo rappresentante standard da questa famiglia illimitata. Il calcolatore usa l’intervallo semiaperto da 0 gradi incluso a 360 gradi escluso. Il nord viene pertanto restituito come 0 gradi, mai come 360, mentre est, sud e ovest corrispondono a 90, 180 e 270 gradi. La convenzione elimina la doppia rappresentazione sul confine. La procedura non ruota, arrotonda o reinterpreta una direzione: aggiunge o sottrae soltanto giri completi finché il numero rientra nell’intervallo. Le cifre decimali restano invariate, quindi 721.25 gradi diventa 1.25 gradi.

Inserire l’angolo e verificare il risultato

Fornisca una sola rotta numerica finita misurata in gradi. Il valore può essere già compreso tra 0 e 360, essere negativo oppure includere più rivoluzioni positive o negative. I valori nell’intervallo restano invariati, salvo lo zero negativo che viene espresso come zero ordinario. Da 725.5 gradi vengono rimossi due giri e si ottengono 5.5 gradi; aggiungendo un giro a -10 gradi si ottengono 350 gradi. Il calcolo usa direttamente il resto equivalente, perciò il tempo non aumenta con il numero di giri. Verifichi che la fonte utilizzi davvero i gradi e la convenzione di rotta prevista. Un valore in radianti non viene convertito e lo strumento non riconosce una misura antioraria. Valori mancanti, non numerici, infiniti o NaN vengono rifiutati per evitare direzioni fuorvianti.

Usare in sicurezza le rotte normalizzate

Un risultato normalizzato agevola confronti, archiviazione, ordinamento, visualizzazione e formule successive, ma modifica solo l’avvolgimento numerico. Non converte il nord magnetico in nord vero, non applica declinazione o convergenza di griglia e non calcola una rotta. Conservi separatamente tali informazioni. Anche i confronti circolari richiedono attenzione vicino al confine: 359 gradi e 1 grado distano appena 2 gradi, sebbene una sottrazione ordinaria dia 358. Normalizzi entrambi i valori e poi applichi una formula di differenza circolare. Nei flussi automatizzati conservi l’originale insieme al valore normalizzato se serve tracciabilità. Ogni richiesta API elabora un elemento e costa $0.002. Il calcolo non usa rete, data, casualità o tabelle variabili, quindi input finiti identici producono sempre output identici. Applichi eventuali arrotondamenti solo dopo la normalizzazione, secondo la precisione dello strumento o dei dati.

Casi d'uso

Ripulire dati di navigazione

Uniformi rotte negative o multigiro prima di archiviare o confrontare registri di veicoli, navi o aeromobili.

Regolare l’orientamento dei robot

Converta rotazioni accumulate in un orientamento canonico adatto a pannelli e sistemi di controllo.

Preparare campi cartografici

Normalizzi colonne di azimut importate prima di usarle in GIS, convalide o calcoli direzionali.

Domande frequenti

Quale intervallo usa il risultato?

Il risultato è maggiore o uguale a 0 gradi e strettamente minore di 360 gradi. Un giro completo è rappresentato da 0 gradi.

Come vengono gestite le rotte negative?

Quando necessario vengono aggiunti giri completi di 360 gradi. Per esempio, -10 gradi diventa 350 gradi.

Che cosa accade ai valori superiori a 360 gradi?

I giri completi vengono rimossi senza cambiare la direzione. Per esempio, 725.5 gradi diventa 5.5 gradi.

Lo strumento converte i radianti in gradi?

No. L’input è interpretato in gradi; converta separatamente i radianti prima di usare questa capacità.

La normalizzazione corregge la declinazione magnetica?

No. Riporta soltanto l’angolo nell’intervallo; le correzioni del nord magnetico, vero o di griglia vanno eseguite a parte.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

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

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo stack

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}'

const res = await fetch("https://api.kit.forhosting.com/geo/normalize-bearing", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "bearing": 725.5
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/normalize-bearing",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "bearing": 725.5
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/normalize-bearing", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"bearing":725.5}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"bearing":725.5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/normalize-bearing", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Esempio di richiesta

{
  "bearing": 725.5
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.normalize_bearing",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →