ForHosting KIT · 開発者向けツール

年間降水指数計算機

年間降水指数計算機は、12か月分の降水量を合計し、観測年が長期的な年間平均より湿潤だったか乾燥していたかを一つの指標で示します。指数は100を平年値として表し、平均との差の割合、分かりやすい区分、使用した式も返します。気候概況、観測所報告、農業記録、再現可能なデータ処理などで、年間の状況を簡潔に説明したい場合に利用できます。

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

無料で実行 API仕様を見る

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

年間降水指数が示す内容

この計算では、長期間の平均年間降水量を基準にし、対象年の降水量合計をその基準に対する百分率で表します。指数100は、12か月の合計が平年値と完全に一致することを意味します。115なら基準より15パーセント多く、72なら28パーセント少ない状態です。年間合計だけでは得られない地域的な文脈を示せる点が重要です。たとえば900ミリメートルは、ある観測所では非常に多く、別の場所では著しく少ない場合があります。12個の月間値と年間平均には、ミリメートルやインチなど同じ深さの単位を使用してください。比率の計算では単位が相殺されるため、指数自体に単位はありません。結果には年間合計と基準値も残るので、比較内容を明確に確認し、報告書で再検証できます。

入力の準備と結果の読み方

1月から12月までの負でない月間降水量を正確に12個入力し、同じ地点と観測方法に基づく正の長期平均年間降水量を指定してください。安定した気候基準期間の値が望まれます。ミリメートルとインチ、地点観測と地域推定、未完了の月と完全な月間合計を混在させないでください。実際に降雨がなかった月には0を使用できますが、欠測値の代用として0を入れると年間合計が過小になります。95から105は平年並み、80未満はかなり少雨、80以上95未満は少雨、105超120以下は多雨、120超はかなり多雨と区分します。これらは概要を示すための区分であり、公式な干ばつや洪水の判定ではありません。そのような評価には、追加の変数、時間尺度、地域固有の基準が必要です。

報告と自動処理での適切な利用

12個の値を個別に確認しなくても理解できる、簡潔な年間比較が必要な場合にお使いください。観測所報告では、年間合計、基準平均、指数、偏差、区分、式をまとめて保存すると、後から結論を再現できます。自動処理では、送信前にすべての月次記録が同じ年と同じ観測所に属することをご確認ください。計算は決定的であり、同じ入力から常に同じJSONが得られるため、テスト、キャッシュ、ダッシュボード、監査記録に適しています。ただし、この指数は年間量と基準の比較であり、降雨時期は示しません。同じ年間合計でも、均等に降った年と豪雨が集中した年では影響が異なります。季節性、集中度、侵食、干ばつ期間、洪水、農業用水を評価する際は、月次系列や専門指標も併用してください。ブラウザー版は個別確認に使え、APIは1回 $0.002 です。

活用例

観測所の1年を要約

完全な12か月の合計を、その観測所で定めた長期年間平均と比較します。

農業報告に背景を追加

元の合計値を保持しながら、対象年が地域基準より概して多雨か少雨かを示します。

気候ダッシュボードを自動化

検証済みの月次記録から、安定した指数、偏差、区分を生成します。

よくある質問

指数100は何を意味しますか？

観測された年間降水量合計が、指定した長期平均年間降水量と完全に同じであることを示します。

ミリメートルではなくインチも使えますか？

はい。12個の月間値と年間平均がすべて同じ単位なら、任意の降水深単位を使用できます。

別の長期平均が必要なのはなぜですか？

独立した気候基準により有意な比較ができます。同じ12個の値の平均では、湿潤偏差ではなく固定的な比率になります。

月間降水量を0にできますか？

実際に雨がなかった月なら可能です。ただし、欠測した観測値を0で置き換えないでください。

この区分で干ばつや洪水を判定できますか？

いいえ。平年値との記述的な比較です。正式な評価には追加の指標、期間、地域基準が必要です。

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

APIリクエスト1回につき $0.002 です。このページのブラウザー計算は無料で利用できます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/earth/pluviometric-index

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

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

curl -X POST https://api.kit.forhosting.com/earth/pluviometric-index \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"monthly_rainfall":[82,76,91,104,118,132,145,127,109,96,88,92],"mean_annual_rainfall":1200}'

const res = await fetch("https://api.kit.forhosting.com/earth/pluviometric-index", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "monthly_rainfall": [
      82,
      76,
      91,
      104,
      118,
      132,
      145,
      127,
      109,
      96,
      88,
      92
    ],
    "mean_annual_rainfall": 1200
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/earth/pluviometric-index",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "monthly_rainfall": [
        82,
        76,
        91,
        104,
        118,
        132,
        145,
        127,
        109,
        96,
        88,
        92
    ],
    "mean_annual_rainfall": 1200
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/earth/pluviometric-index", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"monthly_rainfall":[82,76,91,104,118,132,145,127,109,96,88,92],"mean_annual_rainfall":1200}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"monthly_rainfall":[82,76,91,104,118,132,145,127,109,96,88,92],"mean_annual_rainfall":1200}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/earth/pluviometric-index", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "monthly_rainfall": [
    82,
    76,
    91,
    104,
    118,
    132,
    145,
    127,
    109,
    96,
    88,
    92
  ],
  "mean_annual_rainfall": 1200
}

レスポンス例

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

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

料金

1リクエストあたり$0.002

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

制限

max_items 12

エラー

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

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