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

GeoDjango использует и/или предоставляет интерфейсы для следующих открытых геопространственных библиотек:

Обратите внимание, что более старые или более новые версии этих библиотек также могут работать с GeoDjango. Результаты могут отличаться.

В Debian/Ubuntu рекомендуется установить следующие пакеты, которые установят, напрямую или через зависимости, необходимые геопространственные библиотеки:

$ sudo apt-get install binutils libproj-dev gdal-bin

Также ознакомьтесь с платформенно-специфичными инструкциями, если вы используете macOS или Windows.

Компиляция из исходного кода

При установке из исходного кода на системах UNIX и GNU/Linux, пожалуйста, следуйте инструкциям по установке и установите библиотеки в указанном порядке. Если вы используете MySQL или Oracle в качестве пространственной базы данных, необходим только GEOS.

$ sudo make install
$ sudo ldconfig

GEOS

GEOS — это библиотека на C++ для выполнения геометрических операций и является стандартным внутренним представлением геометрии, используемым GeoDjango (она стоит за «ленивыми» геометриями). В частности, библиотека C API вызывается (например, libgeos_c.so) напрямую из Python с использованием ctypes.

Сначала загрузите GEOS с сайта GEOS и распакуйте архив исходного кода:

$ wget https://download.osgeo.org/geos/geos-X.Y.Z.tar.bz2
$ tar xjf geos-X.Y.Z.tar.bz2

Затем перейдите в каталог GEOS, создайте папку build и перейдите в неё:

$ cd geos-X.Y.Z
$ mkdir build
$ cd build

Затем скомпилируйте и установите пакет:

$ cmake -DCMAKE_BUILD_TYPE=Release ..
$ cmake --build .
$ sudo cmake --build . --target install

Отладка

Не удаётся найти библиотеку GEOS

Когда GeoDjango не может найти GEOS, возникает эта ошибка:

ImportError: Could not find the GEOS library (tried "geos_c"). Try setting GEOS_LIBRARY_PATH in your settings.

Наиболее распространённое решение — правильно настроить вашу настройку окружения библиотек или установить GEOS_LIBRARY_PATH в файле настроек.

Если вы используете бинарный пакет GEOS (например, в Ubuntu), вам может потребоваться установить binutils.

GEOS_LIBRARY_PATH

Если ваша библиотека GEOS находится в нестандартном месте или вы не хотите изменять системный путь к библиотеке, то в файл настроек Django можно добавить настройку GEOS_LIBRARY_PATH с полным путем к библиотеке GEOS на C. Например:

GEOS_LIBRARY_PATH = '/home/bob/local/lib/libgeos_c.so'

См. также Мои журналы заполнены ошибками GEOS.

PROJ

PROJ — это библиотека для преобразования геопространственных данных в различные системы координат.

Сначала загрузите исходный код PROJ:

$ wget https://download.osgeo.org/proj/proj-X.Y.Z.tar.gz

… и файлы смещения датумов (скачайте proj-datumgrid-X.Y.tar.gz для PROJ < 7.x) [1]:

$ wget https://download.osgeo.org/proj/proj-data-X.Y.tar.gz

Далее, распакуйте архив исходного кода и извлеките файлы смещения датумов в подкаталоге data (для PROJ < 6.x используйте подкаталог nad). Это необходимо выполнить до конфигурации:

$ tar xzf proj-X.Y.Z.tar.gz
$ cd proj-X.Y.Z/data
$ tar xzf ../../proj-data-X.Y.tar.gz
$ cd ../..

Для PROJ 9.x и выше релизы поддерживают только сборку с использованием CMake (см. PROJ RFC-7).

Для сборки с CMake убедитесь, что ваша система соответствует требованиям требований к сборке. Затем создайте папку build в каталоге PROJ и перейдите в неё:

$ cd proj-X.Y.Z
$ mkdir build
$ cd build

Наконец, сконфигурируйте, выполните make и установите PROJ:

$ cmake ..
$ cmake --build .
$ sudo cmake --build . --target install

GDAL

GDAL — отличная открытая геопространственная библиотека, поддерживающая чтение большинства форматов векторных и растровых пространственных данных. В настоящее время GeoDjango поддерживает только возможности векторных данных GDAL [2]. GEOS и PROJ должны быть установлены перед сборкой GDAL.

Сначала загрузите последнюю версию релиза GDAL и распакуйте архив:

$ wget https://download.osgeo.org/gdal/X.Y.Z/gdal-X.Y.Z.tar.gz
$ tar xzf gdal-X.Y.Z.tar.gz

Для GDAL 3.6.x и выше релизы поддерживают только сборку с использованием CMake. Для сборки с CMake создайте папку build в каталоге GDAL и перейдите в неё:

$ cd gdal-X.Y.Z
$ mkdir build
$ cd build

Наконец, сконфигурируйте, выполните make и установите GDAL:

$ cmake ..
$ cmake --build .
$ sudo cmake --build . --target install

Если у вас возникли проблемы, см. раздел отладки ниже для предложений и решений.

Отладка

Не удаётся найти библиотеку GDAL

Если GeoDjango не может найти библиотеку GDAL, настройте настройки окружения библиотек или установите GDAL_LIBRARY_PATH в файле настроек.

GDAL_LIBRARY_PATH

Если ваша библиотека GDAL находится в нестандартном месте или вы не хотите изменять системный путь к библиотеке, то в файл настроек Django можно добавить настройку GDAL_LIBRARY_PATH с полным путем к библиотеке GDAL. Например:

GDAL_LIBRARY_PATH = '/home/sue/local/lib/libgdal.so'

Примечания