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

IT Policy Proposals
Code-Driven Manifesto: Auditing Japan's Public Data & Systems
  • Quick three-line summary
- Japan has the building blocks: Digital Agency, Japan Dashboard, and e-Stat, but data formats and APIs are uneven across ministries and municipalities.

- PDFs and bespoke local systems block scale — engineers need stable JSON/CSV, OpenAPI, and common schemas to automate policy monitoring.

- Practical fixes: publish machine-readable KPIs, adopt CSVW/JSON Schema, provide sample APIs and migration tooling for local governments.

どうも〜おかむーです! Hey—okamu here! Today I’ll do a tech-first read of Japan’s public data posture — "code-as-manifesto" style. Engineers, policy nerds, and civic hackers, this one’s for you.

結論

Japan has made smart institutional choices (Digital Agency, Japan Dashboard, e-Stat), but real-world interoperability is slowed by PDFs, fragmented local systems, and inconsistent API practices. 要するに、政策はあるけどデータ工場が汚れてるんですよね。機械可読性を確保して、標準仕様とオープンAPIを義務化すれば、PDCAが回り出します!

Report: what's working and what's not

Current landscape (sources)

  • National: Digital Agency (https://www.digital.go.jp/) and Japan Dashboard (https://www.digital.go.jp/resources/japandashboard) centralize visualization and policy promotion.
  • Statistics: e-Stat dashboard (https://dashboard.e-stat.go.jp/) exposes many stats and an API — good!
  • Local: ministry push on standardizing municipal core systems (https://www.digital.go.jp/policies/local_governments and https://www.soumu.go.jp/...) and concrete municipality evaluations like Sukagawa's report show grant usage and KPI reviews.

These are solid building blocks, but trust me — engineers look at file formats first.

Machine-readability: PDFs vs CSV/JSON

This is the heart of friction. KPI reports, grant results, and sometimes even dashboards publish final PDFs. This means:

  • No easy automation to track time series across municipalities.
  • Extra ETL burden: OCR, table extraction (tabula/camelot) and error-prone transformations.

Practical pattern: insist on both human-friendly PDF and machine-first CSV/JSON with a published JSON Schema or CSVW metadata file.

API and schema hygiene

  • e-Stat has APIs — great example. But many other inventories are ad-hoc or behind legacy local systems.
  • Standardization effort exists (soumu PMO tool listing progress), but we need: OpenAPI specs, consistent auth (OpenID Connect), rate limits, and versioning.

KPI vs Reality

Look at Digital Garden City grant guidance (https://www.chisou.go.jp/...) and municipal evaluations (e.g., Sukagawa). The KPI documents list targets, but automated validation is rare. That creates gaps between policy intent and measurable outcomes.

Concrete tech fixes (engineering playbook)

  • Publish machine-readable KPIs: time-series JSON or CSV with metadata (columns, units, update cadence).
  • OpenAPI for every public API; example minimal OpenAPI: provide /kpi/{municipality}/{metric} returning JSON timeseries.
  • Use CSVW or JSON Schema; provide a Data Package (Frictionless Data) for each dataset.
  • Offer sample ETL and validation tooling in GitHub for municipal use.

Code snippet: fetch e-Stat-like JSON and load into pandas

import requests

import pandas as pd

r = requests.get('https://api.e-stat.go.jp/rest/3.0/app/json/getStatsData', params={'appId':'YOUR_KEY','...': '...'})

data = r.json()

normalize to table

df = pd.json_normalize(data['GET_STATS_DATA']['STATISTICAL_DATA']['DATA_INF'])

print(df.head())

For PDF table extraction, recommend Camelot or tabula-py as temporary bridge, but push upstream publishers to CSV/JSON.

Implementation roadmap (high level)

  • Mandate machine-readable KPIs for grant-funded projects.
  • Create reference OpenAPI + JSON Schema templates and a validation CI for datasets.
  • Fund a "data migration kit" for municipalities (containerized ETL, docs, training).
  • Integrate KPI endpoints into Japan Dashboard and e-Stat so progress is automatically tracked.

まとめ

  • Japan has strong institutions and some APIs, but inconsistent formats (PDFs) and fragmented municipal systems limit automation.
  • Fix: require CSV/JSON + schema, publish OpenAPI, provide tooling and training.
  • Outcome: faster, auditable policy monitoring, more civic-tech innovation, and less manual scraping — win-win.

おかむーから一言

I’ve built startups and shipped gov-tech — this is doable. Give devs clean data and clear contracts (APIs + schemas), and they'll build the accountability layer policymakers actually need!