Установка GeoDjango

Обзор

В целом, установка GeoDjango требует:

1. Python и Django
2. Пространственная база данных
3. Установка геопространственных библиотек

Подробная информация по каждому из требований и инструкции по установке приведены в разделах ниже. Кроме того, доступны платформо-специфические инструкции для:

• macOS
• Windows

Требования

Python и Django

Поскольку GeoDjango входит в состав Django, для получения подробной информации об установке обратитесь к инструкциям по установке Django: инструкциям по установке.

Пространственная база данных

В настоящее время поддерживаются пространственные базы данных PostgreSQL (с PostGIS), MySQL (в основном с движком MyISAM), Oracle и SQLite (со SpatiaLite).

Геопространственные библиотеки, необходимые для установки GeoDjango, зависят от используемой пространственной базы данных. В следующих списках перечислены требования к библиотекам, поддерживаемые версии и любые замечания для каждого из поддерживаемых бэкэндов баз данных:

См. также эту сравнительную матрицу на вики-сайте OSGeo для возможных комбинаций PostgreSQL/PostGIS/GEOS/GDAL.

Установка

Геопространственные библиотеки

• Установка геопространственных библиотек

Установка базы данных

• Установка PostGIS
• Установка SpatiaLite

Добавить django.contrib.gis в INSTALLED_APPS

Как и другие приложения Django contrib, вам только нужно добавить django.contrib.gis в INSTALLED_APPS в вашем файле настроек. Это необходимо для того, чтобы шаблоны gis были доступны — если этого не сделать, такие функции, как географический администратор или KML-карты, не будут работать должным образом.

Отладка

Если вы не можете найти решение своей проблемы здесь, примите участие в сообществе! Вы можете:

• Присоединиться к каналу IRC #geodjango на Freenode. Пожалуйста, будьте терпеливы и вежливы — хотя вы можете не получить мгновенного ответа, кто-то постарается ответить на ваш вопрос, как только увидит его.
• Задать свой вопрос на почтовой рассылке GeoDjango.
• Создать запрос на отладку в Django trac, если считаете, что есть ошибка. Убедитесь, что вы предоставили полное описание проблемы, используемые версии и указали компонент как «GIS».

Настройки среды библиотек

Самая распространённая проблема при установке GeoDjango — это невозможность найти внешние библиотеки (например, для GEOS и GDAL). [1] Обычно причиной этой проблемы является то, что операционная система не знает каталог, в котором были установлены библиотеки, созданные из исходного кода.

В общем случае путь к библиотекам может быть установлен на основе пользователя путём установки переменной среды или настройки пути к библиотекам для всей системы.

LD_LIBRARY_PATH переменная среды

Пользователь может установить эту переменную среды, чтобы настроить пути к библиотекам, которые он хочет использовать. Типичный каталог библиотек для программного обеспечения, созданного из исходного кода, — /usr/local/lib. Таким образом, /usr/local/lib необходимо включить в переменную LD_LIBRARY_PATH. Например, пользователь может поместить следующее в свой файл bash-профиля:

export LD_LIBRARY_PATH=/usr/local/lib

Настройка системного пути к библиотекам

В системах GNU/Linux обычно есть файл в /etc/ld.so.conf, который может содержать дополнительные пути из файлов в другом каталоге, таком как /etc/ld.so.conf.d. Как пользователь root, добавьте пользовательский путь к библиотекам (например, /usr/local/lib) в новую строку в ld.so.conf. Это один из способов сделать это:

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

Для пользователей OpenSolaris системный путь к библиотекам может быть изменён с помощью утилиты crle. Запустите crle без параметров, чтобы увидеть текущую конфигурацию, и используйте crle -l для установки нового пути к библиотекам. Будьте очень осторожны при изменении системного пути к библиотекам:

# crle -l $OLD_PATH:/usr/local/lib

Установить binutils

GeoDjango использует функцию find_library (из модуля Python ctypes.util) для обнаружения библиотек. Функция find_library использует программу objdump (часть пакета binutils), чтобы проверить общую библиотеку в системах GNU/Linux. Таким образом, если binutils не установлен в вашей Linux-системе, ctypes Python может не найти вашу библиотеку, даже если путь к вашей библиотеке установлен правильно, и геопространственные библиотеки были скомпилированы без ошибок.

Пакет binutils может быть установлен в системах Debian и Ubuntu с помощью следующей команды:

$ sudo apt-get install binutils

Аналогично, в системах Red Hat и CentOS:

$ sudo yum install binutils

Платформо-специфические инструкции

macOS

Из-за разнообразия систем упаковки, доступных для macOS, у пользователей есть несколько вариантов установки GeoDjango. Эти варианты:

• Postgres.app (наиболее простой и рекомендуемый)
• Homebrew
• Пакеты KyngChaos
• Fink
• MacPorts
• Сборка из исходного кода

Этот раздел также содержит инструкции по установке обновлённой версии Python из пакетов, предоставляемых Python Software Foundation, однако это не обязательно.

Python

Хотя macOS поставляется с установленным Python, пользователи могут использовать инсталляторы фреймворка, предоставляемые Python Software Foundation. Преимущество использования инсталлятора заключается в том, что Python macOS останется «нетронутым» для внутреннего использования операционной системы.

export PATH=/Library/Frameworks/Python.framework/Versions/Current/bin:$PATH

Postgres.app

Postgres.app — это автономный сервер PostgreSQL, который включает расширение PostGIS. Вам также нужно установить gdal и libgeoip с помощью Homebrew.

