郵便住所ラボ

1. 郵便番号は文字列のまま保持し、先頭の0を落としません。7桁は索引で完全一致、3〜6桁は番号順の前方一致検索です。
2. 住所は全角・半角、ひらがな・カタカナ、数字付近のハイフンを検索用に揃えます。漢数字は丁目・条・番・号などの文脈で変換し、四日市などの固有名詞は保ちます。
3. 都道府県・市区町村を前方から認識し、その地域の町域を照合します。都道府県や郡の省略も候補検索に対応。同名地名や区名だけの入力では複数候補を残します。
4. 単純な丁目の一覧・範囲、ビルの階数、数字だけで列挙された番地条件を照合します。「その他」は同じ町域の全例外が単純な番地列挙で、すべての判定が終わった場合のみ確定します。複雑な番地範囲や除外条件、京都の通り名などは確認を求めます。
5. 番地・建物・部屋番号は郵便番号データから実在を検証できません。「町域一致」は完全な住所確認を意味しません。旧住所の時系列変換、曖昧な誤字の自動修正、緯度経度の推定は行いません。

「候補が1件」と「条件を満たすことを確認できた」は別です。未掲載町域用の番号や事業所番号を、一般の町域番号として自動確定しない設計です。

• 条件を調べる前に最長の町域を保持します。「港区芝浦9丁目」は「芝」や近隣事業所へ戻さず、condition_mismatch と収録条件を返します。「未掲載町域用」の番号にも自動で置き換えません。
• 約2.2万件の事業所名の正規化を初期読み込み時にまとめ、検索ごとの重複処理を除きました。
• 名称の先頭・末尾の「株式会社」等の省略は、独立した要確認候補として照合します。支社・営業所名は消しません。
• 名駅の「1-1-8」と「1-1-80」を数字の成分ごとに区別。未完成の数字列、枝番と部屋番号を区別できない場合、丁目や番の位置がおかしい場合は確定しません。

同じNode.js環境・同じ公式データで各入力を2回実行した後、9回の中央値を比較（2026 09 07）。エンジン内の処理時間で、初回準備と画面描画は含みません。ブラウザー・スマホでの速度は未測定です。候補条件の修正も含むため、すべての検索で結果件数が同一という意味ではありません。

2026 09 07、検索エンジン47項目とデータ処理9項目をNode.js上で検証。全142,912種類の郵便番号について、候補数が元データの行数と一致することを照合しました。

全角・先頭ゼロ、町域の複数候補、芝の丁目条件、実在町域「一円」、地下と地上階、ビル名の前に番地がある住所、カナ入力、郵便番号と住所の矛盾、ZIPのCRC、Shift-JIS事業所データ、取込失敗時のデータ保持、圧縮書き出しを検証しています。未知の住所表記を含む網羅的な精度保証ではありません。

このHTML内でデータ準備完了後、非同期APIを利用できます。PostalResolver.ready を待ち、PostalResolver.search() を呼びます。返り値には全件数・郵便番号の種類数・判定・注意・候補配列が含まれます。

await PostalResolver.ready;
const answer = await PostalResolver.search('東京都港区芝4丁目1-1', {
  mode: 'auto', pref: '', business: true, limit: 60
});
// answer.state / answer.total / answer.notes / answer.results
// 郵便番号は answer.results[i].zip（文字列）
// 次のページ: { offset: 60, limit: 60 }

本体：自作JavaScript、依存パッケージなし。Web Workerで検索し、圧縮はブラウザー標準機能を使用。最近のChrome / Edge / Safari / Firefox向け。全国データのため初回展開に数秒かかる場合があります。