初めに

ゼミの研究発表の為に、人口データが必要になったのでRESASのAPIを使って市町村ごとの人口データ取得しました。その方法をまとめてご紹介します。

APIキーの取得
都道府県コードの取得
市区町村コードの取得
人口構成データの取得
人口ピラミッドの取得

APIキーの取得

公式サイトに登録をしてAPIキーを取得します。
RESAS API公式サイト

下はRESAS-APIの仕様書のリンクです。
RESAS-API仕様書

都道府県コードの取得

都道府県コードを指定することで、都道府県を指定することができます。
その為に必要な都道府県コード一覧をAPIを使って取得します。

import requests

api_key = "取得したAPIキーを入れてね"
headers = {"X-API-KEY": api_key}

response = requests.get("https://opendata.resas-portal.go.jp/api/v1/prefectures", headers=headers)
data = response.json()

黄色でマーカーを引いた数字の部分が都道府県コードです。
都道府県コードをprefCode
市区町村コードをcityCode
といいます。

今回指定したURLは

都道府県一覧のsampleにURLがあります。

市区町村コードの取得

研究内容の関係で、熊本県の市町村コードを取得します。
熊本県の都道府県コードは43です。

# Make a GET request to the API endpoint
response = requests.get(" https://opendata.resas-portal.go.jp/api/v1/cities?prefCode=43", headers=headers)

# Process the response
data = response.json()

URLのprefCodeに43を指定しています。

熊本市のcityCodeが43100であることがわかります。

今回指定したURLは

市町村一覧のsampleにURLがあります。

人口構成データの取得

cityCodeに43100、prefCodeに43を指定することで
熊本県熊本市の人口構成データが取得できます。

response = requests.get("https://opendata.resas-portal.go.jp/api/v1/population/composition/perYear?cityCode=43100&prefCode=43", headers=headers)

data = response.json()

データの中身
総人口、年少人口、生産年齢人口、老年人口が1985～2045まで5年ごとに入っています。また、valueとrateで人数と割合がわかります。実績値は2020年まで、それ以降は推計値です。

sample URLは人口構成の所にあります。

人口ピラミッドの取得

cityCodeに43100、prefCodeに43を指定することで
熊本県熊本市の人口ピラミッドを取得できます。

response = requests.get("https://opendata.resas-portal.go.jp/api/v1/population/composition/pyramid?cityCode=43100&yearRight=1990&prefCode=43&yearLeft=2020", headers=headers)
data = response.json()

地域単位、年単位の人口ピラミッドデータを返します。
1980-2045年（5年毎）で実績値は2020年まで、それ以降は推計値。

sample URLは人口ピラミッドの所にあります。

終わりに

RESAS APIの使い方をまとめてみました。
少しでもお役に立てると嬉しく思います。

RESAS API使い方メモ

初めに