ForHosting KIT · Entwickler-Tools

Resultierender Kurs mit Strömung

Bei bewegtem Wasser fährt ein Schiff über Grund nur selten genau in Richtung seines Steuerkurses.

● BetaKostenlos · im Browser

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Dieser Rechner addiert die Fahrt durchs Wasser zum Strömungsvektor und gibt den tatsächlichen Kurs sowie die Geschwindigkeit über Grund aus. Geben Sie Steuerkurs, Eigengeschwindigkeit, Fließrichtung und Strömungsgeschwindigkeit ein. Das Werkzeug zerlegt beide Bewegungen in Ost- und Nordkomponenten, addiert sie und wandelt den Gesamtvektor wieder in eine nautische Peilung und Geschwindigkeit um. Es eignet sich für Navigationsaufgaben, Törnabschätzungen, Ausbildung, Simulationen und reproduzierbare API-Berechnungen.

Verwenden Sie einheitliche Richtungen und Geschwindigkeiten

Lesen Sie jede Richtung als Kompasspeilung im Uhrzeigersinn ab geografisch Nord: null Grad ist Nord, neunzig Ost, einhundertachtzig Süd und zweihundertsiebzig West. Der Steuerkurs bezeichnet die Richtung des Bugs und der Fahrt durchs Wasser. Die Strömungsrichtung muss angeben, wohin das Wasser fließt, nicht woher es kommt. Diese Unterscheidung ist wichtig, weil nautische Quellen unterschiedliche Konventionen nutzen können. Rechnen Sie die Angabe vor der Eingabe gegebenenfalls um. Verwenden Sie für beide Geschwindigkeiten dieselbe Einheit, etwa Knoten, Kilometer pro Stunde oder Meter pro Sekunde. Die Vektoraddition erhält diese Einheit; gemischte Einheiten liefern dagegen kein sinnvolles Ergebnis. Winkel außerhalb des üblichen Bereichs werden normalisiert. Geschwindigkeiten müssen endlich und nicht negativ sein. Wahre Richtungen ergeben einen wahren Kurs; magnetische Angaben erfordern durchgehend denselben magnetischen Bezug oder eine Missweisungskorrektur.

Verstehen Sie die Vektoraddition hinter dem Ergebnis

Die Rechnung verwendet eine Ost-Nord-Ebene. Für die Geschwindigkeit v mit Peilung theta ist die Ostkomponente v mal Sinus theta und die Nordkomponente v mal Kosinus theta. Diese Anordnung unterscheidet sich von der üblichen Schulformel, da nautische Peilungen bei Nord beginnen und im Uhrzeigersinn wachsen. Die Komponenten von Schiff und Strömung werden getrennt addiert. Die mit dem Satz des Pythagoras bestimmte Länge des Gesamtvektors ist die Geschwindigkeit über Grund. Seine Richtung wird durch eine Arkustangensfunktion mit zwei Argumenten ermittelt und auf null bis ausschließlich dreihundertsechzig Grad normiert. Die Antwort enthält alle drei Vektoren, damit Sie Vorzeichen und Rechenweg prüfen können. Werte werden für stabile Automatisierung auf zehn Dezimalstellen gerundet. Heben sich gleich große Gegenvektoren auf, gibt es keinen physikalisch definierten Kurs und die Anfrage wird abgewiesen.

Beachten Sie die Grenzen des Modells

Der ausgegebene Kurs ist eine Momentaufnahme für zwei konstante Vektoren in einer Ebene. Er eignet sich für Kartenaufgaben, kurze Zeiträume, Simulatoren und erste Törnplanungen. Änderungen des Gezeitenstroms, Windabdrift, Steuerfehler, Missweisung, Wellen, Beschleunigung, Kartengeometrie und Hindernisse bleiben unberücksichtigt. Teilen Sie eine echte Reise in geeignete Abschnitte, beschaffen Sie Stromvorhersagen für Ort und Zeit und rechnen Sie bei veränderten Bedingungen erneut. Das Werkzeug löst die Vorwärtsaufgabe: Aus einem Kurs durchs Wasser wird die Bewegung über Grund bestimmt. Den Steuerkurs für einen gewünschten Grundkurs zu finden, ist eine andere, inverse Aufgabe. Speichern Sie Einheit und Richtungskonvention stets zusammen mit dem Ergebnis. Browser und API verwenden denselben deterministischen Kern. Jede erfolgreiche automatisierte Berechnung kostet $0.002; damit eignet sich die Ausgabe für Unterricht, Protokolle und Tests leichter Navigationssoftware.

Anwendungsfälle

Navigationsaufgaben kontrollieren

Prüfen Sie ein gezeichnetes Geschwindigkeitsdreieck und vergleichen Sie den berechneten Grundkurs mit der grafischen Lösung.

Einen kurzen Törn abschätzen

Kombinieren Sie geplanten Steuerkurs und Fahrt mit einem repräsentativen Strom für eine erste Schätzung.

Simulationsdaten erzeugen

Erstellen Sie deterministische Grundvektoren für Seefahrtsausbildung, Unit-Tests oder Lehrgrafiken.

Häufige Fragen

Was bedeutet die Strömungsrichtung?

Sie ist die Peilung, wohin das Wasser fließt. Kehren Sie eine Quellenangabe um, wenn diese die Herkunft nennt.

Welche Geschwindigkeitseinheiten sind möglich?

Jede Einheit funktioniert, sofern beide Geschwindigkeiten dieselbe verwenden. Das Ergebnis behält sie bei.

Sind die Richtungen wahr oder magnetisch?

Beides ist möglich, aber alle Angaben brauchen denselben Bezug. Wahre Eingaben ergeben einen wahren Kurs.

Warum kann kein resultierender Kurs vorliegen?

Gleiche Gegenvektoren erzeugen Geschwindigkeit null. Ein Nullvektor besitzt keine Richtung und wird abgewiesen.

Was kostet eine API-Berechnung?

Jedes erfolgreich berechnete Element kostet $0.002. Der Browser nutzt dieselbe deterministische Rechnung.

Für Entwickler — API-Zugang

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

Endpunkt

POSThttps://api.kit.forhosting.com/trig/resultant-course-current

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

Aufruf aus Ihrem Stack

curl -X POST https://api.kit.forhosting.com/trig/resultant-course-current \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"heading_degrees":90,"vessel_speed":10,"current_direction_degrees":180,"current_speed":3}'

const res = await fetch("https://api.kit.forhosting.com/trig/resultant-course-current", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "heading_degrees": 90,
    "vessel_speed": 10,
    "current_direction_degrees": 180,
    "current_speed": 3
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/trig/resultant-course-current",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "heading_degrees": 90,
    "vessel_speed": 10,
    "current_direction_degrees": 180,
    "current_speed": 3
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/trig/resultant-course-current", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"heading_degrees":90,"vessel_speed":10,"current_direction_degrees":180,"current_speed":3}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"heading_degrees":90,"vessel_speed":10,"current_direction_degrees":180,"current_speed":3}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/trig/resultant-course-current", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "heading_degrees": 90,
  "vessel_speed": 10,
  "current_direction_degrees": 180,
  "current_speed": 3
}

Beispiel-Antwort

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

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Preis

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

Fehler

HTTP	Code	Bedeutung
`401`	`unauthorized`	Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
`402`	`insufficient_balance`	Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
`404`	`unknown_type`	Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
`429`	`rate_limited`	Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →