MICHILU（ミチル）
不動産のための道路情報チェック。住所を入れると、その市の公式「建築基準法上の道路」図を物件の場所で開きます（関東1都6県 全316市区町村に対応）。ネットで分からない市は問い合わせ先を案内します。地番での検索と、その地点の用途地域・建ぺい率・容積率・防火地域などの都市計画（国土交通省のデータ）も出します。
動かす
npm install
npm run dev # http://localhost:3000
npm test # ロジックのユニットテスト
npm run check-links # 全地図リンクが開けるか確認（ネット接続が必要。毎週 GitHub Actions でも実行）
npm run watch-sheets # PDF の図の差し替え（ファイル名の変更）を追い、データの URL を書き換える（同上）
npm run discover-maps # 市区町村が新しく公開した道路の地図を探して discover-report.md に書く（同上）
PARCEL_LIVE=1 npx vitest run lib/roadmap/parcel-live.test.ts # 地番検索を本物のデータで確かめる
ROAD_LIVE=1 npx vitest run lib/roadmap/road-read-live.test.ts # 道路種別の読み取りを本物の地図データで確かめる
npm run legends # 道路種別の地図の凡例（色 → 種別）を読み直して data/legends.json を作り直す（Pillow が要る）
npm run build # 静的サイトを out/ に書き出す（Vercel 等にそのまま置ける）
構成
| パス | 中身 |
|---|
lib/roadmap/ | コアロジック。lookup(address) を呼ぶだけで、地図URL・公開レベル・問い合わせ先が返る |
lib/roadmap/data/ | 都道府県ごとの市町村データ。vendors.ts が地図システムごとのURL形式 |
app/page.tsx, components/ | 画面（ホーム・結果・使い方・対応市一覧）。PC は地図が中心（desktop-shell.tsx）、動く地図は live-map.tsx（MapLibre GL） |
lib/roadmap/parcel.ts, parcel-tiles.ts | 地番検索（登記所備付地図データの筆のタイルを読む）。置き場所は data/parcel-source.json |
scripts/parcel-tiles/ | 地番の地図データの最新版を作るスクリプト（.github/workflows/parcel-tiles.yml から使う） |
lib/roadmap/zoning.ts, zoning-tiles.ts | 地点の都市計画（用途地域・建ぺい率・容積率・防火など）。タイルは public/data/、置き場所は data/zoning-source.json、市区町村ごとのデータの有無と時点は data/zoning-status.json |
scripts/zoning-tiles/ | 都市計画のタイルを国土交通省の全国データから作るスクリプト（.github/workflows/zoning-tiles.yml が毎月更新を確かめる） |
lib/roadmap/legends.ts | 道路種別の地図の凡例（線の色 → 種別）を文字で出す。データは data/legends.json（scripts/legends/build.py で作る） |
lib/roadmap/road-read.ts | 市の道路種別の地図データ（公開の ArcGIS レイヤ）を読み、物件のまわりの道路の種別・方角・距離を出す（埼玉県の20町・行田市・つくば市） |
lib/history.ts | 直近5件の検索履歴（端末の localStorage のみ） |
docs/features.md | UIの機能要件 |
docs/saitama-research.md, docs/chiba-research.md, docs/kanagawa-research.md, docs/tokyo-research.md, docs/kanto-north-research.md | 市区町村ごとの調査結果と出典 |
ロジックの使い方
画面からは @/lib/roadmap の lookup を呼ぶ。戻り値は status で3分岐する:
const r = await lookup("埼玉県越谷市越ヶ谷4-2-1");
if (r.status === "ok") {
r.matchedAddress; // 国土地理院が解釈した住所
r.municipality.coverage; // "full" | "partial" | "none"
r.links; // [{ label, url, kind, pinpoint }]
r.municipality.contact; // { dept, phone, email, hours, note, noPhoneInquiry }
} else if (r.status === "unsupported") {
// 未対応の市町村
} else {
// not_found: 住所が見つからない
}
/?q=住所 で開くと、その住所を検索した状態で表示される（ホーム画面に追加したショートカットや共有に使える）。
住所は国土地理院APIにブラウザから直接送る（自前サーバーなし）。道路種別を読める市町では、物件の緯度経度をその市の地図サービス（ArcGIS）へブラウザから直接送る。
