# 人口減少シミュレーター (jinkou.keydrop.net) — 詳細ドキュメント

日本の全1,741市区町村の人口推移と将来推計を可視化・公開する静的サイト。
実績値は総務省統計局「国勢調査」（e-Stat API経由）、将来推計は国立社会保障・人口問題研究所（IPSS/社人研）
「日本の地域別将来推計人口（令和5年推計）」に基づく。推計は2050年まで。

引用時の出典表記:
  出典：総務省統計局「国勢調査」、国立社会保障・人口問題研究所「日本の地域別将来推計人口（令和5年推計）」
  （データ加工・可視化：人口減少シミュレーター https://jinkou.keydrop.net/）

## URL構造

| パターン | 内容 |
|---|---|
| / | トップ。市区町村検索・全国ランキング |
| /city/{code}/ | 市区町村ページ。{code}=5桁全国地方公共団体コード（例: 01100=札幌市, 13104=新宿区） |
| /pref/{prefCode}/ | 都道府県ページ。{prefCode}=2桁コード（01=北海道 … 47=沖縄県） |
| /ranking/ | ランキング一覧 |
| /ranking/decline/ | 人口減少率ランキング（2020→2050年） |
| /ranking/growth/ | 人口増加率ランキング |
| /ranking/aging/ | 高齢化率ランキング（2050年） |
| /ranking/{category}/{prefCode}/ | 都道府県別ランキング |
| /topic/population-decline-2050/ | トピック: 2050年の人口減少 |
| /topic/aging-society/ | トピック: 高齢化社会 |
| /topic/growing-cities/ | トピック: 人口が増える街 |
| /article/population-decline-causes/ | 記事: 日本の人口減少の原因（自然減・社会減の解説） |
| /article/growing-cities-2030-2050/ | 記事: 人口が増える都市ランキング2030・2050 |
| /compare/{codeA}-{codeB}/ | 2市区町村の比較 |
| /opendata/ | データ仕様ドキュメント |
| /en/... /zh/... /ko/... | 英語・中国語・韓国語版（主要都市のみ） |

## JSONデータエンドポイント（静的ファイル・認証不要）

### GET /data/city/{code}.json

市区町村別詳細データ。スキーマ:

```
{
  "code": "01100",              // 5桁市区町村コード（ゼロ埋め文字列）
  "name": "札幌市",
  "nameKana": "さっぽろし",
  "nameEn": "Sapporo",
  "prefCode": "01",
  "prefName": "北海道",
  "prefNameEn": "Hokkaido",
  "latestYear": 2020,           // 最新国勢調査年
  "latestPopulation": 1973395,  // 最新人口（実数）
  "timeline": [                 // 年次人口推移
    { "year": 1980, "population": 1401757, "isProjection": false },
    ...
    { "year": 2050, "population": 1637312, "isProjection": true }
  ],
  "pyramid": {                  // 年次別5歳階級人口
    "2020": { "ageGroups": [ { "label": "0-4", "male": 33000, "female": 31500 }, ... ] },
    ...
  },
  "metrics": {
    "changeRate10y": -3.2,      // 2020→2030 変化率(%)
    "changeRate20y": -8.1,      // 2020→2040 変化率(%)
    "changeRate30y": -17.0,     // 2020→2050 変化率(%)
    "pop2030": 1910000,         // 将来推計人口
    "pop2040": 1813000,
    "pop2050": 1637312,
    "elderlyRate2020": 27.5,    // 高齢化率(65歳以上比率, %)
    "elderlyRate2050": 38.2
  },
  "siblings": [ { "code": "01101", "name": "中央区" }, ... ]  // 政令市の区など
}
```

- isProjection: true の年は社人研推計値、false は国勢調査実績値
- 人口はすべて実数（千人単位ではない）
- 数値例は説明用のダミー。実値はJSONを取得して確認すること

### GET /data/ranking.json

```
{
  "byDeclineRate": [ { "code", "name", "prefName", "rate", "pop" }, ... ],  // rate=2020→2050変化率(%)
  "byPopulation":  [ ... ]
}
```

### GET /data/prefectures.json

47都道府県。各都道府県に cities[]（code / name / population / pop2050 / changeRate）。

### GET /data/search-index.json

全1,741市区町村の { code, name, nameKana, nameEn, prefName, population }。

## 都道府県コード表

01北海道 02青森県 03岩手県 04宮城県 05秋田県 06山形県 07福島県 08茨城県 09栃木県 10群馬県
11埼玉県 12千葉県 13東京都 14神奈川県 15新潟県 16富山県 17石川県 18福井県 19山梨県 20長野県
21岐阜県 22静岡県 23愛知県 24三重県 25滋賀県 26京都府 27大阪府 28兵庫県 29奈良県 30和歌山県
31鳥取県 32島根県 33岡山県 34広島県 35山口県 36徳島県 37香川県 38愛媛県 39高知県 40福岡県
41佐賀県 42長崎県 43熊本県 44大分県 45宮崎県 46鹿児島県 47沖縄県

## データの性質・注意事項

- 将来推計はコーホート要因法に基づく社人研の令和5年（2023年）推計。確定値ではなく、政策・経済情勢等で実績は変動する
- 推計対象は2050年まで。2050年以降の数値は存在しない
- 2025年国勢調査の結果公表後、実績値は順次更新される（データ最終更新日は /opendata/ に表示）
- 市区町村の合併・区の設置等により、過去データとコードの対応が変わる場合がある
- このサービスは、政府統計の総合窓口(e-Stat)のAPI機能を使用していますが、サービスの内容は国によって保証されたものではありません