ForHosting KIT · Strumenti per sviluppatori

Velocità sul fondo con corrente

Questo calcolatore della velocità sul fondo combina il vettore della barca rispetto all'acqua con la direzione e la deriva della corrente.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Inserisca velocità e direzione dell'imbarcazione, quindi velocità della corrente e direzione verso cui scorre. Lo strumento scompone entrambi i vettori nelle componenti est e nord, le somma e restituisce velocità sul fondo, rotta sul fondo e valori intermedi utili. Supporta nodi, chilometri orari, miglia orarie e metri al secondo per pianificazione, formazione e verifiche di navigazione trasparenti.

Inserisca correttamente moto nell'acqua e corrente

Parta dalla velocità della barca rispetto all'acqua, non da una lettura GPS che comprende già la corrente. La associ alla direzione in cui l'imbarcazione si muove nell'acqua. Entrambi i campi direzionali usano rilevamenti veri misurati in senso orario dal nord: nord è 0 gradi, est 90, sud 180 e ovest 270. La deriva è la velocità della corrente, mentre la direzione indica dove scorre l'acqua. Usi la stessa unità per velocità della barca e deriva; l'unità selezionata vale anche per il risultato principale. Il valore 360 gradi equivale al nord. Se la fonte riporta direzioni magnetiche, applichi prima la declinazione appropriata. Quando lo scarroccio dovuto al vento è rilevante, corregga prima la prora per ricavare il moto reale rispetto all'acqua, poiché il calcolo può rappresentare soltanto la direzione inserita.

Come si calcolano velocità e rotta sul fondo

Il calcolatore rappresenta ogni movimento come vettore bidimensionale. Per un rilevamento vero, la componente est è la velocità moltiplicata per il seno del rilevamento e quella nord è la velocità moltiplicata per il coseno. Le componenti vengono calcolate per barca e corrente, quindi si sommano est con est e nord con nord. Il modulo del vettore combinato è la velocità sul fondo. La rotta sul fondo deriva da una funzione arcotangente a due argomenti ed è normalizzata tra 0 e meno di 360 gradi. La risposta comprende le componenti risultanti, la velocità nell'unità selezionata e in nodi, e la differenza rispetto alla velocità della barca. Tale differenza è un effetto risultante, non la semplice deriva. I risultati sono arrotondati a sei decimali per garantire esecuzioni stabili nel browser e tramite API.

Usi il risultato come supporto alla pianificazione

Usi la velocità sul fondo per stimare l'avanzamento lungo la traiettoria risultante e la rotta sul fondo per individuare la direzione del moto combinato. Una corrente favorevole tende ad aumentare la velocità, una contraria la riduce e una trasversale sposta la rotta. Questo modello presume costanti la velocità della barca e la corrente nell'intervallo esaminato. Le correnti reali cambiano con posizione, profondità, marea, portata e tempo; onde, vento e manovre modificano inoltre il vettore dell'imbarcazione. Il risultato è quindi adatto al confronto tra rotte, alla didattica e alle stime di breve durata, ma non sostituisce tavole di corrente, avvisi locali, osservazioni GPS o un navigatore qualificato. Suddivida la traversata in tratte quando cambiano le condizioni e ricalcoli durante la navigazione. Se i due vettori si annullano esattamente, non esiste una rotta sul fondo significativa e il relativo campo viene omesso.

Casi d'uso

Stimare una rotta con corrente di marea

Combini il moto previsto della barca con direzione e deriva per stimare rotta e velocità sul fondo lungo una tratta.

Confrontare diverse alternative di rotta

Provi direzioni o condizioni di partenza per osservare come una corrente favorevole, contraria o trasversale cambia l'avanzamento.

Insegnare la somma dei vettori nautici

Mostri le componenti est e nord alla base di SOG e COG, anziché presentare soltanto un risultato privo di spiegazione.

Domande frequenti

Quanto costa il calcolatore?

Può usarlo gratuitamente nel browser. Ogni richiesta API costa $0.002.

Che cosa indicano direzione e deriva della corrente?

La direzione indica dove scorre la corrente in riferimento al nord vero. La deriva corrisponde alla sua velocità.

Devo inserire la prora o la rotta rispetto all'acqua?

Inserisca la direzione del vettore di velocità rispetto all'acqua. Se differisce dalla prora per lo scarroccio, lo consideri prima.

Le direzioni sono vere o magnetiche?

Sono rilevamenti veri misurati in senso orario dal nord. Converta i valori magnetici prima di eseguire il calcolo.

Perché una corrente trasversale può cambiare la velocità?

La velocità perpendicolare aumenta il modulo del vettore e ne cambia la direzione, quindi non genera solo uno spostamento laterale.

Che cosa accade se barca e corrente si annullano?

La velocità sul fondo è zero e non esiste una direzione definita; il campo della rotta sul fondo viene quindi omesso.

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/travel/speed-over-ground

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/travel/speed-over-ground \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"boat_speed":6,"boat_course_degrees":90,"current_drift":2,"current_set_degrees":180}'

const res = await fetch("https://api.kit.forhosting.com/travel/speed-over-ground", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "boat_speed": 6,
    "boat_course_degrees": 90,
    "current_drift": 2,
    "current_set_degrees": 180
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/travel/speed-over-ground",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "boat_speed": 6,
    "boat_course_degrees": 90,
    "current_drift": 2,
    "current_set_degrees": 180
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/travel/speed-over-ground", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"boat_speed":6,"boat_course_degrees":90,"current_drift":2,"current_set_degrees":180}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"boat_speed":6,"boat_course_degrees":90,"current_drift":2,"current_set_degrees":180}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/travel/speed-over-ground", 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

{
  "boat_speed": 6,
  "boat_course_degrees": 90,
  "current_drift": 2,
  "current_set_degrees": 180
}

Esempio di risposta

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