Code-Savvy Manifesto: Evaluating Japan's Local Open Data through CSV, APIs, and Practice

どうも〜おかむーです！今日は政府・自治体データを“コードで語るマニフェスト”として見ていきますよ〜

• Municipalities publish useful datasets (Tokyo catalog, Hakodate, Aomori, Tokushima) but formats vary wildly
• Machine-readability (CSV/API) often works, but metadata, schemas, and update practices are inconsistent
• Engineer-friendly improvements (standard schemas, validation, APIs, example code) would unlock reuse fast

結論

現場のデータ公開は進んでいるけど、エンジニア的に言うと「同じCSVでも中身が違う」問題がボトルネックです。要するに、データはあるけど再利用しづらい。APIと標準スキーマ、バリデーションを整備すれば政策評価と市民利用が劇的に向上します。

レポート本文

現状サーベイ（参照ソース）

これ見てくださいよ：東京都オープンデータカタログや函館市のCSV一覧、青森・徳島のオープンデータページ、そして新潟市のCSV作成マニュアル。さらに、デジタル田園都市交付金関連（chisou.go.jp）やRAIDAプラットフォームで地方施策の実装事例が公開されています。公式ドメイン（go.jp、lg.jp）でデータが直接ダウンロードできるのは良い兆候。

技術的な問題点

• フォーマットの非一貫性：CSVでも列名・日付形式・欠損表現が自治体ごとに違う。エンジニア的に言うと、同じスキーマ定義がないと解析パイプラインが壊れます。
• メタデータ不足：更新日時やライセンス、説明がカタログにあっても機械で取りにくいケースあり。
• APIの不在または部分的実装：いくつかはAPIを提供しているけど、安定したOpenAPI定義や認証フローが揃ってない。
• PDFに埋められた報告書：数値目標や実績がPDF中心だと自動集計が難しい。要するにCSVまたはJSONで公開すべき。

実例：評価データの扱い

須賀川市のデジタル田園都市構想評価（city.sukagawa.fukushima.jp）は外部検証を掲載しているけど、機械可読データの形で実績指標を公開していれば全国比較や可視化がもっと容易になります。

簡単な技術レシピ（コード例）

CSVを拾って型チェック・欠損ルールを検証する簡単なPython例：

import pandas as pd
from dateutil.parser import parse

def load_and_check(url):
df = pd.read_csv(url)
# check date column
try:
df['date'] = pd.to_datetime(df['date'])
except Exception:
print('date column inconsistent')
# simple completeness
print('missing per column:\n', df.isna().sum())

load_and_check('https://www.example.go.jp/data.csv')

APIがあればcurlでJSONを落としてschema validation（JSON Schema）を回すだけでCIに組み込めます。

改善提案（実装優先度あり）

共通スキーマの採用（DCAT-AP.jpや独自CSVテンプレート） — 各自治体のCSVに必須カラムを定義する

機械可読メタデータの配備 — 更新日時、バージョン、ライセンス、連絡先をAPI経由で取得可能に

自動バリデーションパイプライン — CIでCSVLint/JSON Schemaを用いて公開前に検証

APIとOpenAPI仕様の公開 — 1エンドポイントでパイプラインを組めるように

ベストプラクティスのテンプレート（Niigata CSV manualみたいな実践ガイドの全国展開）

政策評価のための具体フロー

• 政策目標（数値目標）→ 可視化用メトリクスを定義（機械可読）→ 定期的にCSV/JSONで公開→ 外部プラットフォーム（RAIDA等）で自動集計
• これで交付金や施策の実績差がリアルタイムでわかるようになる！

まとめ

地方のオープンデータ基盤は揃いつつあるけど、標準化とバリデーションが追いついていない。PDFで埋められた指標をCSV/JSONにし、APIとスキーマで縦横に繋げれば、政策評価も市民サービスもぐっと良くなります。技術的には難しくないんです、やるかやらないかの差だけ！

おかむーから一言

テクノロジーで行政をアップデートするのは可能です。コードとデータで「約束」を可視化していきましょう〜！