Installation de GeoDjango

Aperçu

En général, l’installation de GeoDjango requiert :

  1. Python et Django
  2. Base de données spatiale
  3. Installation des bibliothèques géospatiales

Des détails au sujet de chaque exigence et des instructions d’installation sont fournies dans les sections ci-dessous. De plus, des instructions spécifiques à des plates-formes particulières sont disponibles pour :

Utilisation du code source

Comme GeoDjango tire profit des derniers développements de la technologie logicielle géospatiale libre, des versions récentes des bibliothèques sont nécessaires. Si des paquets binaires ne sont pas disponibles sur votre plate-forme, il peut être nécessaire d’installer à partir des sources. Lors de la compilation des bibliothèques à partir des sources, suivez attentivement les consignes, particulièrement si vous êtes débutant.

Exigences

Python et Django

Comme GeoDjango est inclus dans Django, référez-vous aux instructions d’installation de Django pour des détails sur l’installation.

Base de données spatiale

PostgreSQL (avec PostGIS), MySQL, Oracle et SQLite (avec SpatiaLite) sont les bases de données spatiales actuellement prises en charge.

Note

PostGIS est recommandé, car c’est la base de données spatiale libre la plus mature et riche en fonctionnalités.

Les bibliothèques géospatiales requises pour une installation de GeoDjango dépendent de la base de données spatiale utilisée. Le tableau ci-après présente les bibliothèques requises, les versions prises en charge et d’éventuelles notes pour les différents moteurs de base de données :

Base de données Bibliothèques requises Versions prises en charge Notes
PostgreSQL GEOS, GDAL, PROJ, PostGIS 12+ Exige PostGIS.
MySQL GEOS, GDAL 8+ Fonctionnalités limitées.
Oracle GEOS, GDAL 19+ XE non pris en charge.
SQLite GEOS, GDAL, PROJ, SpatiaLite 3.21.0+ Nécessite SpatiaLite 4.3+

Voir aussi cette matrice comparative sur le Wiki OSGeo pour des combinaisons possibles entre PostgreSQL/PostGIS/GEOS/GDAL.

Installation

Installation de la base de données

Configuration de DATABASES

Définissez le réglage ENGINE à l’un des moteurs spatiaux.

Ajout de django.contrib.gis à INSTALLED_APPS

Comme pour d’autres applications contribuées dans Django, il suffit d’ajouter django.contrib.gis à INSTALLED_APPS dans vos réglages. Ceci afin que les gabarits gis puissent être découverts ; dans le cas contraire, certaines fonctions comme l’interface d’administration géographique ou les plans de sites KML ne fonctionneraient pas correctement.

Dépannage

Si vous ne trouvez pas de solution à votre problème sur cette page, participez alors à la communauté ! Vous pouvez :

  • Rejoindre le canal IRC #django-geo sur Libera.Chat. Soyez patient et poli ; même si vous n’obtenez pas de réponse immédiate, quelqu’un essaiera de répondre à votre question au moment où il la lira.
  • Poser votre question sur le forum GeoDjango (en anglais).
  • Créer un ticket dans le trac de Django si vous pensez qu’il y a un bogue. Prenez soin de fournir une description complète du problème, les versions utilisées et indiquez le composant « GIS ».

Réglages d’environnement de bibliothèques

Le problème de loin le plus fréquent lors de l’installation de GeoDjango est que les bibliothèques partagées externes (par ex. GEOS et GDAL) ne sont pas trouvées [1]. Typiquement, la cause de ce problème est que le système d’exploitation ne connaît pas les répertoires dans lesquels sont installées les bibliothèques compilées à partir de leurs sources.

En général, le chemin de bibliothèque peut être défini pour chaque utilisateur en définissant une variable d’environnement ou en configurant un chemin de bibliothèque global pour tout le système.

Variable d’environnement LD_LIBRARY_PATH

Un utilisateur peut définir cette variable d’environnement pour personnaliser les chemins de bibliothèques qu’ils souhaitent utiliser. Le répertoire de bibliothèques traditionnel pour du logiciel compilé depuis les sources est /usr/local/lib. Il faut donc inclure /usr/local/lib dans la variable LD_LIBRARY_PATH. Par exemple, voici ce qu’un utilisateur pourrait ajouter dans son fichier de profil bash :

export LD_LIBRARY_PATH=/usr/local/lib

Définition du chemin de bibliothèque au niveau système

