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）へブラウザから直接送る。