Installation de PostGIS

PostGIS ajoute la prise en charge des objets géographiques à PostgreSQL, pour en faire une base de données spatiale. GEOS, PROJ et GDAL devraient être installés avant de compiler PostGIS. Vous aurez peut-être besoin d’autres bibliothèques, voir exigences PostGIS.

Le module psycopg ou psycopg2 est obligatoire comme adaptateur de base de données lors de l’utilisation de GeoDjango avec PostGIS.

Sur Debian/Ubuntu, il est conseillé d’installer les paquets suivants : postgresql-x, postgresql-x-postgis-3, postgresql-server-dev-x et python3-psycopg3 (où x correspond à la version de PostgreSQL que vous souhaitez installer). Il est aussi possible de construire à partir des sources. Consultez les instructions spécifiques à votre plate-forme si vous travaillez avec macOS ou Windows.

Changed in Django 4.2:

La prise en charge de psycopg 3.1.8+ a été ajoutée.

Après l’installation

Création d’une base de données spatiale

PostGIS 2 contient une extension pour PostgreSQL utilisée pour activer les fonctions spatiales :

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

L’utilisateur de base de données doit être superutilisateur pour être autorisé à exécuter CREATE EXTENSION postgis;. Cette commande est exécutée durant le processus migrate. Une alternative est d’utiliser une opération de migration dans votre projet :

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


class Migration(migrations.Migration):
    operations = [CreateExtension("postgis"), ...]

Si vous pensez utiliser la fonctionnalité matricielle (raster) de PostGIS avec PostGIS 3+, vous devez également activer l’extension postgis_raster. Vous pouvez installer cette extension en utilisant l’opération de migration CreateExtension ou en lançant directement CREATE EXTENSION postgis_raster;.

GeoDjango n’exploite actuellement aucune fonctionnalité PostGIS de topologie. Si vous pensez utilisez ces fonctionnalités à un moment donné, vous pouvez également installer l’extension postgis_topology en exécutant CREATE EXTENSION postgis_topology;.

Gestion de la base de données

Pour administrer la base de données, vous pouvez soit utiliser le programme pgAdmin III (Démarrer ‣ PostgreSQL X ‣ pgAdmin III), soit le shell SQL (Démarrer ‣ PostgreSQL X ‣ SQL Shell). Par exemple, pour créer un utilisateur et une base de données geodjango, voici ce qui pourrait être saisi dans un shell SQL lancé avec l’utilisateur postgres:

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