Skip to content

Latest commit

 

History

History
93 lines (63 loc) · 4.93 KB

README.md

File metadata and controls

93 lines (63 loc) · 4.93 KB

Community Geocoder

オープンソースのジオコーディング API です。

経産省の IMI コンポーネントツールのジオコーディングの仕組みからインスピレーションをうけて開発しました。

デモ: https://geolonia.github.io/community-geocoder/

特徴

  • 国土交通省の位置参照情報の「大字・町丁目レベル位置参照情報」を利用したジオコーディングサービスです。
    • JavaScript API と緯度経度の API を提供しています。
  • API は GitHub ページで静的ファイルとしてホストしています。
  • ソースコードのライセンスは MIT ライセンスです。取得した位置情報のご利用はご自由にどうぞ。

経産省の IMI コンポーネントツール でも同じレベルの精度のジオコーディングが可能ですが、IMI コンポーネントツールは、自力で Node.js サーバーをホストする必要があります。

本プロジェクトは、GitHub ページ上に静的ファイルとしてジオコーディング用の API をホストしているため、独自のサーバーを用意しなくても利用することができます。

仕組み

経産省の IMI コンポーネントツール では、住所をコードに変換し、levelDB というキーバリューストア内でそのコードを検索することにより緯度経度を取得しています。

このプロジェクトではその仕組を応用して、キーバリューストアではなくスタティックなファイルとすることで API を実装して、クライアントから使いやすくしました。

  • 「東京都千代田区霞が関1-3-1」のような住所を受け取ると、この住所を分解し、IMI コンポーネントツールからフォークしたライブラリで「大字町丁目コード」を取得します。
  • このコードは、「131010002001」のような12桁の数字になっており、API 上にある同名の JSON ファイルにアクセスすることで、その中に記述されている緯度経度を取得しています。
  • API 内には、膨大な量のファイルが存在するため、都道府県コード/市町村コード/大字町丁目コード.json のようなディレクトリ構造とすることで、ファイルシステムの制限を回避しています。

使い方

以下の JavaScript API をウェブページから読み込んでください。

<script src="https://community-geocoder.geolonia.com/api.js"></script>

API 関数 getLatLng() を任意のクリックイベント等でコールしてください。

document.getElementById('exec').addEventListener('click', () => {
  if (document.getElementById('address').value) {
    getLatLng(document.getElementById('address').value, (latlng) => {
      map.setCenter(latlng)
    })
  }
})

getLatLng(address, callback, errorCallback)

  • address - 緯度経度を取得したい住所の文字列
  • callback - 緯度経度を取得したあとで実行したいコールバック関数。コールバック関数の第一引き数には緯度経度のオブジェクトが渡されます。
  • errorCallback - エラー時のコールバック関数。エラーオブジェクトが引き数として渡されます。

コールバック関数に引き数として渡される緯度経度のオブジェクトは以下のようになっています。

{
  addr: "大阪市中央区xxx"
  lat: 35.1234.
  lng: 135.1234
}

注意

  • このジオコーディングは、「大字町丁目」までを対象としているため、それほど精度が高いものではありません。また、住所のみに対応しておりランドマーク等からの緯度経度の取得には対応していません。
  • Geolonia では、ElasticSearch を利用したジオコーディング API を別途提供する予定ですので、もうすこし高い精度のジオコーディングサービスが必要な場合はもうしばらくお待ち下さい。

メンテナンス方法

まず、以下のコマンドで環境を用意してください。

$ git clone git@github.com:geolonia/community-geocoder.git
$ cd community-geocoder
$ npm install

JavaScript API の開発方法

src/api.js がこのサービスで提供される JavaScript API のソースです。 以下のコマンドでブラウザで確認しながら作業できます。

$ npm start
$ npm run build

タイルのメンテナンス方法

  • ./data ディレクトリに国土交通省の位置参照情報の「大字・町丁目レベル位置参照情報」からダウンロードしたすべての .zip ファイルを置いてください。
  • npm run build:api を実行してください。