Установка PostGIS

PostGIS добавляет поддержку географических объектов в PostgreSQL, превращая его в пространственную базу данных. GEOS, PROJ и GDAL должны быть установлены перед построением PostGIS. Вам могут потребоваться дополнительные библиотеки, см. требования к PostGIS.

Модуль psycopg2 необходим для использования в качестве адаптера базы данных при работе с GeoDjango и PostGIS.

В Debian/Ubuntu рекомендуется установить следующие пакеты: postgresql-x.x, postgresql-x.x-postgis, postgresql-server-dev-x.x, и python-psycopg2 (x.x соответствует версии PostgreSQL, которую вы хотите установить). В качестве альтернативы можно собрать из исходного кода. Обратитесь к инструкциям, специфичным для платформы, если вы используете macOS или Windows.

После установки

Создание пространственной базы данных

PostGIS 2 включает расширение для PostgreSQL, которое используется для включения пространственных функций:

$ createdb  <db name>
$ psql <db name>
> CREATE EXTENSION postgis;

Пользователь базы данных должен быть суперпользователем, чтобы запустить CREATE EXTENSION postgis;. Команда выполняется во время процесса migrate. Альтернативой является использование операции миграции в вашем проекте:

from django.contrib.postgres.operations import CreateExtension
from django.db import migrations

class Migration(migrations.Migration):

    operations = [
        CreateExtension('postgis'),
        ...
    ]

Если вы планируете использовать функции растровой обработки PostGIS в PostGIS 3+, вы также должны активировать расширение postgis_raster. Вы можете установить расширение, используя операцию миграции CreateExtension, или непосредственно, выполнив CREATE EXTENSION postgis_raster;.

GeoDjango в настоящее время не использует какие-либо функции топологии PostGIS. Если вы планируете использовать эти функции в будущем, вы также можете установить расширение postgis_topology с помощью команды CREATE EXTENSION postgis_topology;.

Управление базой данных

Для администрирования базы данных можно использовать программу pgAdmin III (Пуск ‣ PostgreSQL X ‣ pgAdmin III) или оболочку SQL (Пуск ‣ PostgreSQL X ‣ Оболочка SQL). Например, для создания geodjango пространственной базы данных и пользователя, следующее может быть выполнено из оболочки SQL как пользователь postgres:

postgres# CREATE USER geodjango PASSWORD 'my_passwd';
postgres# CREATE DATABASE geodjango OWNER geodjango;