通常、GeoDjango のインストールには次のものが必要です:
\n\n各要件の詳細とインストール手順については、以下のセクションを参照してください。また、プラットフォーム別の手順もあります:
\n\n\nGeoDjango は Django に同梱されていますので、インストール方法の詳細は Django の インストール手順 を参照してください。
\n現在サポートされている空間データベースは、PostgreSQL (with PostGIS)、MySQL、Oracle、SQLite (with SpatiaLite) です。
\n\nThe geospatial libraries required for a GeoDjango installation depends\non the spatial database used. The following lists the library requirements,\nsupported versions, and any notes for each of the supported database backends:
\nデータベース | \nライブラリの要件 | \nサポートされるバージョン | \n備考 | \n
|---|---|---|---|
PostgreSQL | \nGEOS, GDAL, PROJ, PostGIS | \n14+ | \nPostGIS が必要です。 | \n
MySQL | \nGEOS, GDAL | \n8.0.11+ | \n\n |
Oracle | \nGEOS, GDAL | \n19+ | \nXE not supported. | \n
SQLite | \nGEOS, GDAL, PROJ, SpatiaLite | \n3.31.0+ | \nRequires SpatiaLite 4.3+ | \n
PostgreSQL/PostGIS/GEOS/GDAL の可能な組み合わせについては、OSGeo Wikiの this comparison matrix も参照してください。
\nDATABASES の設定Link to this heading#ENGINE 設定を、空間 (spatial) バックエンド の1つに設定してください。
django.contrib.gis を INSTALLED_APPS に追加します。Link to this heading#他の Django contrib アプリケーションと同様に、設定の INSTALLED_APPS に django.contrib.gis を追加するだけです。これは gis テンプレートを配置するためです。そうしないと、地理管理や KML サイトマップのような機能が正しく動作しません。
問題の解決策がここに見つからない場合は、コミュニティに参加してみてください！以下のようなことができます:
\nGeoDjango フォーラムで質問してください。
File a ticket on the Django trac if you think there's a bug. Make\nsure to provide a complete description of the problem, versions used,\nand specify the component as "GIS".
GeoDjango をインストールする際に最もよくある問題は、外部の共有ライブラリ (例えば GEOS や GDAL) が見つからないというものです [1] 。通常、この問題の原因は、オペレーティングシステムがソースからビルドされたライブラリがインストールされたディレクトリを認識していないことです。
\n通常、ライブラリのパスは、個々のユーザーごとに環境変数を設定するか、システム全体のライブラリ パスを構成することで設定できます。
\nLD_LIBRARY_PATH 環境変数Link to this heading#A user may set this environment variable to customize the library paths\nthey want to use. The typical library directory for software\nbuilt from source is /usr/local/lib. Thus, /usr/local/lib needs\nto be included in the LD_LIBRARY_PATH variable. For example, the user\ncould place the following in their bash profile:
export LD_LIBRARY_PATH=/usr/local/lib\nOn GNU/Linux systems, there is typically a file in /etc/ld.so.conf, which\nmay include additional paths from files in another directory, such as\n/etc/ld.so.conf.d. As the root user, add the custom library path (like\n/usr/local/lib) on a new line in ld.so.conf. This is one example of\nhow to do so:
$ sudo echo /usr/local/lib >> /etc/ld.so.conf\n$ sudo ldconfig\nFor OpenSolaris users, the system library path may be modified using the\ncrle utility. Run crle with no options to see the current configuration\nand use crle -l to set with the new library path. Be very careful when\nmodifying the system library path:
# crle -l $OLD_PATH:/usr/local/lib\nbinutils をインストールするLink to this heading#GeoDjango uses the find_library function (from the ctypes.util Python\nmodule) to discover libraries. The find_library routine uses a program\ncalled objdump (part of the binutils package) to verify a shared\nlibrary on GNU/Linux systems. Thus, if binutils is not installed on your\nLinux system then Python's ctypes may not be able to find your library even if\nyour library path is set correctly and geospatial libraries were built\nperfectly.
binutils パッケージは、Debian および Ubuntu システムでは以下のコマンドを使用してインストールできます:
$ sudo apt-get install binutils\nRed Hat および CentOS システムでも同様です:
\n$ sudo yum install binutils\nmacOS では様々なパッケージングシステムが利用できるため、ユーザは GeoDjango をインストールするのにいくつかの異なる選択肢があります。これらのオプションは以下の通りです:
\nPostgres.app (最も簡単、推奨)
このセクションには、Python Software Foundation が提供するパッケージから Python のアップグレード版をインストールする手順も含まれていますが、これは必須ではありません。
\nAlthough macOS comes with Python installed, users can use framework\ninstallers provided by the Python Software Foundation. An advantage to\nusing the installer is that macOS's Python will remain "pristine" for internal\noperating system use.
\n\nPostgres.app is a standalone PostgreSQL server\nthat includes the PostGIS extension. You will also need to install gdal\nwith Homebrew.
Postgres.appをインストールした後、コマンドラインからパッケージのプログラムを実行できるように、 .bash_profile に以下を追加してください。 X.Y をインストールした Postgres.app の PostgreSQL のバージョンに置き換えてください:
export PATH=$PATH:/Applications/Postgres.app/Contents/Versions/X.Y/bin\nターミナルプロンプトで which psql と入力して、パスが正しく設定されているかを確認できます。
Homebrew は、ソースコードからバイナリおよびパッケージを構築するための「レシピ」を提供します。これは、macOS を実行している Macintosh コンピュータ上で GeoDjango の前提条件のためのレシピを提供しています。Homebrew はソフトウェアをソースコードから構築するため、 Xcode が必要となります。
\n概要:
\n$ brew install postgresql\n$ brew install postgis\n$ brew install gdal\nKurt Schwehr は Fink パッケージシステムのユーザーのために GeoDjango パッケージを作成してくれました。使用したい Python のバージョンに応じて、Different packages are available です（django-gis から始まります）。
MacPorts may be used to install GeoDjango prerequisites on computers\nrunning macOS. Because MacPorts still builds the software from source,\nXcode is required.
\n概要:
\n$ sudo port install postgresql14-server\n$ sudo port install geos\n$ sudo port install proj6\n$ sudo port install postgis3\n$ sudo port install gdal\nGeoDjango を Windows にインストールするには、以下のセクションを順番に進めてください。このチュートリアルでは、各アプリケーションの 64 ビット版をインストールします。
\n64ビット版のPythonをインストールします。詳しくは Python のインストール を参照してください。
\nDownload the latest PostgreSQL 15.x installer from the\nEnterpriseDB website. After downloading, run the installer, follow the\non-screen directions, and keep the default options unless you know the\nconsequences of changing them.
\n\nインストーラーが完了すると、 "Launch Stack Builder at exit?" （スタックビルダーを終了時に起動しますか？）という質問が表示されます。これは、PostGIS をインストールするために必要ですので、チェックを入れたままにしてください。
\n\nStack Builder (インストーラの外で実行するには ) から、ドロップダウンメニューから を選択して next をクリックします。 メニューツリーを展開し、 を選択します。
\nnext をクリックすると、選択したパッケージと "Download directory" を確認するプロンプトが表示されます。もう一度 next をクリックすると、PostGIS がダウンロードされ、next をクリックして PostGIS のインストーラを開始するよう求められます。インストール中はデフォルトのオプションを選択してください。インストールプロセスでは、4つの Yes/No ダイアログボックスが表示されます。
\nThe OSGeo4W installer helps to install the PROJ, GDAL, and GEOS libraries\nrequired by GeoDjango. First, download the OSGeo4W installer, and\nrun it. Select and click next. In the\n'Select Packages' list, ensure that GDAL is selected. If any other packages are\nenabled by default, they are not required by GeoDjango and may be unchecked\nsafely. After clicking next and accepting the license agreements, the packages\nwill be automatically downloaded and installed, after which you may exit the\ninstaller.
\nIn order to use GeoDjango, you will need to add your OSGeo4W\ndirectories to your Windows system Path, as well as create GDAL_DATA\nand PROJ_LIB environment variables. The following set of commands,\nexecutable with cmd.exe, will set this up. Restart your device\nonce this is complete for new environment variables to be recognized:
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%"\nPythonモジュール psycopg は Python と PostgreSQL データベースのインターフェースを提供します。 psycopg は Python 仮想環境内で pip を使用してインストールできます:
...\\> py -m pip install psycopg\n脚注
\n\n