Установка PostGIS

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

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

В Debian/Ubuntu рекомендуется установить следующие пакеты: postgresql-x, postgresql-x-postgis-3, postgresql-server-dev-x, и python3-psycopg3 (x соответствует версии PostgreSQL, которую вы хотите установить). В качестве альтернативы вы можете собрать PostGIS из исходных кодов. Обратитесь к инструкциям для вашей платформы, если вы используете 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 Shell (Пуск ‣ PostgreSQL X ‣ SQL Shell). Например, для создания пространственной базы данных и пользователя geodjango можно выполнить следующие команды из SQL Shell в качестве пользователя postgres:

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