japan-reverse-geocoder
日本国内の座標(緯度・経度)から大字・町丁目レベルの住所を検索する、オフライン動作の逆ジオコーディングライブラリです。
国土交通省「位置参照情報」(大字・町丁目レベル、全国約19万件)を圧縮データとして同梱しており、cargo addするだけでネットワーク不要・外部API不要で動作します。
出典: 国土交通省「位置参照情報(大字・町丁目レベル)」(https://nlftp.mlit.go.jp/isj/)を加工して作成
特徴
- オフライン動作: 全国データ同梱。外部APIへの通信なし
- APIキー不要・無料: Google MapsなどのジオコーディングAPIと異なり、利用登録・レート制限・従量課金なしで緯度経度(座標)から住所を検索できます
- 高速: jismeshcodeの2次メッシュ(約10km)で空間インデックスを構築し、1クエリ数十μsオーダー
- 3つの検索API: 最近傍1件 / 近い順k件 / 半径内列挙
- 軽量な依存: 依存クレートは
jismeshcodeとminiz_oxide(pure Rust)のみ
使い方
use Geocoder;
let geocoder = new;
// 最近傍1件(東京駅の座標)
let result = geocoder.reverse_geocode.unwrap;
println!;
// 近い順に5件
for r in geocoder.nearest.unwrap
// 半径500m以内
for r in geocoder.within_radius.unwrap
Addressには住所文字列のほか、都道府県コード(JIS X 0401)、市区町村コード(JIS X 0402)、大字町丁目コード(12桁)、代表点座標が含まれます。
インストール
[]
= "0.1"
データを同梱しない軽量構成(実行時にデータファイルを読み込む場合):
[]
= { = "0.1", = false }
let geocoder = from_path?;
データファイル(isj.bin)はGitHub Releasesから取得するか、tools/build-dataで生成できます。
精度に関する注意
位置参照情報は各大字・町丁目の代表点(ポリゴンではない)のデータです。検索結果は「代表点が最も近い町丁目」であり、厳密に「その座標を含む町丁目」とは限りません。町丁目の境界付近では隣の町丁目が返ることがあります。
- 対応範囲は日本のメッシュ範囲(北緯20〜46度、東経122〜154度)です。範囲外の座標はエラーになります
- 範囲内の海上の座標では、最寄りの陸上の町丁目が返ります
- 距離はHaversine公式による大円距離(メートル)です
データの更新
同梱データは位置参照情報の年度版に追従して更新します(データ更新のみの場合はパッチリリース)。収録データのバージョンはgeocoder.data_version()で取得できます。
自分でデータを再生成する場合:
# 1. 位置参照情報(大字・町丁目レベル)の全国CSVを data/raw/extracted/ に展開
# 2. 変換ツールを実行
外部ジオコーディングAPIとの使い分け
Google Maps Geocoding APIや国土地理院APIなどの外部サービスは番地・建物レベルの精度やポリゴン判定が得られる一方、通信・APIキー・レート制限・利用料が伴います。本クレートは「大字・町丁目レベルの住所がオフラインで即座に引ければ十分」なケース(大量データのバッチ処理、位置情報ログの集計、ネットワークが使えない環境など)に向いています。
関連クレート
- jismeshcode — 日本標準地域メッシュコード(JIS X 0410)ライブラリ。本クレートの空間インデックスに使用
ライセンス
コード
以下のいずれかのライセンスを選択できます:
- Apache License, Version 2.0 (LICENSE-APACHE)
- MIT license (LICENSE-MIT)
同梱データ
同梱データは国土交通省「位置参照情報(大字・町丁目レベル)」(https://nlftp.mlit.go.jp/isj/)を加工して作成したものです。データの利用にあたっては国土数値情報・位置参照情報の利用約款に従ってください(出典の明記により商用利用・再配布が可能です)。