ForHosting KIT · 開発者向けツール

潮汐プリズム体積計算機

潮汐プリズム体積計算機は、代表的な低潮位と高潮位の間に河口域へ流入または河口域から流出する水量を推定します。水域の表面積を平方メートル、潮差をメートルで入力すると、標準的な一次関係 P = A × R を適用します。結果は、入力値と使用した式を添えて立方メートルで返されます。そのため、環境スクリーニング、沿岸工学、河口域の予備調査において、計算内容を確認し、文書化し、再利用していただけます。

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

無料で実行 API仕様を見る

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

潮汐プリズムが表すもの

潮汐プリズムとは、1回の潮汐周期に低潮位から高潮位までの間で、潮汐水域または河口域が交換する水の体積です。交換量が大きいほど、入口部を通じてより多くの塩分、堆積物、栄養塩、汚染物質、懸濁物を運び得るため、潮汐による水交換の規模を把握する最初の指標として役立ちます。本計算機は、水域の表面積と鉛直方向の潮差から、この体積を推定します。表面積は水位変化に関わる水面の水平範囲を示し、潮差は選択した低潮位と高潮位の差を示します。平方メートルにメートルを掛けるため、結果の単位は立方メートルです。この推定は、単純で検証しやすいことを重視しており、指定した潮差の全範囲で平面状の水域が一様に上昇または下降すると仮定します。そのため、詳細な流体力学モデルを用いる前の簡易比較、実現可能性調査、教育目的の計算、初期段階の事業評価に適しています。ただし、河口の入口部を通る流れを完全に再現するものではなく、幾何学的な概算として解釈してください。

整合した入力値の選び方

河口域または潮汐水域の表面積を平方メートル、潮差をメートルで入力してください。2つの測定値は、同じ調査区間と、互いに整合する潮汐条件を対象にする必要があります。たとえば、その状況を意図的に検討する場合を除き、低潮時だけに地図化した面積と、無関係な高潮災害時の極端な潮差を組み合わせないでください。大潮、小潮、平均、または設計条件の代表的な潮差を使用できますが、後から結果を正しく解釈できるよう、どの条件を選んだか記録することをお勧めします。面積が平方キロメートルで示されている場合は、入力前に一百万を掛けて平方メートルに換算してください。潮差がセンチメートルの場合は、百で割ってメートルに換算します。ゼロは有効であり、潮汐プリズムもゼロになります。物理的な水域面積は負にならないため、負の表面積はエラーになります。また、本計算機は水位差の正の大きさを想定しているため、負の潮差も受け付けません。単位は公開された入力仕様で固定されていますので、各欄には単位記号を付けず、有限の数値のみを入力してください。

結果の解釈と適用上の限界

返される潮汐プリズムは P = A × R で、単位は立方メートルです。たとえば、水域面積が2,500,000平方メートル、選択した潮差が1.8メートルの場合、推定交換水量は4,500,000立方メートルになります。同じ前提を適用すれば、水域や潮汐シナリオの比較に有用ですが、特定の入口部を実際に通過する正確な水量と必ずしも一致するわけではありません。現実の河口域には、傾斜した岸、干潟、分岐水路、水を貯留する湿地、河川流入、蒸発、位相差、場所によって異なる水位があります。潮汐の途中で冠水面積が大きく変化する場合もあります。そのため、詳細設計、航行調査、洪水解析、生態影響評価では、水深地形の積分、観測水位、流速測定、または較正済みの流体力学モデルが必要になることがあります。本計算機は再現可能な一次推定としてお使いになり、面積データの出典、潮位基準、採用した潮汐統計、測量日を結果とともに記載してください。API リクエストの料金は$0.002です。決定論的な式のため、同じ入力からは常に同じ結果が得られます。

活用例

河口域再生計画の事前評価

詳細な水理モデルを委託する前に、計画した潮差に対応する交換水量を推定していただけます。

潮汐による水交換シナリオの比較

同じ地図化済み水域面積に複数の代表潮差を適用し、一次推定の交換水量を一貫した条件で比較できます。

沿岸調査の前提条件の文書化

出典となる入力値と式を添えた明確な立方メートル推定値を、報告書や計算記録にご利用いただけます。

よくある質問

どの計算式を使用しますか？

P = A × R を使用します。P は潮汐プリズム体積、A は水域の表面積、R は潮差です。

どの単位で入力すればよいですか？

表面積は平方メートル、潮差はメートルで入力してください。潮汐プリズムは立方メートルで返されます。

傾斜した岸や冠水面積の変化も考慮しますか？

いいえ。指定した平面面積の水位が一様に変化すると仮定します。複雑な地形には、より詳細な手法が必要です。

表面積が負の場合にエラーになるのはなぜですか？

物理的な表面積は負になりません。誤解を招く負の水量を返さないよう、本計算機ではエラーとして扱います。

API による1回の計算料金はいくらですか？

API リクエスト1回につき$0.002です。計算は決定論的で、外部モデルやネットワークサービスを使用しません。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/earth/tidal-prism

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

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

curl -X POST https://api.kit.forhosting.com/earth/tidal-prism \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"surface_area":2500000,"tidal_range":1.8}'

const res = await fetch("https://api.kit.forhosting.com/earth/tidal-prism", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "surface_area": 2500000,
    "tidal_range": 1.8
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/earth/tidal-prism",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "surface_area": 2500000,
    "tidal_range": 1.8
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/earth/tidal-prism", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"surface_area":2500000,"tidal_range":1.8}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"surface_area":2500000,"tidal_range":1.8}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/earth/tidal-prism", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "surface_area": 2500000,
  "tidal_range": 1.8
}

レスポンス例

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