ForHosting KIT · 開発者向けツール

潮汐の十二分の一法による潮位計算

十二分の一法による潮位計算ツールは、予報された満潮と干潮の間で、指定時刻の水位を推定します。満潮・干潮の高さと時刻、計算したい時刻、潮が上げているか引いているかを入力してください。全時間を6等分し、伝統的な1–2–3–3–2–1の配分を適用します。完全な調和曲線や公的なリアルタイム潮位計を利用できない場合の、手早い計画に役立ちます。

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

無料で実行 API仕様を見る

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

十二分の一法で推定できること

十二分の一法は、ほぼ正弦波状に変化する潮汐について、水位の変化を実用的に近似する方法です。ある潮汐の極値から次の極値までの時間を、6つの等しい区間に分けます。各区間では、全潮差の十二分の一、十二分の二、十二分の三、十二分の三、十二分の二、十二分の一だけ水位が変化すると仮定します。合計は十二分の十二になるため、終了時刻には反対側の極値へ到達します。この計算ツールは、指定時刻を区間の境界に丸めず、区間内でも補間します。たとえば、十二分の三が割り当てられた区間の中間点では、その区間分として十二分の一・五を適用します。結果は決定論的で、2つの高さに使用した単位と同じ単位で表示されます。予報値がメートルなら結果もメートル、フィートなら結果もフィートです。単位換算は行わないため、異なる単位を誤って混在させた結果がもっともらしく見えることを防げます。

潮汐時刻と方向を正しく入力する方法

同じ観測地点かつ同じ潮汐周期の満潮・干潮予報値を使用してください。時刻は24時間制のHH:MM形式で入力します。満潮が先で、指定時刻が下げ潮にある場合はhigh_to_lowを選びます。干潮が先で、指定時刻が上げ潮にある場合はlow_to_highを選んでください。2番目の現象の時計表示が1番目より早い場合、計算ツールは翌日に起きるものとして扱います。そのため、深夜前の干潮から早朝の満潮までのような時間帯も、日付なしで計算できます。指定時刻にも同じ日付繰り越し規則が適用され、選択した時間帯の中になければなりません。表示される区間時間は、満潮と干潮の実際の時間差を6で割った値であり、一律に1時間とは仮定しません。公表された潮汐時刻の間隔が正確に6時間であることはまれだからです。同じ高さと時刻でも、潮が上げているか引いているかによって異なる曲線になるため、方向をよく確認してください。

推定値を適切な注意とともに使う方法

結果は計画用の推定値であり、航行可能であることの保証や公式予報の代替ではありません。この方法は、潮汐曲線がおおむね規則的で、満潮と干潮の予報が信頼できる場所に最も適しています。風、気圧、河川流量、港の形状、浅水効果、混合潮、強く非対称な潮汐により、観測水位が単純化した曲線から外れる場合があります。水深が重要な場合は、地域の通報、潮位計、海図基準面、安全余裕と照合してください。2つの公表高が同じ海図基準面を使用していることも確認が必要です。異なる基準の値を差し引いても、有効な潮差にはなりません。出力には、潮差、経過分数、区間時間、進捗率、累積十二分率が含まれ、計算を検証できます。APIによる自動処理は1リクエスト当たり$0.002で、ブラウザーでも同じ純粋な算術を使用します。航行、沿岸への立ち入り、潜水、工事など重要な判断では、所管の水路機関または港湾当局に確認し、現在の状況を考慮してください。

活用例

海岸への立ち入りを計画する

公表された潮汐現象の間に、土手道、海岸、潮位に左右される通路付近の水位を推定します。

航海用の概算を準備する

公的な現地情報を確認する前に、慎重な水深計算へ概算潮位を加えます。

現地観測を確認する

単純な理論潮汐曲線を、中間時刻の潮位計測値や測量記録と比較します。

よくある質問

十二分の一法とは何ですか？

連続する満潮と干潮の変化を、6つの等時間区間における潮差の十二分の1、2、3、3、2、1として近似する方法です。

各区間を1時間と仮定しますか？

いいえ。入力された潮汐現象間の実際の時間を6等分します。

潮汐の時間帯は日付をまたげますか？

はい。終了時刻の時計表示が開始時刻より早い場合は、翌日の時刻として扱います。

どの高さ単位を使用できますか？

一貫した単位であれば使用できます。両方の高さに同じ単位と海図基準面を使用してください。結果もその単位になります。

航行判断に利用できますか？

これは近似にすぎません。航行や安全上重要な判断には、公式予報、現在の観測、地域の案内、適切な安全余裕を使用してください。

API計算の料金はいくらですか？

APIリクエスト1件当たり$0.002です。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/travel/tide-rule-of-twelfths

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

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

curl -X POST https://api.kit.forhosting.com/travel/tide-rule-of-twelfths \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"high_water_height":5.8,"low_water_height":1,"high_water_time":"06:00","low_water_time":"12:00","target_time":"08:30"}'

const res = await fetch("https://api.kit.forhosting.com/travel/tide-rule-of-twelfths", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "high_water_height": 5.8,
    "low_water_height": 1,
    "high_water_time": "06:00",
    "low_water_time": "12:00",
    "target_time": "08:30"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/travel/tide-rule-of-twelfths",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "high_water_height": 5.8,
    "low_water_height": 1,
    "high_water_time": "06:00",
    "low_water_time": "12:00",
    "target_time": "08:30"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/travel/tide-rule-of-twelfths", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"high_water_height":5.8,"low_water_height":1,"high_water_time":"06:00","low_water_time":"12:00","target_time":"08:30"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"high_water_height":5.8,"low_water_height":1,"high_water_time":"06:00","low_water_time":"12:00","target_time":"08:30"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/travel/tide-rule-of-twelfths", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "high_water_height": 5.8,
  "low_water_height": 1,
  "high_water_time": "06:00",
  "low_water_time": "12:00",
  "target_time": "08:30"
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "travel.tide_rule_of_twelfths",
  "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の完全なドキュメントを見る →