После установки Postgres.app добавьте следующее в свой .bash_profile, чтобы вы могли запускать программы пакета из командной строки. Замените X.Y версией PostgreSQL в установленной вами Postgres.app:

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

Вы можете проверить, правильно ли установлен путь, набрав which psql в командной строке.

Homebrew

Homebrew предоставляет «рецепты» для построения бинарных файлов и пакетов из исходного кода. Он предоставляет рецепты для предварительных условий GeoDjango на Macintosh-компьютерах под управлением macOS. Поскольку Homebrew по-прежнему собирает программное обеспечение из исходного кода, требуется Xcode.

Резюме:

$ brew install postgresql
$ brew install postgis
$ brew install gdal
$ brew install libgeoip

Пакеты KyngChaos

Вильям Кингзберри предоставляет ряд бинарных пакетов геопространственных библиотек, которые упрощают установку GeoDjango на macOS без компиляции из исходного кода. Однако, Xcode всё ещё необходим для компиляции адаптеров баз данных Python psycopg2 (для PostGIS) и pysqlite2 (для SpatiaLite).

Загрузите пакеты фреймворка для:

• UnixImageIO
• PROJ
• GEOS
• SQLite3 (включает библиотеку SpatiaLite)
• GDAL

Установите пакеты в указанном порядке, поскольку пакеты GDAL и SQLite требуют пакетов, перечисленных перед ними.

После этого вы также можете установить бинарные пакеты KyngChaos для PostgreSQL и PostGIS.

После установки бинарных пакетов, вам нужно добавить следующее в .profile для возможности запуска программ пакета из командной строки:

export PATH=/Library/Frameworks/UnixImageIO.framework/Programs:$PATH
export PATH=/Library/Frameworks/PROJ.framework/Programs:$PATH
export PATH=/Library/Frameworks/GEOS.framework/Programs:$PATH
export PATH=/Library/Frameworks/SQLite3.framework/Programs:$PATH
export PATH=/Library/Frameworks/GDAL.framework/Programs:$PATH
export PATH=/usr/local/pgsql/bin:$PATH

psycopg2

После установки бинарных файлов KyngChaos и изменения PATH, как описано выше, psycopg2 может быть установлен с помощью следующей команды:

$ pip install psycopg2

Fink

Курт Швейер любезно подготовил пакеты GeoDjango для пользователей системы пакетов Fink. Различные пакеты доступны (начиная с django-gis), в зависимости от используемой версии Python.

MacPorts

MacPorts может быть использован для установки необходимых для GeoDjango компонентов на компьютерах под управлением macOS. Поскольку MacPorts всё ещё собирает программное обеспечение из исходного кода, требуется Xcode.

Сводка:

$ sudo port install postgresql93-server
$ sudo port install geos
$ sudo port install proj
$ sudo port install postgis
$ sudo port install gdal +geos
$ sudo port install libgeoip

export PATH=/opt/local/bin:/opt/local/lib/postgresql93/bin

export DYLD_FALLBACK_LIBRARY_PATH=/opt/local/lib:/opt/local/lib/postgresql93

Windows

Следуйте последовательно приведенным ниже инструкциям, чтобы установить GeoDjango на Windows.

Python

Установите Python.

PostgreSQL

Сначала загрузите последнюю версию установщик PostgreSQL 9.x с веб-сайта EnterpriseDB. После загрузки просто запустите установщик, следуйте инструкциям на экране и сохраняйте стандартные настройки, если вы не знаете последствий их изменения.

По завершении установки установщик запросит запуск инструмента «Application Stack Builder» (ASB) — оставьте эту опцию включённой, так как она необходима для установки PostGIS.

PostGIS

Внутри инструмента «Application Stack Builder» (для запуска вне установщика, выберите Пуск ‣ Программы ‣ PostgreSQL 9.x), выберите Сервер базы данных PostgreSQL 9.x на порту 5432 в раскрывающемся меню. Далее, разверните меню Категории ‣ Расширения пространственных данных и выберите PostGIS X.Y для PostgreSQL 9.x.

После нажатия кнопки «Далее» вы будете приглашены выбрать зеркало, PostGIS будет загружен, и начнется установка PostGIS. Во время установки выберите только стандартные настройки (например, не снимайте галочку с опции создания базы данных PostGIS по умолчанию).

psycopg2

Модуль Python psycopg2 обеспечивает интерфейс между Python и базой данных PostgreSQL. Загрузите последний установщик для Windows для вашей версии Python и PostgreSQL и запустите, используя стандартные параметры. [2]

OSGeo4W

Установщик OSGeo4W упрощает установку библиотек PROJ.4, GDAL и GEOS, необходимых для GeoDjango. Сначала загрузите установщик OSGeo4W и запустите его. Выберите Express Web-GIS Install и нажмите «Далее». В списке «Выбрать пакеты» убедитесь, что GDAL выбран; MapServer и Apache также включены по умолчанию, но не требуются GeoDjango и могут быть безопасно сняты. После нажатия «Далее» пакеты будут автоматически загружены и установлены, после чего можно выйти из установщика.

Изменение среды Windows

Для использования GeoDjango необходимо добавить каталоги Python и OSGeo4W в переменные среды Windows Path, а также создать переменные среды GDAL_DATA и PROJ_LIB. Следующий набор команд, выполнимый с помощью cmd.exe, настроит это:

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

Для вашего удобства эти команды доступны в исполняемом пакетном скрипте geodjango_setup.bat.

Установите Django и настройте базу данных

Наконец, установите Django на вашей системе.

Примечания