コードで追う行政の実行速度:イベント駆動APIで政策の遅延を可視化する

IT政策の提案
コードで追う行政の実行速度:イベント駆動APIで政策の遅延を可視化する

どうも〜おかむーです!今日はちょっとエンジニア寄りな話をしますよ〜

  • 3行要約
  • APIや公開データだけで政策の“実行スピード”を観測できる!
  • 重要なのはデータの「イベント化」と「メタデータ(タイムスタンプ等)」です
  • 改善策は監視・デprecationポリシー・標準メタデータの3点セット!

結論

行政のデータ、API、ログをイベント駆動でつなげば、政策の目標と実績のギャップを時間軸で定量化できるんです。単なるCSVやPDFの公開だけでは足りない。エンジニア的に言うと、イベントとメタデータの設計が観測可能性(observability)を左右しますよ!

レポート本文

背景と問題意識

これ見てくださいよ:e-Govの「行政API」や東京都のオープンデータAPIは存在します(参照:e-Govポータル、東京都オープンデータAPI)。でも公開フォーマットがCSVやPDFでスナップショット提供が多いと、いつ変更されたか、誰がいつ処理したかが追えないんですよね。要するに、政策の“いつ実行されたか”が見えないということです。

  • 機械可読性のルール(Digital庁の資料)も進んでますが、ファイル単位の可読性=イベントの可観測性ではない
  • APIがあっても、バージョンやデプロイ履歴、状態変化を示すイベントが欠けているケースが多い

どうコードで測るか(手法)

1) イベント化:政策プロセス(申請受付、審査、決済、公開)を個別イベントとしてAPIで吐く

2) メタデータ:各イベントにtimestamp, actor_id, request_id, versionを付与

3) 集約とSLO(注:SLOは概念として利用する。データSLAという既存記事とは切り分けて考える)で遅延を可視化

これの実装イメージを簡単なコードで示します(Python + curl風)

# イベントを受け取ってTime-to-completeを計算するサンプル

import requests

from datetime import datetime

event = requests.get('https://api.example.gov/events?entity=subsidy&status=completed').json()

event は [{'id':..., 'request_id':'r1', 'type':'submitted','ts':'2025-03-01T10:00:00Z'}, ...]

pandasでgroupbyして遅延を出すのが早いです

curlでAPIのヘッダをチェックする例(運用観測性の第一歩)

curl -I 'https://api-catalog.e-gov.go.jp/info/...' 

Content-Type, X-RateLimit-*, Date等を確認

ポイントは「いつ起きたか(timestamp)」「そのデータがどのバージョンで生成されたか(version)」が必須ということです。これがあればPDFかCSVかに関係なくイベント時間で比較できます。

実務での障壁と改善案

  • 現状の障壁
- PDFスナップショットが残る(機械可読性ルールの運用負荷)

- APIに履歴やイベントがない、またはメタデータ不十分

- 運用組織側でイベント設計の知見が乏しい

  • 技術的改善案(段階的)
1. APIに標準メタ(timestamp, produced_by, schema_version)を必須化(参考:e-Gov APIカタログの慣例)

2. イベントストリーム(KafkaやPub/Sub)を導入して非同期に監査ログを公開

3. 公開ステータスページ+ヘルスチェックAPIで稼働率とインシデント履歴を見える化

4. DCAT/JSON-LD等でデータセットの由来(provenance)を明示

政策評価への応用例

例えば子育て補助金の「申請から支払完了までの中央値」を毎月自動で算出して公開すると、政策目標(例:支払完了まで30日以内)とのギャップが数値で示せます。APIイベントがあれば期間算出は秒で終わりますし、グラフ化やアラート化も簡単です。

まとめ

  • APIやオープンデータは増えてきたけど、イベントとメタデータがないと政策の実行速度は測れない
  • 技術的にはTimestamp付きイベント、履歴公開、プロビナンス記録で十分に改善可能
  • まずはヘッダと簡単なイベントAPIから始めるのが現実的な一歩

おかむーから一言

起業して何度も“計測できる仕組み”で勝負してきたんですけど、行政も同じなんですよね。テクノロジーで政策の「いつ」が見えるようになれば、議論がもっと建設的になるはず!

シェアする