ForHosting KIT · 開発者向けツール

潮流を考慮した対地速度・針路計算

この対地速度計算ツールは、船の対水速度ベクトルと潮流の流向・流速ベクトルを合成します。船速と対水進行方向に加え、潮流の速さと流れていく方向をご入力ください。両方のベクトルを東西・南北成分に分解して加算し、対地速度、対地針路、確認に役立つ成分値を返します。単位はノット、キロメートル毎時、マイル毎時、メートル毎秒に対応しており、航海計画、教育、計算過程を確認できる航法チェックにご利用いただけます。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

対水運動と潮流を正しく入力してください

まず、潮流をすでに含むGPS速度ではなく、船の対水速度をご入力ください。次に、水に対して船が実際に進む方向を指定します。方向はすべて真北を0度として時計回りに測る真方位です。北は0度、東は90度、南は180度、西は270度となります。潮流の流速は水の速さを表し、流向は水が向かう方向を表します。風向のように「どこから来るか」を示す値とは異なるため、ご注意ください。船速と流速には同じ単位を使用し、選択した単位が主要な計算結果にも適用されます。360度は北と同じものとして扱います。資料が磁方位の場合は、事前に偏差を適用して真方位へ変換してください。風による横流れが大きい場合は、船首方位ではなく実際の対水進行方向に補正してから入力する必要があります。

対地速度と対地針路の計算方法

本ツールは各運動を二次元の速度ベクトルとして扱います。真方位に対する東向き成分は速度と方位の正弦の積、北向き成分は速度と方位の余弦の積です。船と潮流についてそれぞれの成分を求め、東向き同士、北向き同士を加算します。合成ベクトルの大きさが対地速度です。対地針路は東向き成分と北向き成分を使う2引数の逆正接から求め、0度以上360度未満の方位に正規化します。結果には選択単位での東向き・北向き成分、対地速度、ノット換算値、船速との差も含まれます。この差は潮流の流速そのものではなく、合成後の速度への影響です。横潮流は方向を大きく変えても速度の変化が小さい場合があります。ブラウザーとAPIで安定した結果を得られるよう、数値は小数点以下6桁に丸めます。

航海計画の参考値としてご利用ください

対地速度は合成された航跡上の進み具合を見積もるために、対地針路は実際の移動方向を確認するためにご利用いただけます。追い潮は一般に対地速度を増やし、向かい潮は低下させ、横潮は針路をずらします。ただし、本計算は対象時間中に船の対水速度と潮流が一定であると仮定した単一状態モデルです。実際の潮流は場所、水深、潮汐、河川流量、時刻によって変化し、波、風、操船も船のベクトルを変化させます。そのため、航路比較、学習、短時間の概算には適していますが、潮流図、地域の航行情報、GPS観測、専門家の判断に代わるものではありません。条件が変わる航海では区間ごとに計算し、航行中も観測値で再計算してください。2つのベクトルが完全に打ち消し合う場合、対地速度は0となり有意な方向がないため、対地針路の項目は表示されません。

活用例

潮流を受ける航跡の予測

予想される船の動きに潮流の流向・流速を加え、航路区間の対地針路と対地速度を見積もれます。

航路候補の比較

進行方向や出発条件を変え、追い潮、向かい潮、横潮が進捗に与える影響を比較できます。

航海ベクトル合成の学習

説明のない答えだけでなく、SOGとCOGを構成する東向き・北向き成分を確認できます。

よくある質問

計算ツールの料金はいくらですか？

ブラウザーでは無料で実行できます。APIリクエスト1回の料金は$0.002です。

潮流の流向と流速とは何ですか？

流向は潮流が向かう真方位で、流速はその潮流の速さです。

船首方位と対水進行方向のどちらを入力しますか？

対水速度ベクトルの方向をご入力ください。風の横流れで船首方位と異なる場合は、先に補正してください。

方向は真方位ですか、それとも磁方位ですか？

真北から時計回りに測る真方位です。磁方位は計算前に真方位へ変換してください。

横潮流で対地速度が変わるのはなぜですか？

直交する速度成分は横方向へずらすだけでなく、合成ベクトルの大きさと方向の両方を変えるためです。

船と潮流が完全に打ち消し合う場合はどうなりますか？

対地速度は0となり方向を定義できないため、対地針路の項目は省略されます。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/travel/speed-over-ground

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

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)

リクエスト例

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

レスポンス例

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

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

KITの完全なドキュメントを見る →