インストール手順

パッケージのインストール

pip コマンドでインストールできます。

(.venv) $ pip install jageocoder

バージョンを指定したい場合は == に続けてバージョン番号を指定してください。

(.venv) $ pip install jageocoder==2.0.0

住所辞書データベースファイルのインストール

住所辞書は ` zip 形式でダウンロード可能です。最新の 辞書データファイル一覧 から、必要な地域を含むものを選択してダウンロードしてください。

住所辞書は jageocoder のバージョンによってフォーマットが異なるため、 v1 用のファイルは利用できません。v2.0 に対応する住所辞書データベースファイルは 末尾が _v20.zip です。

(.venv) $ jageocoder download-dictionary https://www.info-proto.com/static/jageocoder/latest/v2/jukyo_all_v20.zip

注意 住所辞書ファイルは圧縮した状態でもファイルサイズが大きいため、 ダウンロード・インストールには時間がかかります。

次にダウンロードした zip ファイルをインストールします。

(.venv) $ jageocoder install-dictionary jukyo_all_v20.zip

アンインストール手順

jageocoder をアンインストールする場合、先に辞書データベースを削除してください。 辞書データベースの場所が分かっている場合はそのディレクトリごと 削除しても構いませんが、 uninstall-dictionary コマンドを 利用すると簡単に削除できます。

(.venv) $ jageocoder uninstall-dictionary

その後、 jageocoder パッケージを pip でアンインストールしてください。

(.venv) $ pip uninstall jageocoder

住所辞書データベースディレクトリを指定する

住所辞書データベースは、特に指定しない場合 Python 環境内に作成されます （参考： 住所辞書ディレクトリの取得）。

このデータベースは数GBのサイズがあるため、複数の Python 環境で jageocoder を利用する際などには共用したいことがあります。そのような場合には、環境変数 JAGEOCODER_DB2_DIR をセットすると、 住所辞書データベースのディレクトリを指定することができます。

(.venv) $ export JAGEOCODER_DB2_DIR=$HOME/jageocoder/db2
(.venv) $ jageocoder get-db-dir
/home/sagara/jageocoder/db2

ただし jageocoder のバージョンは住所辞書に合わせてください。