API 機 能 の 概 要 と 活 用 事 例 平 成 25 年 6 月 7 日 総 務 省 統 計 局 独 立 行 政 法 人 統 計 センター
1.API 機 能 の 御 紹 介 統 計 データを プログラムから 簡 単 に 取 得 できるようにするために API(Application Programming Interface) 機 能 を 提 供 ホームページを 表 示 する 際 に 利 用 するURI(http://. )でリクエストすると 統 計 データが XML 形 式 等 で 出 力 される( 必 要 なデータのみの 取 得 又 は 全 データの 一 括 取 得 が 可 能 ) REST http://api/get? 統 計 データベース API php XML http:// /get? プ ロ グ ラ ム Ruby Python 他 のサービス API XML R 1
1.API 機 能 の 御 紹 介 ( 提 供 データ) 政 府 統 計 の 総 合 窓 口 (e-stat)で 提 供 している 以 下 の 統 計 調 査 を 提 供 データ 量 : 約 3 万 2 千 表 ( 約 47 億 セル) 2013/6/3 時 点 統 計 情 報 データベース 等 に 登 録 されている 統 計 データに 限 る 政 府 統 計 名 統 計 表 数 国 勢 調 査 5,518 住 宅 土 地 統 計 調 査 7,095 住 民 基 本 台 帳 人 口 移 動 報 告 265 人 口 推 計 388 労 働 力 調 査 690 就 業 構 造 基 本 調 査 2,413 社 会 生 活 基 本 調 査 5,265 個 人 企 業 経 済 調 査 120 科 学 技 術 研 究 調 査 1,466 サービス 産 業 動 向 調 査 3 サービス 業 基 本 調 査 299 政 府 統 計 名 統 計 表 数 事 業 所 企 業 統 計 調 査 1,822 経 済 センサス- 基 礎 調 査 148 家 計 調 査 84 貯 蓄 動 向 調 査 647 全 国 消 費 実 態 調 査 2,057 家 計 消 費 状 況 調 査 7 小 売 物 価 統 計 調 査 2 全 国 物 価 統 計 調 査 332 消 費 者 物 価 指 数 2 地 域 メッシュ 統 計 1,511 社 会 人 口 統 計 体 系 1 統 合 等 された 統 計 調 査 については 調 査 実 施 公 表 時 の 政 府 統 計 名 としている 2 経 済 センサス- 活 動 調 査 については 公 表 後 データベース 化 が 完 了 次 第 提 供 予 定 ( 都 道 府 県 市 区 町 村 のすがた) 1,973 2
2.API 機 能 の 活 用 事 例 1. 利 用 者 の 情 報 システムにe-Statのデータを 自 動 的 に 反 映 常 に 最 新 の 情 報 を 表 示 主 要 な 情 報 をまとめて 表 示 利 用 者 の 情 報 システムが 統 計 データを 保 持 しない 場 合 であっても 常 時 APIを 経 由 して 自 動 的 に 最 新 のデータをウェブサイトに 反 映 させる 等 の 利 用 が 想 定 される 2.ユーザー 保 有 やインターネット 上 のデータ 等 と 連 動 させた 高 度 な 統 計 データ 分 析 事 前 に 統 計 データを 一 括 でダウロードしDB 等 に 格 納 した 後 BIツール 等 で 分 析 するなどの 利 用 が 想 定 される 政 府 統 計 の 総 合 窓 口 (e-stat)から EXCEL 等 をまとめてダウンロードしDB 等 に 格 納 するに は 多 くの 手 間 や 時 間 が 掛 かるが API 機 能 を 利 用 することにより 簡 易 にDB 等 に 格 納 するこ とが 可 能 最 新 情 報 は 差 分 を 取 り 込 むことで 対 応 3
2.API 機 能 の 活 用 事 例 ( 複 数 の 統 計 情 報 を 表 示 ) 地 域 を 切 り 替 えることにより 統 計 情 報 が 切 り 替 わる 住 宅 土 地 統 計 調 査 から 取 得 (1 表 ) 国 勢 調 査 から 取 得 (2 表 ) 家 計 調 査 から 取 得 (1 表 ) 経 済 センサスから 取 得 (1 表 ) 4
2.API 機 能 の 活 用 事 例 (チャートで 表 示 ) バブルチャートで 表 示 最 新 月 のデータを 表 示 データベースが 更 新 されれば 最 新 データが 表 示 される Googleモーションチャート との 組 合 せ 棒 グラフで 表 示 5
3. 利 用 登 録 及 びアプリケーションIDの 発 行 について API 機 能 を 利 用 するためには 利 用 登 録 及 びアプリケーションIDの 発 行 が 必 要 利 用 登 録 及 びアプリケーションIDの 発 行 の 流 れは 次 のとおり 6 月 10 日 午 前 10 時 から 利 用 登 録 可 能 となります それまでは 利 用 登 録 ログイン 画 面 にはアクセスできません (1) 次 世 代 統 計 利 用 システムにアクセス ( http://statdb.nstac.go.jp) 利 用 登 録 を 選 択 (2) 利 用 登 録 ( 仮 登 録 ) (3) メール 受 信 メールアドレスを 登 録 受 信 メールのリンクから 本 登 録 画 面 へアクセス [ 次 世 代 統 計 利 用 システム API 機 能 利 用 登 録 ( 本 登 録 )のご 案 内 ] この 度 は 次 世 代 統 計 利 用 システム API 機 能 の 利 用 登 録 をお 申 込 み 頂 き ありがとうございます 仮 登 録 日 2013/06/04 下 記 の 内 容 に 従 って 本 登 録 の 手 続 きをお 願 いします 1. https://statdb.nstac.go.jp/apiuser/php/index.php?action=register& accesskey=f10e00dxxxxxxxxxxxxxxxxxfa9c4b18 にアクセスして 本 登 録 ページを 開 いて 下 さい 2. 各 項 目 を 入 力 してください 3. 入 力 内 容 に 誤 りがなければ 登 録 ボタンを 押 して 下 さい 以 上 で 本 登 録 が 完 了 します ------------------------------------------------------------------- 本 メールに 心 当 たりがない 場 合 は このメールは 破 棄 して 下 さい 翌 日 中 までに 本 登 録 をしなければ 仮 登 録 の 内 容 は 自 動 的 に 無 効 になります このメッセージはご 案 内 専 用 ですので 返 信 はしないで 下 さい ------------------------------------------------------------------- +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ 次 世 代 統 計 利 用 システム http://statdb.nstac.go.jp/ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ 6
3. 利 用 登 録 及 びアプリケーションIDの 発 行 について (4) 利 用 登 録 ( 本 登 録 ) パスワード 氏 名 等 を 登 録 (5) ログイン メールアドレスとパスワード を 入 力 してログイン (6) アプリケーションIDの 発 行 利 用 するシステム 名 称 等 の 登 録 を 行 いアプリケーションIDを 発 行 7
参 考 1.API 機 能 の 御 紹 介 ( 提 供 機 能 一 覧 ) No. 提 供 機 能 HTTP 内 容 パラメータ 1 統 計 表 情 報 取 得 GET 統 計 表 の 情 報 ( 統 計 表 ID 調 査 名 統 計 表 名 調 査 年 月 等 )を 提 供 する 機 能 検 索 キーワード 等 を 指 定 することで 絞 り 込 みが 可 能 調 査 年 月 公 開 年 月 統 計 分 野 政 府 統 計 コード 検 索 キーワー ド データ 種 別 調 査 名 一 覧 2 メタ 情 報 取 得 GET 統 計 表 ( 統 計 表 ID)に 含 まれるメタ 情 報 ( 表 章 事 項 時 間 軸 地 域 事 項 分 類 事 項 )を 提 供 する 機 能 3 統 計 データ 取 得 GET 統 計 表 ( 統 計 表 ID) に 収 録 されている 統 計 データ( 数 値 データ) を 提 供 する 機 能 必 要 に 応 じて データセット メタ 情 報 による 絞 り 込 みを 行 うこと ができる 提 供 するデータが 大 量 の 場 合 は 分 割 して 提 供 される 4 データセット 登 録 POST 統 計 データの 取 得 時 の 絞 り 込 み 条 件 を 登 録 する 機 能 統 計 データ 取 得 時 にデータセットの 絞 り 込 み 条 件 から 更 に 絞 り 込 むこともできる 登 録 したデータセットは 他 のユーザに 公 開 することもできる 統 計 表 ID データセットID 統 計 表 ID 絞 り 込 み 条 件 取 得 開 始 位 置 取 得 件 数 メタ 情 報 有 無 件 数 表 示 データセットID 統 計 表 ID 絞 り 込 み 条 件 公 開 可 否 処 理 モード データセット 概 要 5 データセット 参 照 GET 登 録 されているデータセットの 情 報 を 参 照 する 機 能 データセットID 8
参 考 1.API 機 能 の 御 紹 介 ( 利 用 の 流 れ( 例 )) APIサーバ クライアント 統 計 表 ID 表 題 等 を 検 索 22 年 and 市 区 町 村 and 人 口 統 計 表 情 報 取 得 <LIST_INF id=0003038587> < STATISTICS_NAME> 平 成 22 年 国 勢 調 査 男 女 年 齢 0003038587 平 成 22 年 国 勢 調 査 http://xxxxx.jp/getstatslist?serchword= 22 年 and 市 区 町 村 and 人 口 該 当 統 計 表 IDの メタ 情 報 検 索 0003038587 メタ 情 報 取 得 0003038587 総 数 男 女 北 海 道 札 幌 市 (データセット 登 録 ) 統 計 データ 検 索 0003038587 総 数 北 海 道 札 幌 市 統 計 データ 取 得 0003038587 平 成 22 年 国 勢 調 査 北 海 道 札 幌 市 5506419 9
参 考 1.API 機 能 の 御 紹 介 ( 統 計 表 情 報 取 得 ) リクエスト http://statdb.nstac.go.jp/api/1.0b/app/getstatslist?appid=xxxxx&statscode=00200&searchword= 国 勢 調 査 getstatslist 統 計 表 情 報 取 得 のURI appid 利 用 者 のアプリケーションIDを 指 定 するパラメータ アプリケーションIDはユーザ 登 録 を 行 い 取 得 statscode 政 府 統 計 コードを 指 定 するパラメータ 5 桁 の 場 合 は 作 成 機 関 名 となる ( 例 : 総 務 省 ) searchword 表 題 メタ 情 報 等 に 含 まれるキーワードを 検 索 するパラメータ ( 実 際 の 利 用 時 はエンコードが 必 要 ) その 他 : 言 語 統 計 分 類 調 査 年 月 公 表 年 月 などが 指 定 できる レスポンス <?xml version= 1.0 encoding= UTF-8?> <GET_STAT_LIST> <DATALIST_INF> <NUMBER>907</NUMBER> <LIST_INF id= 0000123456 > <STAT_NAME code= 00200521 > 国 勢 調 査 </ STAT_NAME> <GOV_ORG code= 00200 > 総 務 省 </GOV_ORG> <STATISTICS_NAME> 平 成 22 年 国 勢 調 査 人 工 等 基 本 集 計 ( 男 女 年 齢 配 偶 関 係, 世 帯 の 構 成, 住 居 の 状 態 など)</STATISTICS_NAME> <TITLE no= 01 > 男 女 別 人 口 及 び 世 帯 の 種 類 (2 区 分 ) 別 世 帯 数 全 国 市 部 郡 部 都 道 府 県 市 部 郡 部 支 庁 郡 計 市 区 町 村 旧 市 区 町 村 全 域 人 口 集 中 地 区 </TITLE> </LIST_INF> <LIST_INF id= 0000123457 > <STAT_NAME code= 00200521 > 国 勢 調 査 </ STAT_NAME> <GOV_ORG code= 00200 > 総 務 省 </GOV_ORG> </LIST_INF> </GET_STAT_LIST> 10
参 考 1.API 機 能 の 御 紹 介 ( 統 計 データ 取 得 ) リクエスト http://statdb.nstac.go.jp/api/1.0b/app/getstatsdata?appid=xxxxx&statsdataid=0000123456&cdcat01from=000 &cdcat01to=001 getstatsdata 統 計 データ 取 得 のURI appid 利 用 者 のアプリケーションIDを 指 定 するパラメータ アプリケーションIDはユーザ 登 録 を 行 い 取 得 statsdataid 統 計 表 IDを 指 定 するパラメータ cdcat01from 分 類 事 項 01から 抽 出 するコードを 指 定 するパラメータ( 開 始 ) cdcat01to 分 類 事 項 01から 抽 出 するコードを 指 定 するパラメータ( 終 了 ) その 他 : 言 語 データセットID 表 章 事 項 地 域 事 項 時 間 軸 などが 指 定 できる レスポンス <?xml version= 1.0 encoding= UTF-8?> <GET_STATS_DATA> <STATISTICAL_DATA> <TABLE_INF id= 0000123456 > <STAT_NAME code= 00200521 > 国 勢 調 査 </STAT_NAME> <CLASS INF> <CLASS_OBJ id= cat01 name= 男 女 > <CLASS code= 000 name= 総 数 level= 1 unit= 人 > <CLASS code= 001 name= 男 level= 2 unit= 人 > </CLASS_OBJ > </CLASS_INF> <DATA_INF> <VALUE cat01= 000 area= 00000 unit= 人 >128,057,352</VALUE> <VALUE cat01= 001 area= 00000 unit= 人 >62,327,737</VALUE> </GET_STAT_LIST> メタ 情 報 数 値 情 報 11
参 考 2. 政 府 統 計 の 総 合 窓 口 (e-stat)との 関 係 API 機 能 で 利 用 できる 統 計 データは e-stat 上 で DB 表 示 のあるデータに 対 応 統 計 情 報 データベースに 登 録 されている 政 府 統 計 の 総 合 窓 口 http://www.e-stat.go.jp 12
参 考 2. 政 府 統 計 の 総 合 窓 口 (e-stat)との 関 係 http://statdb.nstac.go.jp/api/1.0b/app/getstatsdata?appid=xxxxx &statsdataid=0003013276&cdarea=09003,22004&cdcat01=010920070 &cdtimefrom=2012000101&cdtimeto=2013000303 APIで 取 得 e-statで 取 得 した 統 計 データとAPI で 取 得 した 統 計 データは 内 容 が 一 致 13