ForHosting KIT · Strumenti per sviluppatori

Rilevamento relativo dalla prora

Questo calcolatore converte il rilevamento vero di un bersaglio nell’angolo osservato dalla prora della nave.

● BetaGratis · nel tuo browser

Usalo da WebAPIEmailTelegramApp presto

Inserisca il rilevamento vero verso il bersaglio e la prora vera dell’unità, entrambi in gradi misurati in senso orario dal nord. Il risultato viene normalizzato sull’intero cerchio di 0–360 gradi e indica se il bersaglio si trova a proravia, a poppavia, a sinistra o a dritta. È utile per esercizi di navigazione, rapporti di vedetta, interpretazione radar e verifica delle osservazioni relative alla prora.

Che cosa indica il rilevamento relativo

Il rilevamento vero e quello relativo descrivono la stessa linea di vista usando riferimenti diversi. Il primo si misura in senso orario dal nord vero, mentre il secondo parte dalla prora della nave. Il calcolatore cambia riferimento sottraendo la prora della nave dal rilevamento vero del bersaglio. Un risultato di 0 gradi colloca il bersaglio esattamente a proravia, 90 gradi al traverso di dritta, 180 gradi esattamente a poppavia e 270 gradi al traverso di sinistra. I valori intermedi definiscono con precisione la direzione attorno all’unità. La distinzione conta perché una vedetta comunica spesso rispetto alla prora, mentre carte e sensori possono riferirsi al nord. Il campo target_side agevola il controllo: tra 0 e 180 il bersaglio è a dritta; tra 180 e 360 è a sinistra, con etichette specifiche per prora e poppa esatte.

Come il calcolo gestisce il passaggio a nord

La formula fondamentale è rilevamento relativo = rilevamento vero − prora della nave. La sottrazione diretta può risultare negativa quando il rilevamento del bersaglio è numericamente inferiore alla prora. La direzione non è errata: il risultato ha semplicemente attraversato lo zero del nord. Il calcolatore aggiunge 360 gradi e applica il modulo 360, ottenendo il normale intervallo da 0 incluso a 360 escluso. Per esempio, una prora di 350 gradi e un rilevamento di 45 gradi danno 55 gradi relativi, quindi il bersaglio è a dritta verso prora. Per il nord Lei può inserire 0 o 360 gradi; entrambi diventano 0. Sono ammessi gradi decimali e l’uscita viene arrotondata a sei decimali per garantire stabilità. Entrambi i dati devono essere numeri finiti nell’intervallo pubblicato di 0–360 gradi.

Come usare correttamente il risultato

Verifichi che entrambi gli angoli utilizzino il nord vero. Abbinare una prora magnetica a un rilevamento vero mescola riferimenti diversi e può produrre un numero plausibile ma scorretto. Converta prima i valori magnetici quando occorre applicare variazione o deviazione. Ricordi inoltre che la prora indica dove punta la nave e può differire dalla rotta sul fondo in presenza di vento, corrente o scarroccio. L’uscita segue la convenzione oraria 0–360, non un angolo con segno: 315 gradi significano 45 gradi a sinistra. target_side elimina l’ambiguità e distingue le posizioni esattamente a proravia e a poppavia. Il calcolo è immediato e deterministico, adatto a esercizi, verifiche del software di plancia, registri e automazione API per $0.002 a richiesta. Non determina distanza, rischio di collisione o punto di massimo avvicinamento.

Casi d'uso

Convertire un rilevamento tracciato

Trasformi un rilevamento vero ricavato da una carta o da un sensore nell’angolo orario che una vedetta comunicherebbe dalla prora.

Verificare esercizi di navigazione

Controlli l’aritmetica del rilevamento relativo anche quando la sottrazione attraversa il nord e produrrebbe un valore negativo.

Uniformare le osservazioni di plancia

Converta registrazioni di prora e rilevamento vero in valori relativi coerenti di 0–360 gradi per giornali o analisi.

Domande frequenti

Quale formula viene utilizzata?

Il calcolatore sottrae la prora della nave dal rilevamento vero e normalizza la differenza tra 0 incluso e 360 gradi escluso.

Che cosa significa un rilevamento relativo di 270 gradi?

Il bersaglio si trova direttamente al traverso di sinistra, cioè 90 gradi a sinistra rispetto alla prora.

Posso combinare rilevamenti magnetici e veri?

No. Entrambi gli angoli devono usare lo stesso riferimento nord; questa capacità richiede espressamente rilevamento e prora veri.

Vengono calcolati distanza o rischio di collisione?

No. Il calcolo indica solo la direzione rispetto alla prora e non usa distanza, velocità, variazioni di rotta o dati di massimo avvicinamento.

Quanto costa una richiesta API?

Ogni richiesta API costa $0.002. Il calcolo può anche essere eseguito localmente nel browser come capacità di livello A.

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/relative-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/relative-bearing \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"true_bearing":45,"vessel_heading":350}'

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

import os, requests

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

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

body := bytes.NewBufferString(`{"true_bearing":45,"vessel_heading":350}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/relative-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

{
  "true_bearing": 45,
  "vessel_heading": 350
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.relative_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 →