Skip to main content

Crate japan_reverse_geocoder

Crate japan_reverse_geocoder 

Source
Expand description

§japan-reverse-geocoder

Crates.io Documentation License

日本国内の座標(緯度・経度)から大字・町丁目レベルの住所を検索する、オフライン動作の逆ジオコーディングライブラリです。

国土交通省「位置参照情報」(大字・町丁目レベル、全国約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)ライブラリ。本クレートの空間インデックスに使用

§ライセンス

§コード

以下のいずれかのライセンスを選択できます:

§同梱データ

同梱データは国土交通省「位置参照情報(大字・町丁目レベル)」(https://nlftp.mlit.go.jp/isj/)を加工して作成したものです。データの利用にあたっては国土数値情報・位置参照情報の利用約款に従ってください(出典の明記により商用利用・再配布が可能です)。

Structs§

Address
大字・町丁目の住所情報
Geocoder
逆ジオコーディングエンジン
ReverseGeocodeResult
逆ジオコーディングの結果

Enums§

Error
このライブラリのエラー型