住所 API

認証なしで使えます。どのサイトからも読めます(CORS)。無いときは 404、エラーは application/problem+json(RFC 9457)で返します。仕様(OpenAPI): openapi.json

緯度経度 → 一番近い町字

curl 'https://api.hasami.uk/geo/towns/nearest?lat=35.681236&lon=139.767125'

limit(1〜10)で、近い順に複数返せます。町字の代表点のうち一番近いものなので、境界の近くでは隣の町字になることがあります。

郵便番号 → 住所の候補

curl 'https://api.hasami.uk/geo/zipcodes/1000005'          # 7 桁。無ければ 404
curl 'https://api.hasami.uk/geo/zipcodes?prefix=100'      # 先頭 3〜6 桁で前方一致

町域と同じ名前の町字があれば、その代表点(location)も付けます。

町字 1 つ

curl 'https://api.hasami.uk/geo/towns/131016-0011001'     # 全国地方公共団体コード-町字 ID

旧 URL(/geo/zip/?code=、/geo/reverse/?lat=&lon=)は 308 で新しい URL に転送します(curl は -L を付けてください)。

出典:デジタル庁 アドレス・ベース・レジストリ(CC BY 4.0)を加工して作成/日本郵便 郵便番号データ。結果を表示するときは出典を表示してください。