ForHosting KIT · 開発者向けツール

所得五分位倍率（S80/S20）計算ツール

所得五分位倍率（S80/S20）は、人口のうち最も所得が高い20パーセントが受け取る所得の割合と、最も低い20パーセントが受け取る割合を比較する指標です。同じ統計資料から得た2つの所得シェアを入力すると、上位五分位の割合を下位五分位の割合で割ります。結果は、最富裕層のシェアが最貧困層の何倍かを示すため、広く使われる所得格差指標を手軽に計算し、明確に解釈できます。

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

無料で実行 API仕様を見る

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

S80/S20が測るもの

所得五分位倍率は、所得分布の両端を1つの比較値にまとめます。まず個人または世帯を等価可処分所得の順に並べ、人口を同人数の5群に分け、各群が総所得の何割を受け取るかを求めます。S80は上位5分の1、S20は下位5分の1の所得シェアです。S80をS20で割ると、最富裕層のシェアが最貧困層の何倍かが分かります。結果が5.8なら、上位群は下位群の5.8倍の割合を受け取っています。値が大きいほど、選択したデータと手法のもとで両端の隔たりが大きいことを示します。ただし、分布全体、格差の原因、各五分位内の差までは説明しません。定義が統一された人口、地域、期間を比較するための焦点を絞った要約指標としてご利用ください。

シェアの入力方法と計算式

最富裕層と最貧困層の所得シェアを、同じ資料に掲載された総所得に対する百分率で入力してください。たとえば上位20パーセントが45.2パーセント、下位20パーセントが7.8パーセントを受け取る場合は、45.2と7.8を入力します。標準式はS80/S20 = 最富裕層のシェア ÷ 最貧困層のシェアです。分母が0では倍率を定義できないため両方とも正数でなければならず、どちらも100を超えられません。2群は重ならず、残りの所得は他の五分位に属するため、合計も100以下である必要があります。小数を使用でき、安定した出力のためだけに結果を丸めます。単位は除算で相殺されますが、入力の尺度はそろえてください。0.452のような小数比と7.8のような百分率を混在させず、同一分布の百分率を2つ入力してください。

結果を過大評価せず比較する方法

S80/S20は、比較するすべての観測値が同じ定義に従う場合に最も有効です。資料が個人と世帯のどちらを対象とするか、どの所得項目を含むか、税と移転を反映するか、どの等価尺度と基準期間を使うかをご確認ください。世帯可処分所得による倍率を、個人総所得による倍率とそのまま比較することはできません。標本抽出、調査への無回答、高所得層の把握不足、統計改定もシェアを変える可能性があります。時系列を追う際は、変化が上位、下位、または両方から生じたか確認できるよう、元のシェアも倍率と一緒に保存してください。分布全体を把握するには、ジニ係数、所得中央値、貧困率、十分位シェアなども併用します。この計算ツールは決定論的に算術処理を行い、値の高低を評価しません。単独の数値ではなく、文書化された基準と比較可能なデータに基づいて解釈してください。

活用例

地域間の所得格差を比較する

人口、所得定義、基準年が同一の地域についてS80/S20を計算できます。

所得分布の推移を追跡する

公表された上下五分位のシェアを一貫した年次系列に変換し、監査用に元の値も保持できます。

報告書や表計算を検算する

格差表や政策資料を公表する前に、構成シェアから記載された五分位倍率を再計算できます。

よくある質問

所得五分位倍率の計算式は何ですか？

S80/S20は、最富裕20パーセントの所得シェアを最貧困20パーセントの所得シェアで割った値です。

S80/S20が6とはどういう意味ですか？

そのデータの定義では、最富裕層が最貧困層の6倍の総所得シェアを受け取ることを意味します。

百分率と小数比のどちらを入力しますか？

45.2や7.8のような百分率を入力してください。両方を同じ尺度にし、同じ分布から取得する必要があります。

倍率は低いほど常に良いのですか？

低い値は選択した五分位間の差が小さいことを示しますが、評価には背景、比較可能な定義、他の福祉指標が必要です。

S80/S20とジニ係数は同じですか？

異なります。S80/S20は上下の五分位だけを比較し、ジニ係数は分布全体の格差を要約します。

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

APIリクエスト1回につき$0.002です。同じ決定論的計算をブラウザーでは無料で実行できます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/econ/quintile-share-ratio

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

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

curl -X POST https://api.kit.forhosting.com/econ/quintile-share-ratio \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"richest_fifth_share":45.2,"poorest_fifth_share":7.8}'

const res = await fetch("https://api.kit.forhosting.com/econ/quintile-share-ratio", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "richest_fifth_share": 45.2,
    "poorest_fifth_share": 7.8
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/econ/quintile-share-ratio",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "richest_fifth_share": 45.2,
    "poorest_fifth_share": 7.8
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/econ/quintile-share-ratio", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"richest_fifth_share":45.2,"poorest_fifth_share":7.8}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"richest_fifth_share":45.2,"poorest_fifth_share":7.8}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/econ/quintile-share-ratio", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "richest_fifth_share": 45.2,
  "poorest_fifth_share": 7.8
}

レスポンス例

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