コードで語るマニフェスト:日本の行政データをエンジニア視点で検証する

안녕하세요~ 오카무입니다! 오늘은 정부·지방자치단체의 데이터와 시스템을 엔지니어 관점에서 훑어보는 글입니다. 주제는 "코드로 말하는 매니페스토"—정책을 숫자와 인터페이스로 검증해보죠!
- 이 글 3줄 요약
- 기계가 읽을 수 있는 포맷(Excel/CSV/JSON) 규칙은 강화됐지만 현장 적용과 스키마 표준화가 과제
- 해결책은 표준 API, JSON Schema, 자동화 파이프라인, 그리고 실용적 예제 코드 도입이다
結論
정부는 좋은 인프라(デジタル庁의 API 카탈로그, 도쿄 오픈데이터 포털 등)를 만들고 있지만, 실제 활용 가능성은 데이터 포맷·스키마·バージョニング 관리에서 좌우됩니다. 엔지니어적 해결책은 "기계가 바로 쓸 수 있는 형태로 공개"하고, 표준 스키마와 샘플코드, API 안정성 보장을 통해 데이터 소비 비용을 낮추는 것입니다。
レポート本文
現状の観察(データソース参照)
これ見てくださいよ:デジタル庁やe-GovのAPIカタログ(api-catalog.e-gov.go.jp)、東京都のオープンデータAPI(portal.data.metro.tokyo.lg.jp)といった公式資源はあるんです。ただ、会議資料(digital.go.jp の「機械可読性に関するルール」案)を見ると、まだ“レベル1:閲覧・転記可能”から抜けきれていない自治体が多いのが現実です。
要するに、機械可読性ルールがあるのは良いんですが、PDF→CSV/JSONへの移行、スキーマ統一、API設計の品質保証が足りないということです。
技術的課題の整理
- フォーマット:PDFやWordで公開されるデータが多い→自動処理が難しい
- スキーマ不整合:同じ項目でも列名や型が自治体毎にバラバラ
- APIの有無・品質:e-Govや都道府県APIはあるが、認証・レート制御・バージョン管理が不十分
- メタデータ欠如:ライセンス、更新頻度、作成日時などが明示されていない
エンジニア的に言うと:具体的改善案
1) 機械可読性を必須化する(CSV/JSON/NDJSON + JSON Schema)
- 要するに、公開データは"そのままプログラムで読み込める"ことを要件にするということです
2) API一本化とスキーマ管理
- OpenAPI で定義し、JSON Schemaを置く。これで型安全に消費側が組めます
3) データカタログ+メタデータ整備
- e-Govカタログにライセンス・更新日を明記。CKAN系のカタログ運用を各自治体で共通化
4) 自動 ETL パイプライン提供
- PDFテーブル抽出(Tabula/ Camelot)→正規化→スキーマ検証→公開
5) サンプルコードを公式で配布
- エンジニアの参入障壁を下げるため、認証付きAPIコールの例やCSV→DBロード例を掲載
コード例(超シンプル)
下は、都のCSV APIを取ってきてPandasで整形する例です。
import requests
import pandas as pd
url = 'https://portal.data.metro.tokyo.lg.jp/api/example.csv'
r = requests.get(url)
open('data.csv','wb').write(r.content)
df = pd.read_csv('data.csv')
スキーマ名変換の例
df = df.rename(columns={'古い列名':'standard_name'})
df.to_json('data_normalized.json', orient='records', force_ascii=False)
要するに、APIがまともに定義されていればこのコードは数行で済むんですよね。
政策目標と実績のギャップ分析
デジタル行財政改革会議の資料では機械可読性ルールが決定されています(参照:digital.go.jp)。目標は明確だけど、実務ベースでの実装率は自治体間で大きく差があるのが課題。具体的に言うと「年度内にX件をCSV化」みたいな数値目標はあるが、実際の公開数と品質(スキーマ準拠率)が追えていない。
解決には、メトリクスの公開が必要です:
- 機械可読データ件数
- スキーマ準拠率
- API稼働率・レスポンスタイム
オープンデータの活用可能性
- 官民連携でリアルタイムな公共データ(公共施設稼働、福祉サービス利用状況等)のアプリ化が可能
- データ単位でマイクロサービス化すれば自治体間で再利用可能なコンポーネントが生まれる
技術的ロードマップ(短期〜中期)
- 短期(6ヶ月):重要データのCSV/JSON化、OpenAPI定義、サンプルコード公開
- 中期(1年):JSON Schema準拠ルールの適用、データカタログ統合、ETLテンプレ整備
- 長期(2年):リアルタイムAPIやストリーミング(WebSocket/イベント)、データ品質SLA導入
まとめ
- 公式APIとカタログは存在するが、フォーマットとスキーマの不整合が障害
- 機械可読性規則は前進だが、実装と監査が追いついていない
- 解決は技術的に明確:OpenAPI/JSON Schema、ETL自動化、メタデータ強化、サンプルコード配布
おかむーから一言
起業家としてもエンジニアとしても思うのは、テクノロジーで行政サービスはもっと速く良くなるってことです。API一本で市民のUXが変わるんですよ、ほんとに。使えるデータを増やして、一緒に社会をアップデートしましょう!
정보 출처
- https://www.zhihu.com/question/290714454
- https://metidx-gov.note.jp/n/n9468573c213b
- https://www.zhihu.com/question/6430289390
- https://zenn.dev/govtechtokyo/articles/b65dc687e50918
- https://www.zhihu.com/question/38923279
- https://www.e-gov.go.jp/digital-government/api
- https://portal.data.metro.tokyo.lg.jp/opendata-api/
- https://api-catalog.e-gov.go.jp/info/ja/apicatalog/list
- https://japan-opendata.github.io/awesome-japan-opendata/
- https://odcs.bodik.jp/developers/
- https://www.digital.go.jp/assets/contents/node/basic_page/field_ref_resources/256dcba6-b936-4031-b88d-3abb27e27f9b/f7af0ca4/20260331_meeting_executive_outline_06.pdf
- https://www.cas.go.jp/jp/seisaku/digital_gyozaikaikaku/kakusyoDX4/kakusyoDX4.html
공유하기
관련 리포트

コードで語るマニフェスト:自治体データとシステムをエンジニア視点で検証する
自治体データはPDFやUIに閉じがち。API-firstとJSON Schemaで再利用性を高め、ガバメントクラウドへ移行する実務ロードマップを提示します。

コードで語るマニフェスト:日本政府データの現場から見る技術検証
政府データは可視化が進むも機械可読性不足が課題。CSV/JSON/API、スキーマ、ID統一で政策検証を自動化しよう。

코드로 읽는 마니페스토: 일본 정부 데이터와 시스템을 엔지니어 관점에서 후벼파기
일본 정부 데이터의 PDF·API·메타데이터 문제를 엔지니어 관점에서 분석하고, 실무 가능한 개선안을 코드 예시와 함께 제시합니다。