Sur les systèmes GNU/Linux, il existe le plus souvent un fichier /etc/ld.so.conf qui peut contenir des chemins supplémentaires provenant de fichiers d’un autre répertoire, tel que /etc/ld.so.conf.d. En tant qu’utilisateur root, ajoutez le chemin de bibliothèque personnalisé (comme /usr/local/lib) sur une nouvelle ligne dans ld.so.conf. Ceci est un exemple de la façon dont on peut le faire :

$ sudo echo /usr/local/lib >> /etc/ld.so.conf
$ sudo ldconfig

Pour les utilisateurs d’OpenSolaris, le chemin des bibliothèques systèmes peut être modifié par l’utilitaire crle. Exécutez crle sans option pour afficher la configuration actuelle et exécutez crle -l pour définir un nouveau chemin de bibliothèque. Soyez très prudent lors de la modification de chemins de bibliothèques systèmes :

# crle -l $OLD_PATH:/usr/local/lib

Installation de binutils

GeoDjango utilise la fonction find_library (provenant du module Python ctypes.util) pour chercher les bibliothèques. La routine find_library utilise un programme nommé objdump (faisant partie du paquet binutils) pour vérifier la présence d’une bibliothèque partagée sur les systèmes GNU/Linux. De ce fait, si binutils n’est pas installé sur votre système Linux, le module ctypes de Python pourrait ne pas trouver une bibliothèque même si le chemin des bibliothèques est correctement défini et que les bibliothèques géospatiales ont été compilées avec succès.

Le paquet binutils peut être installé sur les systèmes Debian et Ubuntu en utilisant la commande suivante :

$ sudo apt-get install binutils

De même, sur les systèmes Red Hat et CentOS :

$ sudo yum install binutils

Instructions spécifiques à certaines plates-formes

macOS

En raison de la variété des systèmes d’empaquetage disponibles pour macOS, il existe différentes options pour installer GeoDjango. Ces options sont :

Cette section inclut aussi des instructions pour installer une version mise à jour de Python à partir de paquets fournis par la fondation Python Software, mais ce n’est pas une obligation.

Python

Même si Python est préinstallé sur macOS, il est possible de le réinstaller avec des paquets fournis par la fondation Python Software. Un des avantages de ces installeurs est que la version Python propre à macOS et utilisée en interne par le système d’exploitation n’est pas touchée.

Note

Il sera alors nécessaire de modifier la variable d’environnement PATH dans votre fichier .profile afin que la nouvelle version de Python soit utilisée lorsque vous saisissez python dans la ligne de commande :

export PATH=/Library/Frameworks/Python.framework/Versions/Current/bin:$PATH

Postgres.app

Postgres.app est un serveur PostgreSQL indépendant qui inclut l’extension PostGIS. Il sera aussi nécessaire d’installer gdal et libgeoip avec Homebrew.

Après avoir installé Postgres.app, ajoutez ce qui suit à votre fichier .bash_profile afin de pouvoir exécuter les programmes correspondants à partir de la ligne de commande. Remplacez X.Y par la version de PostgreSQL dans le paquet Postgres.app que vous avez installé :

export PATH=$PATH:/Applications/Postgres.app/Contents/Versions/X.Y/bin

Vous pouvez vérifier si le chemin est correctement défini en tapant which psql dans une invite de commande.

Homebrew

Homebrew met à disposition des « recettes » pour la compilation de binaires et de paquets à partir des sources. Il fournit des recettes pour les prérequis de GeoDjango sur les ordinateurs Macintosh tournant sous macOS. Dans la mesure où Homebrew compile les logiciels à partir de leurs sources, Xcode est indispensable.

En résumé :

$ brew install postgresql
$ brew install postgis
$ brew install gdal
$ brew install libgeoip
Fink

Kurt Schwehr a eu la bonté de créer des paquets GeoDjango pour les utilisateurs du système de paquets Fink. Différents paquets sont disponibles (commençant par django-gis), en fonction de la version de Python que vous souhaitez utiliser.

MacPorts

MacPorts peut être utilisé pour installer les prérequis de GeoDjango sur les ordinateurs tournant sous macOS. Dans la mesure où MacPorts compile les logiciels à partir de leurs sources, Xcode est indispensable.

En résumé :

$ 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

Note

Il sera aussi nécessaire de modifier la variable d’environnement PATH dans votre fichier .profile afin que les programmes MacPorts soient accessibles dans la ligne de commande :

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

De plus, ajoutez le réglage DYLD_FALLBACK_LIBRARY_PATH afin que les bibliothèques puissent être trouvées par Python :

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

