Code-Driven Manifesto: Inspecting Japan's Local Government Data and Systems

どうも〜おかむーです! Hey — okamu here! Today we're digging into Japan's local-government data ecosystem from an engineer's lens. Code talks, so let's listen.
- Local governments publish a mix of CSVs and PDFs, but machine-readability is inconsistent.
- National efforts (Digital Agency / Ministry of Internal Affairs) push standardization and cloud migration, yet legacy systems and formats remain barriers.
- Practical wins: simple CSV+API standards, encoding rules, and CI-driven schema checks would unlock reuse and transparency.
結論
The policy direction is right: centralize standards and migrate to a government cloud (see Digital Agency / Digitalization pages at https://www.digital.go.jp/ and https://www.soumu.go.jp/). But on the ground, data format heterogeneity (Shift_JIS CSVs, PDFs, ad-hoc HTML) and lack of consistent APIs mean engineers still spend days wrangling encodings and scraping instead of building services. 要するに、政策はあるけど“コードで検証できる形”にまだなっていないということです。
Report
What I found (concrete sources)
- Gov pages on system standardization and cloud migration: https://www.digital.go.jp/policies/local_governments and https://www.soumu.go.jp/menu_seisaku/chiho/jichitaijoho_system/index.html — these contain strategy and legal background for standardization.
- Published CSVs and datasets: e.g. https://notice.go.jp/docs/status_notice.csv, https://www.soumu.go.jp/main_content/000323625.csv and various ministry CSVs (env.go.jp, mhlw.go.jp). These are great — machine-readable when they exist!
- Examples of public sites with rich UX but limited APIs: https://www.keiba.go.jp/ (local horse-racing info) provides live pages and schedule views, but no obvious open API for third-party reuse.
Technical pain points
- Encoding hell: many gov CSVs use Shift_JIS/CP932. Code folks know this — read_csv(..., encoding='cp932') is often required. 要するに、文字化け対策必須です。
- Mixed formats: KPIs and progress often buried in PDFs (see grant results PDF: https://www.pref.yamaguchi.lg.jp/uploaded/attachment/160746.pdf). PDF-first means programmatic monitoring is hard.
- No unified API schema: different municipalities expose similar concepts with different column names and structures. That kills automation.
Quick reproducible snippets
- Fetch a CSV and normalize encoding (Python/pandas):
import pandas as pd
url = 'https://www.soumu.go.jp/main_content/000323625.csv'
df = pd.read_csv(url, encoding='cp932')
normalize column names
df.columns = df.columns.str.strip().str.lower().str.replace(' ', '_')
print(df.head())
- PDF -> CSV pipeline (when only PDF is available): use tabula-py or tika + a small QA step to validate numeric KPIs.
Evaluation vs policy goals
Policies aim to standardize core systems and migrate to gov cloud by 2025/2026. That's good for security and ops. But I found gaps:
- KPI publication: grants and project KPIs exist (PDFs mention KPI usage) but machine-readable trend data is rare. You can't easily chart progress across municipalities.
- Openness vs procurement: procurement practices and legacy vendors risk vendor lock-in; standard APIs and open schemas reduce this.
Concrete engineering proposals
Potential impact
- Faster civic apps, better transparency, automated audit dashboards.
- Easier cross-municipality comparisons and evidence-based policy adjustments.
- Lower long-term operational costs via shared components and gov cloud standard images.
まとめ
The technical story is simple: policies and strategy are in place, and useful machine-readable datasets already exist, but inconsistent formats, encodings, and PDF-first reporting block real reuse. エンジニア的に言うと、API一本とUTF-8一貫化で世界が変わりますよ!
おかむーから一言
I've built products and startups on messy data—standardization isn't sexy, but it's the scaffolding for real impact. Let's push for schemas, CI checks, and an API-first mindset so civic data actually powers services people use.
Sources
- https://www.keiba.go.jp/
- https://www.digital.go.jp/policies/local_governments
- https://www.keiba.go.jp/KeibaWeb/TodayRaceInfo/TodayRaceInfoTop
- https://www.soumu.go.jp/menu_seisaku/chiho/jichitaijoho_system/index.html
- https://www.keiba.go.jp/live/
- https://notice.go.jp/docs/status_notice.csv
- https://www.env.go.jp/content/900398071.csv
- https://www.inpit.go.jp/content/100869372.csv
- https://www.mhlw.go.jp/content/001682075.csv
- https://www.soumu.go.jp/main_content/000323625.csv
- https://ja.wikipedia.org/wiki/%E3%83%87%E3%82%B8%E3%82%BF%E3%83%AB
- https://www.chisou.go.jp/sousei/about/kouhukin/index.html
- https://www.digital.go.jp/
- https://www.pref.yamaguchi.lg.jp/uploaded/attachment/160746.pdf
- https://biz.kddi.com/content/column/smartwork/what-is-digital/
Share
Related Reports

Code-driven Manifesto: Auditing Local Gov Data and Systems (Kagawa case study)
Local gov systems run but hide data behind UIs; expose CSV/JSON, APIs, and common schemas to unlock value.

Code-driven Check: Japan’s Open Data and the Machine-Readable Gap
Digital Japan has dashboards and rules, but PDFs and messy formats still block automated policy verification; mandate CSV/JSON, APIs, and dataset linting.

Code Speaks: Testing Japan's Gov Data and Dashboards
Japan has great dashboards but inconsistent machine-readability. This report inspects e-Stat, Japan Dashboard, Kantei PDFs, and proposes API-first fixes and practical code examples.