{"title":"GeoDjango のインストール","version":"5.1","locale":"ja","docname":"ref/contrib/gis/install/index","url":"/ja/5.1/ref/contrib/gis/install/","canonical":"https://djangodocs.dev/ja/5.1/ref/contrib/gis/install/","summary":"概要 Link to this heading # 通常、GeoDjango のインストールには次のものが必要です: Python と Django 空間データベース (Spatial database) 地理空間ライブラリのインストール…","html":"

GeoDjango のインストールLink to this heading#

\n
\n

概要Link to this heading#

\n

通常、GeoDjango のインストールには次のものが必要です:

\n
    \n

  1. Python と Django

    2. \n

  2. 空間データベース (Spatial database)

    3. \n

  3. 地理空間ライブラリのインストール

    4. \n
\n

各要件の詳細とインストール手順については、以下のセクションを参照してください。また、プラットフォーム別の手順もあります:

\n\n\n
\n
\n

必要条件Link to this heading#

\n
\n

Python と DjangoLink to this heading#

\n

GeoDjango は Django に同梱されていますので、インストール方法の詳細は Django の インストール手順 を参照してください。

\n
\n
\n

空間データベース (Spatial database)Link to this heading#

\n

現在サポートされている空間データベースは、PostgreSQL (with PostGIS)、MySQL、Oracle、SQLite (with SpatiaLite) です。

\n\n

GeoDjango のインストールに必要な地理空間ライブラリは、使用する空間データベースによって異なります。以下は、サポートされているデータベースバックエンドごとに、必要なライブラリ、サポートされているバージョン、および注意事項 の一覧です:

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

データベース

ライブラリの要件

サポートされるバージョン

備考

PostgreSQL

GEOS, GDAL, PROJ, PostGIS

13+

PostGIS が必要です。

MySQL

GEOS, GDAL

8.0.11+

機能制限があります 。

Oracle

GEOS, GDAL

19+

XE not supported.

SQLite

GEOS, GDAL, PROJ, SpatiaLite

3.31.0+

Requires SpatiaLite 4.3+

\n
\n

PostgreSQL/PostGIS/GEOS/GDAL の可能な組み合わせについては、OSGeo Wikiの this comparison matrix も参照してください。

\n
\n
\n
\n

インストールLink to this heading#

\n
\n

地理空間ライブラリ (Geospatial library)Link to this heading#

\n
\n\n
\n
\n
\n

データベースのインストールLink to this heading#

\n
\n\n
\n
\n
\n

DATABASES の設定Link to this heading#

\n

ENGINE 設定を、空間 (spatial) バックエンド の1つに設定してください。

\n
\n
\n

django.contrib.gis を INSTALLED_APPS に追加します。Link to this heading#

\n

他の Django contrib アプリケーションと同様に、設定の INSTALLED_APPS に django.contrib.gis を追加するだけです。これは gis テンプレートを配置するためです。そうしないと、地理管理や KML サイトマップのような機能が正しく動作しません。

\n
\n
\n
\n

トラブルシューティングLink to this heading#

\n

問題の解決策がここに見つからない場合は、コミュニティに参加してみてください！以下のようなことができます:

\n\n
\n

ライブラリの環境設定Link to this heading#

\n

GeoDjango をインストールする際に最もよくある問題は、外部の共有ライブラリ (例えば GEOS や GDAL) が見つからないというものです [1] 。通常、この問題の原因は、オペレーティングシステムがソースからビルドされたライブラリがインストールされたディレクトリを認識していないことです。

\n

通常、ライブラリのパスは、個々のユーザーごとに環境変数を設定するか、システム全体のライブラリ パスを構成することで設定できます。

\n
\n

LD_LIBRARY_PATH 環境変数Link to this heading#

\n

ユーザーは、使用するライブラリパスをカスタマイズするためにこの環境変数を設定できます。ソースからビルドされたソフトウェアの典型的なライブラリディレクトリは /usr/local/lib です。したがって、 LD_LIBRARY_PATH 変数に /usr/local/lib を含める必要があります。たとえば、ユーザーは次のような設定を bash プロファイルに記述できます:

\n
Shell
export LD_LIBRARY_PATH=/usr/local/lib\n
\n
\n
\n

システムライブラリのパスを設定するLink to this heading#

\n

通常、GNU/Linuxシステムでは、 /etc/ld.so.conf にファイルがあり、別のディレクトリにあるファイルから追加のパスを含むことがあります。そのディレクトリとは、例えば /etc/ld.so.conf.d です。root ユーザーとして、 ld.so.conf の新しい行にカスタムライブラリパス (例: /usr/local/lib など) を追加してください。これはその 一つ の例です:

\n
Shell
$ sudo echo /usr/local/lib >> /etc/ld.so.conf\n$ sudo ldconfig\n
\n

OpenSolaris ユーザーは、crle ユーティリティを使ってシステムライブラリのパスを変更できます。オプションなしで crle を実行すると現在の設定が表示され、 crle -l を使用すると新しいライブラリパスが設定されます。システムライブラリパスを変更する際には、 非常に 注意してください:

\n
Shell
# crle -l $OLD_PATH:/usr/local/lib\n
\n
\n
\n

binutils をインストールするLink to this heading#

\n

GeoDjango は find_library 関数 (ctypes.util Python モジュールのもの) を使ってライブラリを検出します。 find_library ルーチンは objdump というプログラム (binutils パッケージの一部) を使って、GNU/Linux システム上の共有ライブラリを確認します。そのため、もし binutils が Linux システムにインストールされていない場合、ライブラリパスが正しく設定され、地理空間ライブラリが完璧にビルドされていたとしても、Python の ctypes はライブラリを見つけることができないかもしれません。

\n

binutils パッケージは、Debian および Ubuntu システムでは以下のコマンドを使用してインストールできます:

\n
Shell
$ sudo apt-get install binutils\n
\n

Red Hat および CentOS システムでも同様です:

\n
Shell
$ sudo yum install binutils\n
\n
\n
\n
\n
\n

プラットフォーム固有の手順Link to this heading#

\n
\n

macOSLink to this heading#

\n

macOS では様々なパッケージングシステムが利用できるため、ユーザは GeoDjango をインストールするのにいくつかの異なる選択肢があります。これらのオプションは以下の通りです:

\n\n

このセクションには、Python Software Foundation が提供するパッケージから Python のアップグレード版をインストールする手順も含まれていますが、これは必須ではありません。

\n
\n

PythonLink to this heading#

\n

macOSにはPythonがインストールされていますが、Python Software Foundation が提供する framework installers を使用することもできます。インストーラーを使用する利点は、macOSのPythonがOS内部で使用するために "原始的" なままであることです。

\n\n
\n
\n

Postgres.appLink to this heading#

\n

Postgres.app は PostGIS 拡張を含むスタンドアロンの PostgreSQL サーバです。また、gdal と libgeoip を Homebrew と共にインストールする必要があります。

\n

Postgres.appをインストールした後、コマンドラインからパッケージのプログラムを実行できるように、 .bash_profile に以下を追加してください。 X.Y をインストールした Postgres.app の PostgreSQL のバージョンに置き換えてください:

\n
Shell
export PATH=$PATH:/Applications/Postgres.app/Contents/Versions/X.Y/bin\n
\n

ターミナルプロンプトで which psql と入力して、パスが正しく設定されているかを確認できます。

\n
\n
\n

HomebrewLink to this heading#

\n

Homebrew は、ソースコードからバイナリおよびパッケージを構築するための「レシピ」を提供します。これは、macOS を実行している Macintosh コンピュータ上で GeoDjango の前提条件のためのレシピを提供しています。Homebrew はソフトウェアをソースコードから構築するため、 Xcode が必要となります。

\n

概要:

\n
Shell
$ brew install postgresql\n$ brew install postgis\n$ brew install gdal\n$ brew install libgeoip\n
\n
\n
FinkLink to this heading#
\n

Kurt Schwehr は Fink パッケージシステムのユーザーのために GeoDjango パッケージを作成してくれました。使用したい Python のバージョンに応じて、Different packages are available です（django-gis から始まります）。

\n
\n
\n
\n

MacPortsLink to this heading#

\n

MacPorts を使うと、macOS を実行しているコンピュータに GeoDjango の依存関係をインストールできます。MacPorts はソフトウェアをソースからビルドするので、 Xcode が必要です。

\n

概要:

\n
Shell
$ sudo port install postgresql13-server\n$ sudo port install geos\n$ sudo port install proj6\n$ sudo port install postgis3\n$ sudo port install gdal\n$ sudo port install libgeoip\n
\n\n
\n
\n
\n

WindowsLink to this heading#

\n

GeoDjango を Windows にインストールするには、以下のセクションを順番に進めてください。このチュートリアルでは、各アプリケーションの 64 ビット版をインストールします。

\n
\n

PythonLink to this heading#

\n

64ビット版のPythonをインストールします。詳しくは Python のインストール を参照してください。

\n
\n
\n

PostgreSQLLink to this heading#

\n

EnterpriseDB のウェブサイトから最新の PostgreSQL 15.x installer をダウンロードしてください。ダウンロード後、インストーラーを実行し、画面の指示に従い、デフォルトのオプションを変更するリスクを理解していない限り、変更せずに進んでください。

\n\n

インストーラーが完了すると、 "Launch Stack Builder at exit?" （スタックビルダーを終了時に起動しますか？）という質問が表示されます。これは、PostGIS をインストールするために必要ですので、チェックを入れたままにしてください。

\n\n
\n
\n

PostGISLink to this heading#

\n

Stack Builder (インストーラの外で実行するには Start ‣ PostgreSQL 15 ‣ Application Stack Builder ) から、ドロップダウンメニューから PostgreSQL 15 (x64) on port 5432 を選択して next をクリックします。 Categories ‣ Spatial Extensions メニューツリーを展開し、 PostGIS X.Y for PostgreSQL 15 を選択します。

\n

next をクリックすると、選択したパッケージと "Download directory" を確認するプロンプトが表示されます。もう一度 next をクリックすると、PostGIS がダウンロードされ、next をクリックして PostGIS のインストーラを開始するよう求められます。インストール中はデフォルトのオプションを選択してください。インストールプロセスでは、4つの Yes/No ダイアログボックスが表示されます。

\n
\n
\n

OSGeo4WLink to this heading#

\n

OSGeo4W installer は GeoDjango で必要な PROJ、GDAL、GEOS ライブラリのインストールに役立ちます。まず、 OSGeo4W installer をダウンロードし、実行します。 Express Web-GIS Install を選択し、next をクリックします。 "Select Packages" リストで、GDAL が選択されていることを確認してください。他のパッケージがデフォルトで有効になっている場合、それらは GeoDjango には必要ないので、チェックを外しても大丈夫です。次へをクリックし、ライセンス契約に同意すると、パッケージが自動的にダウンロードされ、インストールされます。

\n
\n
\n

Windows 環境変数の変更Link to this heading#

\n

GeoDjangoを使用するには、Windowsシステムの Path に OSGeo4W ディレクトリを追加し、 GDAL_DATA と PROJ_LIB の環境変数を作成する必要があります。以下のコマンドセットは、 cmd.exe で実行可能で、これを設定します。新しい環境変数を認識させるために、この作業が完了したらデバイスを再起動してください。

\n
Bat
set OSGEO4W_ROOT=C:\\OSGeo4W\nset GDAL_DATA=%OSGEO4W_ROOT%\\apps\\gdal\\share\\gdal\nset PROJ_LIB=%OSGEO4W_ROOT%\\share\\proj\nset PATH=%PATH%;%OSGEO4W_ROOT%\\bin\nreg ADD "HKLM\\SYSTEM\\CurrentControlSet\\Control\\Session Manager\\Environment" /v Path /t REG_EXPAND_SZ /f /d "%PATH%"\nreg ADD "HKLM\\SYSTEM\\CurrentControlSet\\Control\\Session Manager\\Environment" /v GDAL_DATA /t REG_EXPAND_SZ /f /d "%GDAL_DATA%"\nreg ADD "HKLM\\SYSTEM\\CurrentControlSet\\Control\\Session Manager\\Environment" /v PROJ_LIB /t REG_EXPAND_SZ /f /d "%PROJ_LIB%"\n
\n\n\n
\n
\n

DjangoのインストールとデータベースのセットアップLink to this heading#

\n

システムにDjangoを インストール します。作成する各プロジェクトに対して 仮想環境 を作成することを推奨します。

\n
\n
\n

psycopgLink to this heading#

\n

Pythonモジュール psycopg は Python と PostgreSQL データベースのインターフェースを提供します。 psycopg は Python 仮想環境内で pip を使用してインストールできます:

\n
Windows
...\\> py -m pip install psycopg\n
\n

脚注

\n\n
\n
\n
","rootId":"geodjango-installation","toc":[{"title":"概要","anchor":"overview","children":[]},{"title":"必要条件","anchor":"requirements","children":[{"title":"Python と Django","anchor":"python-and-django","children":[]},{"title":"空間データベース (Spatial database)","anchor":"spatial-database","children":[]}]},{"title":"インストール","anchor":"installation","children":[{"title":"地理空間ライブラリ (Geospatial library)","anchor":"geospatial-libraries","children":[]},{"title":"データベースのインストール","anchor":"database-installation","children":[]},{"title":"DATABASES の設定","anchor":"databases-configuration","children":[]},{"title":"django.contrib.gis を INSTALLED_APPS に追加します。","anchor":"add-django-contrib-gis-to-installed-apps","children":[]}]},{"title":"トラブルシューティング","anchor":"troubleshooting","children":[{"title":"ライブラリの環境設定","anchor":"library-environment-settings","children":[{"title":"LD_LIBRARY_PATH 環境変数","anchor":"ld-library-path-environment-variable","children":[]},{"title":"システムライブラリのパスを設定する","anchor":"setting-system-library-path","children":[]},{"title":"binutils をインストールする","anchor":"install-binutils","children":[]}]}]},{"title":"プラットフォーム固有の手順","anchor":"platform-specific-instructions","children":[{"title":"macOS","anchor":"macos","children":[{"title":"Python","anchor":"python","children":[]},{"title":"Postgres.app","anchor":"postgres-app","children":[]},{"title":"Homebrew","anchor":"homebrew","children":[{"title":"Fink","anchor":"fink","children":[]}]},{"title":"MacPorts","anchor":"macports","children":[]}]},{"title":"Windows","anchor":"windows","children":[{"title":"Python","anchor":"id18","children":[]},{"title":"PostgreSQL","anchor":"postgresql","children":[]},{"title":"PostGIS","anchor":"postgis","children":[]},{"title":"OSGeo4W","anchor":"osgeo4w","children":[]},{"title":"Windows 環境変数の変更","anchor":"modify-windows-environment","children":[]},{"title":"Djangoのインストールとデータベースのセットアップ","anchor":"install-django-and-set-up-database","children":[]},{"title":"psycopg","anchor":"psycopg","children":[]}]}]}],"breadcrumbs":[{"docname":"ref/index","title":"API リファレンス","url":"/ja/5.1/ref/"},{"docname":"ref/contrib/index","title":"contrib パッケージ","url":"/ja/5.1/ref/contrib/"},{"docname":"ref/contrib/gis/index","title":"GeoDjango","url":"/ja/5.1/ref/contrib/gis/"}],"prev":{"docname":"ref/contrib/gis/tutorial","title":"GeoDjango チュートリアル","url":"/ja/5.1/ref/contrib/gis/tutorial/"},"next":{"docname":"ref/contrib/gis/install/geolibs","title":"地理空間ライブラリのインストール","url":"/ja/5.1/ref/contrib/gis/install/geolibs/"},"formats":{"html":"/ja/5.1/ref/contrib/gis/install/","markdown":"/ja/5.1/ref/contrib/gis/install.md","json":"/ja/5.1/ref/contrib/gis/install.json"},"source":"https://github.com/django/django/blob/stable/5.1.x/docs/ref/contrib/gis/install/index.txt","official":"https://docs.djangoproject.com/ja/5.1/ref/contrib/gis/install/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}