ForHosting KIT · 開発者向けツール

HDI教育指数計算機｜平均・就学予測年数

HDI教育指数計算機は、教育へのアクセスを示す二つの指標を組み合わせます。一つは成人が修了した平均就学年数、もう一つは子どもが今後受けられると見込まれる予測就学年数です。平均値は15年、予測値は18年を目標値として正規化し、二つの指数の算術平均を求めます。結果はゼロから一までの無次元値となり、人間開発指数を分析する際の教育部門として利用できます。

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

無料で実行 API仕様を見る

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

教育次元指数が表す内容

人間開発指数では、教育を、すでに達成された学歴と次世代に用意された機会の組み合わせとして捉えます。平均就学年数は25歳以上の人が修了した教育年数を要約するため、変化は緩やかで、長年蓄積された成果を反映します。予測就学年数は、年齢別の現在の就学状況が続く場合に、就学年齢の子どもが何年間教育を受けられるかを推定します。どちらか一方だけでは重要な状況を見落とす場合があります。就学機会を最近拡大した国でも成人の正規教育歴はまだ短いことがあり、反対に成人の教育水準が高くても現在の機会が縮小していることがあります。教育指数は、両者を比較可能な尺度に直してから同じ重みを与えます。二つの入力がゼロなら結果はゼロ、両方が目標値なら一です。比較や集計に使う指数であり、教育の質、学習成果、識字率、格差、教育支出を直接測るものではありません。

目標値による正規化の計算方法

平均就学年数にはゼロから15まで、予測就学年数にはゼロから18までの値をご入力ください。計算機は最初の値を15で割り、平均就学年数指数を算出します。次の値を18で割り、予測就学年数指数を算出します。下限目標はいずれもゼロなので、割り算の前に減算する必要はありません。最終的な教育指数は二つの正規化値の算術平均であり、合計を二で割ります。たとえば平均が7.5年なら成分は0.5、予測が13.5年なら0.75となり、教育指数は0.625です。安定した表示のため結果を小数点以下六桁に丸めますが、丸める前の計算では入力値をそのまま使用します。想定するゼロから一の範囲を守るため、目標値を超える入力は受け付けません。欠落値、負数、無限値、数値ではない値も無効として扱います。

結果を適切に解釈して利用する方法

返された指数は、同じ地域と基準期間に対応する二つの就学期間指標を正規化した要約としてお使いください。値が高いほど、入力された数値が平均的に教育目標へ近いことを意味しますが、生徒の学習量が多いこと、機会が公平であること、学校の指導が優れていることを証明するものではありません。国、地域、年度を比べる際は、資料となる二つの指標が互換性のある定義と期間を採用しているかご確認ください。就学率推計や成人の教育歴データが改訂されると、計算式が同じでも結果は変わります。出力には二つの成分指数と目標値が含まれるため、計算を検証し、差の原因となる入力を確認できます。HDI全体を分析する場合は、適用する手法に従い、別に算出した健康指数と所得指数を組み合わせてください。丸めていない元データと出典を保存し、データ品質や不確実性を考慮せずに、丸めた指数の小さな差を有意な順位として扱わないことが大切です。

活用例

HDI計算の準備

健康指数および所得指数と組み合わせる前に、正規化した教育成分を算出します。

教育指標の比較

成人の教育歴と予測就学年数を比較可能な尺度にそろえ、差の要因を確認します。

公表値の検証

二つの元データから教育指数を再現し、成分指数と目標値を点検します。

よくある質問

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

平均就学年数を15で割った値と、予測就学年数を18で割った値の平均を求めます。

目標値が15年と18年なのはなぜですか？

HDIの教育次元で二つの就学指標を正規化するために用いられる上限目標だからです。

教育指数はどの範囲になりますか？

入力が指定された目標範囲内であれば、両端を含むゼロから一までです。

人間開発指数全体を計算できますか？

いいえ。教育次元だけを算出します。HDI全体には健康次元と所得次元も必要です。

APIリクエストの料金はいくらですか？

APIリクエストは1件あたり$0.002です。ブラウザー計算機はAPIリクエストなしで利用できます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/econ/hdi-education-index

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

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

curl -X POST https://api.kit.forhosting.com/econ/hdi-education-index \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mean_years_schooling":8.5,"expected_years_schooling":13.2}'

const res = await fetch("https://api.kit.forhosting.com/econ/hdi-education-index", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "mean_years_schooling": 8.5,
    "expected_years_schooling": 13.2
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/econ/hdi-education-index",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "mean_years_schooling": 8.5,
    "expected_years_schooling": 13.2
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/econ/hdi-education-index", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"mean_years_schooling":8.5,"expected_years_schooling":13.2}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"mean_years_schooling":8.5,"expected_years_schooling":13.2}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/econ/hdi-education-index", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "mean_years_schooling": 8.5,
  "expected_years_schooling": 13.2
}

レスポンス例

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