Установка 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

DATABASES конфигурация

Установите значение ENGINE на одно из пространственных бэкэндов.

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

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

Устранение неполадок

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

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

Параметры окружения библиотек

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

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

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

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

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

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

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

• 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

Kurt Schwehr любезно предоставил пакеты 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 и нажмите «Далее». В списке «Выбор пакетов» убедитесь, что GDAL выбран; MapServer и Apache также включены по умолчанию, но GeoDjango их не требует и их можно безопасно отключить. После нажатия «Далее» пакеты будут автоматически загружены и установлены, после чего вы можете закрыть установщик.

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

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

set OSGEO4W_ROOT=C:\OSGeo4W
set PYTHON_ROOT=C:\Python3X
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%"

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

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

Примечания