ForHosting KIT · 金融・お金

GDP年平均成長率の計算

Q: 実質GDPと名目GDPのどちらを使いますか？

どちらでも構いません。 ただし二つの水準は同じ概念と同じ単位である必要があります。代数はデフレーターを取得せず、通貨も換算しません。実質GDPのCAGRは数量の成長を測り、名目GDPのCAGRは数量と価格を混ぜます。

GDPが2年で100から121になったなら、複利の年平均成長率は10.5 %ではなく10 %です。始点と終点のGDPと年数を入力すると、複利の成長率、期間全体の成長率、倍増までの年数が分かります。ブラウザで無料で使えます。

無料
ブラウザで動作
登録不要
データは端末の外に出ません

無料で実行 API仕様を見る

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

計算例

入力した場合

期首のGDP: 100
期末のGDP: 121
年数: 2

結果

成長率: 1.21
総成長率 (%): 21
年平均成長率 (CAGR): 0.1
年平均成長率 (CAGR) (%): 10

GDPの年平均成長率は、経済をある期間の初めの産出水準から終わりの産出水準へ一定の年率で運ぶ率です。統計機関・教科書・国別ブリーフは、年ごとの増減率の単純平均よりこちらを好みます。不況・反発・単発ショックを一本の比較可能な経路にならすからです。公表された二つの水準の間の開始GDP・終了GDP・年数を渡してください。この計算機はGDPのCAGRを小数とパーセントで返し、期間全体の総成長、複利と混同されやすい素朴な算術平均、そして拡大・縮小・不変のラベルを示します。率が正のときは、その一定経路で産出が倍になる年数も報告します。

GDP年平均成長率が測るものと、振れをならす理由

国内総生産は期間の水準です。経済の内部で生産された最終財・サービスの市場価値であり、たいていは暦年で測り、名目GDPなら当期価格、実質GDPなら不変価格です。単年の対前年比は、去年の産出がどれだけ動いたかを答えます。

複数年の年平均成長率は、国別表や教科書が本当に尋ねる別の問いに答えます。示された年数のあと、開始GDPを終了GDPへ運ぶ一定の年率はいくらか、という問いです。その因子に100を掛けると馴染みのパーセントになります。

冪に入るのは両端だけなので、途中の不況・反発・改定・単発ショックは見出しの率からならされます。十年や国を比べるとき、機関や試験キーが年率の単純平均よりCAGRを選ぶ理由が、そのならしです。年率の素朴な算術平均や、総パーセント変化を years で割った値は、各年を複利が効かないかのように扱い、振れの大きい経路を過大評価しがちです。

計算例として、100から121へ2年なら総上昇は21パーセントですが、CAGRは10パーセントです。1.10の2乗が1.21になるからです。算術平均の余分な半ポイント（21を2で割ると10.5）は、複利率が取り除く振れそのものです。

この計算機は、渡された二つのGDP水準にその端点公式を実装します。国民経済計算の取得も、通貨換算も、基準年のつなぎも、系列が実質か名目かの判定もしません。公表された二つの水準を選ぶのは利用者であり、代数は同じです。

GDP年平均成長率の計算機が役立つ場面

入門マクロ経済学が複数年のGDP成長問題を出すのは、学生が対前年変化と複利経路を区別し、総パーセント変化を years で割った値を年平均成長率として書いてはいけないからです。チュータリング基盤やLMSプラグインには、ゼロや負の開始GDPを無限大にせず拒否し、複利率と素朴な算術平均の両方を返してよくある誤りを採点できる決定論的オラクルが必要です。

公表された二つのGDP水準から国比較表を組む研究補助者は、毎回表計算を組み直さずに再現可能なCAGRと任意の倍増時間を求めます。検索意図が違います。ここでの入力はGDP水準と年数であり、出力はそれらの水準が含意するマクロの年平均成長率です。

よくある質問

GDPの総パーセント変化を年数で割るだけではいけないのですか？

その素朴な算術平均は複利を無視し、振れの大きい経路を過大評価します。CAGRは開始水準を終了水準へ実際に運ぶ唯一の一定年率です。このツールは両方の数値を返すので差が見えます。

実質GDPと名目GDPのどちらを使いますか？

どちらでも構いません。ただし二つの水準は同じ概念と同じ単位である必要があります。代数はデフレーターを取得せず、通貨も換算しません。実質GDPのCAGRは数量の成長を測り、名目GDPのCAGRは数量と価格を混ぜます。

100から121まで2年での複利成長率は？

年10 %です。1.10の2乗が1.21になるためです。全体の上昇は21 %で、2で割ると10.5 %になり、計算機は違いが分かるようにこの単純平均も表示します。

その成長率でGDPが倍になるまで何年かかりますか？

年10 %が続くと、生産は約7.272541年で倍になります。複利の成長率が正のとき、計算機はこの倍増年数を表示します。

端数のある年数や減少したGDPも使えますか？

はい。半年のような端数の期間も使え、終点が始点より低ければ縮小として負の成長率になります。2つのGDPはどちらも0より大きく、同じ単位である必要があります。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/econ/compound-growth-rate-gdp

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

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

curl -X POST https://api.kit.forhosting.com/econ/compound-growth-rate-gdp \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"beginning_gdp":100,"ending_gdp":121,"years":2}'

