Code-Driven Manifesto: Auditing Japan's Public Data & Local Government Systems

IT Policy Proposals
Code-Driven Manifesto: Auditing Japan's Public Data & Local Government Systems

どうも〜おかむーです! Hi, I'm Okamu — today we're going to nerd out about how Japanese government and municipal data actually ship, and what we can do as engineers to make them way more useful!

  • Japan has pockets of machine-readable data (CSV/APIs) but many important gov pages still embed stats in PDFs or heterogeneous CSVs.
  • The central push for local-government system standardization exists (Digital Agency / Soumu), but practical interoperability gaps remain.
  • With modest engineering fixes (APIs, OpenAPI, unified schemas, CI for datasets) municipalities can unlock huge civic value.

結論

Digital policy intentions are good — Digital Agency's Japan Dashboard and Soumu's standardization effort are steps forward (see https://www.digital.go.jp/resources/japandashboard and https://www.soumu.go.jp/...) — but the current state mixes high-quality APIs (e-Stat) and ad-hoc CSV/PDF practices (various ministries and municipal sites). 要するに、政策はあるけどデータパイプラインがバラバラで、実装(code)が足りないということです。

Report

What I checked (sources)

  • National dashboards & stats: e-Stat dashboard (https://dashboard.e-stat.go.jp/), Japan Dashboard (https://www.digital.go.jp/resources/japandashboard)
  • Policy pages on standardization: Digital Agency local_governments (https://www.digital.go.jp/policies/local_governments) and Soumu system standardization (https://www.soumu.go.jp/...)
  • Example datasets / CSV endpoints spotted in search results: NICTER notice CSV (https://notice.go.jp/docs/status_nicter.csv), ministry CSVs (e.g. https://www.mhlw.go.jp/content/001429362.csv), env CSVs.
  • Service examples: keiba.go.jp (https://www.keiba.go.jp/) — public-facing but mostly HTML content and media.

これ見てくださいよ: some endpoints are perfectly machine-readable CSVs you can curl; others provide only dashboards or PDFs. That inconsistency kills automation.

Technical gaps

  • Inconsistent formats: CSVs with different encodings, date formats, column names, and missing metadata (no schema). 要するに、normalizationが必要です。
  • No uniform API gateway for municipalities: Digital Agency has policy and PMO tooling, but municipalities often report via different PMO tools or static uploads, making aggregation brittle.
  • Metadata & discoverability: datasets aren’t always cataloged with machine-readable provenance (RDF/JSON-LD) or OpenAPI specs.

Concrete engineering examples

  • Quick fetch + normalize (Python/pandas):
import pandas as pd

url = 'https://notice.go.jp/docs/status_nicter.csv'

df = pd.read_csv(url, encoding='utf-8')

normalize datetime

df['ts'] = pd.to_datetime(df['timestamp'], errors='coerce')

standardize column names

df.columns = [c.strip().lower().replace(' ', '_') for c in df.columns]

  • API layer: deploy a small gateway that exposes municipal datasets under a unified schema (OpenAPI, JSON/CSV). Use an automated ETL (GitHub Actions) to validate CSVs with jsonschema and publish to a CKAN/Datastore.
  • Example schema snippet (JSON Schema concept):
{

"type":"object",

"properties":{

"date":{"type":"string","format":"date"},

"value":{"type":"number"},

"source":{"type":"string"}

},

"required":["date","value","source"]

}

Policy vs Implementation: measurable gaps

  • Soumu/Digital Agency set goals for standardizing core municipal systems. But without machine-readable progress metrics (e.g., percent of municipalities on standard system, with API endpoints), it's hard to audit impact.
  • Proposal: publish a small machine-readable progress API per municipality: {municipality_code, standard_system_version, migration_status, last_updated} so dashboards and researchers can measure real adoption rates.

Improvement roadmap (practical)

  • Publish dataset catalogs with machine-readable metadata (DCAT/JSON-LD) for all ministries and municipalities.
  • Require OpenAPI/Swagger for any published municipal/system API.
  • Standardize core schema for common domains (budget, HR, permits) and provide reference implementations (Docker images) municipalities can run.
  • CI for data: GitHub Actions validate CSVs with schema checks and auto-deploy to a central CKAN.
  • Provide a lightweight SDK (Python/JS) for querying the unified gateway and handling encoding/locale quirks.
  • まとめ

    • Japan has great building blocks: e-Stat, Japan Dashboard, and policy frameworks from Digital Agency and Soumu.
    • The missing piece is consistent engineering: unified schemas, APIs, metadata and CI for data quality.
    • Fixing those multiplies civic value: easier research, better transparency, and faster innovation by civic tech teams.

    おかむーから一言

    Tech solves a lot: publish schemas, ship APIs, run simple CI — and you turn bureaucracy into platform. Let's build the plumbing so policy actually becomes measurable and reusable!