Установка GeoDjango

Обзор

В общем случае, для установки GeoDjango требуется:

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

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

• macOS
• Windows

Требования

Python и Django

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

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

В настоящее время поддерживаются пространственные базы данных PostgreSQL (с PostGIS), MySQL, 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, не будут работать должным образом.

Отладка

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

• Присоединиться к каналу #django-geo IRC на Libera.Chat. Пожалуйста, будьте терпеливы и вежливы – хотя вы можете не получить немедленного ответа, кто-то попытается ответить на ваш вопрос, как только увидит его.
• Задайте свой вопрос на форуме 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

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 можно установить с помощью следующей команды:

$ python -m pip install psycopg2

Fink

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

MacPorts

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

Сводка:

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

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

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

Windows

Выполняйте последующие разделы последовательно для установки GeoDjango на Windows. В этом руководстве мы будем устанавливать 64-битные версии каждого приложения.

Python

Установите 64-битную версию Python. См. Установка Python для получения дополнительной информации.

PostgreSQL

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

По завершении инсталляции вас спросят «Запустить Stack Builder при выходе?» — оставьте этот пункт отмеченным, поскольку он необходим для установки PostGIS.

PostGIS

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

После нажатия «Далее» вас попросят подтвердить выбранный пакет и «Директорию загрузки». Нажмите «Далее» ещё раз, это позволит загрузить PostGIS, и вас попросят нажать «Далее» для запуска инсталлятора PostGIS. Выберите стандартные параметры при установке. Процесс установки включает три диалоговых окна «Да/Нет», стандартный вариант для всех трёх — «Нет».

OSGeo4W

Инсталлятор OSGeo4W помогает установить необходимые для GeoDjango библиотеки PROJ, GDAL и GEOS. Сначала загрузите инсталлятор OSGeo4W (64-битный) и запустите его. Выберите Быстрая установка веб-ГИС и нажмите «Далее». В списке «Выбрать пакеты» убедитесь, что выбран GDAL; MapServer также включен по умолчанию, но не требуется GeoDjango и его можно безопасно отключить. После нажатия «Далее» и принятия лицензионных соглашений, пакеты будут автоматически загружены и установлены, после чего вы можете выйти из инсталлятора.

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

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

set OSGEO4W_ROOT=C:\OSGeo4W64
set GDAL_DATA=%OSGEO4W_ROOT%\share\gdal
set PROJ_LIB=%OSGEO4W_ROOT%\share\proj
set PATH=%PATH%;%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 на вашей системе. Рекомендуется создавать виртуальную среду виртуальную среду для каждого создаваемого проекта.

psycopg2

Модуль Python psycopg2 предоставляет интерфейс между Python и базой данных PostgreSQL. psycopg2 можно установить с помощью pip в вашей виртуальной среде Python:

...\> py -m pip install psycopg2

Примечания