const res = await fetch("https://api.kit.forhosting.com/econ/compound-growth-rate-gdp", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "beginning_gdp": 100,
    "ending_gdp": 121,
    "years": 2
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/econ/compound-growth-rate-gdp",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "beginning_gdp": 100,
    "ending_gdp": 121,
    "years": 2
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/econ/compound-growth-rate-gdp", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"beginning_gdp":100,"ending_gdp":121,"years":2}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"beginning_gdp":100,"ending_gdp":121,"years":2}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/econ/compound-growth-rate-gdp", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "beginning_gdp": 100,
  "ending_gdp": 121,
  "years": 2
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "econ.compound_growth_rate_gdp",
  "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`	リクエストが多すぎます。しばらく待ってから再度お試しください。

技術的な注記

不正な入力は invalid_input で失敗し、課金されません。

GDP年平均成長率が測るものと、振れをならす理由

恒等式は (ending_gdp を beginning_gdp で割った値) を years 分の1乗し、1を引いたものです。

入力契約・応答の形・検証の振る舞い

欠落・空文字・非有限値、および厳密に正でないGDP水準や年数は検証が拒否します。非正の開始GDPはゼロ除算や実数冪の未定義を招き、非正の期間は年率化できないからです。検証失敗は課金されません。必須の有限数三つを含むJSON本体をPOSTしてください。beginning_gdp は期間の始めの厳密に正のGDP水準、ending_gdp は終わりの厳密に正のGDP水準、years は厳密に正の年数（整数でも小数でも可）です。任意の precision は0から15の整数で既定は6、数値フィールドの小数桁を決めます。beginning_gdp は gdp_begin、start_gdp、initial_gdp、gdp0、gdp_start、begin_gdp といった別名でも送れます。ending_gdp は gdp_end、final_gdp、gdp1、end_gdp、gdp_finish を受け付け、years は n、periods、n_years、year_count を、precision は decimals と dp を受け付けます。各数値フィールドはJSON数値でも数値文字列でも構いません。これらの失敗は invalid_input を返し、フィールド名を示し、前払い残高は消費しません。成功時は整えた beginning_gdp、ending_gdp、years をエコーし、growth_factor（終了を開始で割った値）、total_growth_percent、小数の cagr、cagr_percent、arithmetic_average_percent（素朴な総変化を years で割った値）、expansion・contraction・unchanged のいずれかの direction、formula 文字列、使用した precision を加えます。複利率が正のときは、正確な倍増時間 ln(2) を ln(1 + cagr) で割った years_to_double も含まれます。率が負でマイナス1より大きいときは、代わりに years_to_halve が含まれます。計算例として、開始100・終了121・years 2 なら growth_factor は 1.21、total_growth_percent は 21、cagr は 0.1、cagr_percent は 10、arithmetic_average_percent は 10.5、direction は expansion です。成功した parse 呼び出しは公開の基本料金 $0.002 を使い、モデルトークンも外向きネットワークも使いません。

GDP年平均成長率の計算機が役立つ場面

実装は解析ティアAの分析コードのため、成功コールはモデルトークンも外向きネットワークもなく $0.002 のままです。テストに cagr_percent と growth_factor を固定し、非正のGDPを明示的に拒否すれば、国民経済計算のパイプラインや独自の浮動小数点の端を抱えずに、課題・国別メモ・軽量ダッシュボード向けの再現可能な長期成長値が得られます。

連携の活用例

複数年GDP成長の課題と試験

教科書の二つのGDP水準と年数を入れ、端点の恒等式に対して cagr_percent を確認し、素朴な算術平均と対比します。

国比較表とブリーフ用メモ

公表された一対のGDP読みを再現可能な年平均複利率に変え、成長が正ならスライドやメモ用の正確な years_to_double も得ます。

LMSと個別指導の自動採点

非正の beginning_gdp や years を Infinity にせず invalid_input で拒否する決定論的オラクルで、GDPのCAGR問題を採点します。

技術的な質問

GDPの年平均成長率はどう計算しますか。

beginning_gdp、ending_gdp、years を送ってください。APIは cagr = (ending_gdp / beginning_gdp)^(1 / years) − 1 と cagr_percent = cagr × 100、および期間全体の総成長を返します。

終了GDPが開始GDPより小さい場合はどうなりますか。

縮小です。cagr と cagr_percent は負、direction は contraction となり、応答には years_to_double の代わりに years_to_halve（その一定率で産出が半分になる正確な時間）が含まれます。

GDP年平均成長率の計算機の料金はいくらですか。

ブラウザのツールは無料です。API要求は成功した呼び出しごとに前払いのKIT残高を $0.002 で使い、不正な入力は課金されません。

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

GDP年平均成長率の計算

無料で実行

計算例

GDP年平均成長率が測るものと、振れをならす理由

GDP年平均成長率の計算機が役立つ場面

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

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

リクエスト例

レスポンス例

料金

エラー

技術的な注記

GDP年平均成長率が測るものと、振れをならす理由

入力契約・応答の形・検証の振る舞い

GDP年平均成長率の計算機が役立つ場面

連携の活用例

複数年GDP成長の課題と試験

国比較表とブリーフ用メモ

LMSと個別指導の自動採点

技術的な質問

ありがとう