Expand description
§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 japan_reverse_geocoder::Geocoder;
let geocoder = Geocoder::new();
// 最近傍1件(東京駅の座標)
let result = geocoder.reverse_geocode(35.6812, 139.7671).unwrap();
println!(
"{}{}{} (代表点まで{:.0}m)",
result.address.prefecture, // "東京都"
result.address.city, // "千代田区"
result.address.town, // "丸の内一丁目"
result.distance_meters
);
// 近い順に5件
for r in geocoder.nearest(35.6812, 139.7671, 5).unwrap() {
println!("{}{} {:.0}m", r.address.city, r.address.town, r.distance_meters);
}
// 半径500m以内
for r in geocoder.within_radius(35.6812, 139.7671, 500.0).unwrap() {
println!("{}{} {:.0}m", r.address.city, r.address.town, r.distance_meters);
}Addressには住所文字列のほか、都道府県コード(JIS X 0401)、市区町村コード(JIS X 0402)、大字町丁目コード(12桁)、代表点座標が含まれます。
§インストール
[dependencies]
japan-reverse-geocoder = "0.1"データを同梱しない軽量構成(実行時にデータファイルを読み込む場合):
[dependencies]
japan-reverse-geocoder = { version = "0.1", default-features = false }let geocoder = Geocoder::from_path("isj.bin")?;データファイル(isj.bin)はGitHub Releasesから取得するか、tools/build-dataで生成できます。
§精度に関する注意
位置参照情報は各大字・町丁目の代表点(ポリゴンではない)のデータです。検索結果は「代表点が最も近い町丁目」であり、厳密に「その座標を含む町丁目」とは限りません。町丁目の境界付近では隣の町丁目が返ることがあります。
- 対応範囲は日本のメッシュ範囲(北緯20〜46度、東経122〜154度)です。範囲外の座標はエラーになります
- 範囲内の海上の座標では、最寄りの陸上の町丁目が返ります
- 距離はHaversine公式による大円距離(メートル)です
§データの更新
同梱データは位置参照情報の年度版に追従して更新します(データ更新のみの場合はパッチリリース)。収録データのバージョンはgeocoder.data_version()で取得できます。
自分でデータを再生成する場合:
# 1. 位置参照情報(大字・町丁目レベル)の全国CSVを data/raw/extracted/ に展開
# 2. 変換ツールを実行
cargo run -p build-data --release -- data/raw/extracted data/isj.bin "19.0b"§外部ジオコーディング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/)を加工して作成したものです。データの利用にあたっては国土数値情報・位置参照情報の利用約款に従ってください(出典の明記により商用利用・再配布が可能です)。
Structs§
- Address
- 大字・町丁目の住所情報
- Geocoder
- 逆ジオコーディングエンジン
- Reverse
Geocode Result - 逆ジオコーディングの結果
Enums§
- Error
- このライブラリのエラー型