日本の住所入力・名寄せのための API
郵便番号から町域まで補完し、JIS X 0402 の市区町村コード付きで返します。表記ゆれの正規化と、Google Geocoding 互換の乗り換え経路も備えています。
こんなときに使えます
自前の住所マスターをやめる
町域テーブルを自前で保守する代わりに、入力時は郵便番号ルックアップで補完し、保存キーは
JIS X 0402 の municipality_code +
住所文字列にします。市区町村合併への追従は 旧住所変換エンドポイントに任せられます。
使うエンドポイント: GET /api/v1/address/postal/{postal_code},
POST /api/v1/address/convert-legacy
表記ゆれの正規化・名寄せ
フォーム入力や CRM データの住所表記のばらつきを、単件・バッチ（最大100件）で正規化し、 入力チェックまで行います。
使うエンドポイント: POST /api/v1/address/normalize,
POST /api/v1/address/batch,
POST /api/v1/address/validate
Google Geocoding からの乗り換え
クエリ・レスポンス形を Google Geocoding API に合わせた互換エンドポイントがあるので、 呼び出し先 URL の差し替えから移行を始められます。
使うエンドポイント: GET /api/v1/google-compat/geocode/json,
GET /api/v1/google-compat/reverseGeocode/json,
GET /api/v1/google-compat/details/json
データについて
- 出典は日本郵便 ken_all（小書き）。更新は月次で手動適用しています。
- 郵便番号 120,682 件・町域レコード 124,512 件・全 47 都道府県を収録しています。
-
約3%の郵便番号は複数の町域にまたがり、県をまたぐケースもあります。
GET /api/v1/address/postal/{postal_code}のcandidates配列で該当する町域を全件返します。 -
収録元・スナップショット日・件数は
GET /v1/metadata/datasetで確認できます（認証不要）。