Windows

Suivez scrupuleusement l’ordre des sections suivantes afin d’installer GeoDjango sur Windows. Dans ce tutoriel, nous installerons les versions 64 bits de chaque application.

Python

Installez une version 64 bits de Python. Voir Installation de Python pour plus d’informations.

PostgreSQL

Téléchargez la dernière version de l”installeur PostgreSQL 15.x à partir du site web EnterpriseDB. Puis, lancez cet installeur, suivez les instructions qui apparaissent et conservez les options par défaut, sauf si vous connaissez les conséquences de leur modification.

Note

L’installeur PostgreSQL crée un nouveau superutilisateur de base de données nommé postgres. On vous demandera une seule fois de définir le mot de passe, prenez garde de bien vous en souvenir !

Lorsque l’installeur a terminé, il demande de lancer Stack Builder en quittant. Laissez cette option cochée, car c’est nécessaire pour installer PostGIS.

Note

En cas d’installation réussie, le serveur PostgreSQL tourne en arrière-plan à chaque démarrage du système sous forme de service Windows. Un groupe de menu de démarrage PostgreSQL 15 sera créé pour contenir des raccourcis pour les programmes Application Stack Builder (ASB) et SQL Shell ; ce dernier lance une commande psql dans une fenêtre de commandes.

PostGIS

À partir du programme Stack Builder (à lancer en dehors de l’installeur, Démarrer ‣ PostgreSQL 15 ‣ Application Stack Builder), choisissez PostgreSQL 15 (x64) on port 5432 dans le menu déroulant et cliquez sur Suivant. Ouvrez l’arborescence de menu Categories ‣ Spatial Extensions et choisissez PostGIS X.Y for PostgreSQL 15.

Après avoir cliqué sur suivant, vous devez confirmer le paquet sélectionné et le « Download directory ». Cliquez une nouvelle fois sur suivant, PostGIS sera téléchargé et vous devrez encore cliquer sur suivant pour lancer l’installeur PostGIS. Choisissez les options par défaut lors de l’installation. Le processus d’installation contient quatre boîtes de dialogue Oui/Non, l’option par défaut étant Non pour les quatre.

OSGeo4W

L”installeur OSGeo4W aide à l’installation des bibliothèques PROJ, GDAL et GEOS requises par GeoDjango. Commencez par télécharger l”`installeur OSGeo4W`_ et exécutez-le. Choisissez Express Web-GIS Install et cliquez sur suivant. Dans la liste de sélection des paquets, contrôlez que GDAL est sélectionné. Si d’autres paquets sont sélectionnés par défaut, ils ne sont pas nécessaires pour GeoDjango et peuvent être désélectionnés sans problème. Après avoir cliqué sur suivant et accepté l’accord de licence, les paquets sont automatiquement téléchargés et installés ; vous pouvez ensuite quitter l’installeur.

Modification de l’environnement Windows

Afin de pouvoir utiliser GeoDjango, il est nécessaire d’ajouter les répertoires OSGeo4W au chemin Path du système Windows. Il faut également créer les variables d’environnement GDAL_DATA et PROJ_LIB. Les commandes ci-après, exécutables avec cmd.exe configurent tout cela. Redémarrez votre appareil une fois que tout est terminé afin que les nouvelles variables d’environnement soient reconnues :

set OSGEO4W_ROOT=C:\OSGeo4W
set GDAL_DATA=%OSGEO4W_ROOT%\apps\gdal\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%"

Note

Il est nécessaire de disposer des droits d’administrateur pour exécuter ces commandes. Dans ce but, lancez une invite de commande en mode administrateur et saisissez les commandes ci-dessus. Vous devez vous déconnecter puis vous reconnecter pour que ces réglages s’appliquent réellement.

Note

Si vous avez personnalisé les répertoires d’installation de OSGeo4W, vous devrez alors aussi modifier de façon cohérente les variables OSGEO4W_ROOT.

Installation de Django et configuration de base de données

Installez Django sur votre système. Il est recommandé de créer un environnement virtuel pour chaque projet que vous créez.

psycopg

Le module Python psycopg fournit l’interface entre Python et la base de données PostgreSQL. psycopg peut être installé par pip dans votre environnement virtuel Python :

...\> py -m pip install psycopg

Notes de bas de page

[1]GeoDjango utilise la routine find_library() de ctypes.util pour trouver les bibliothèques partagées.
Back to Top