GeoDjango utilise et fournit des interfaces pour les bibliothèques géospatiales libres suivantes :
\nProgramme | \nDescription | \nRequis | \nVersions prises en charge | \n
|---|---|---|---|
| \n | Geometry Engine Open Source | \nOui | \n3.8, 3.7, 3.6, 3.5 | \n
| \n | Bibliothèque de projections cartographiques | \nOui (uniquement PostgreSQL et SQLite) | \n6.3, 6.2, 6.1, 6.0, 5.x, 4.x | \n
| \n | Bibliothèque | \nOui | \n3.1, 3.0, 2.4, 2.3, 2.2, 2.1, 2.0 | \n
| \n | Bibliothèque de géolocalisation basée sur IP | \nNon | \n2 | \n
| \n | Extensions spatiales pour PostgreSQL | \nOui (uniquement PostgreSQL) | \n3.0, 2.5, 2.4, 2.3, 2.2 | \n
| \n | Extensions spatiales pour SQLite | \nOui (uniquement SQLite) | \n4.3 | \n
Notez que des versions plus anciennes ou plus récentes de ces bibliothèques peuvent aussi très bien fonctionner avec GeoDjango. À vous de voir.
\n\nSur Debian/Ubuntu, il est conseillé d’installer les paquets suivants qui installeront, directement ou par l’intermédiaire de dépendances, les bibliothèques géospatiales nécessaires :
\n$ sudo apt-get install binutils libproj-dev gdal-bin\nVeuillez également consulter les instructions spécifiques si vous utilisez macOS ou Windows.
\nLors de l’installation à partir des sources sur les systèmes UNIX et GNU/Linux, suivez consciencieusement les instructions d’installation et installer les bibliothèques dans l’ordre indiqué. Si vous utilisez MySQL ou Oracle comme base de données spatiale, seul GEOS est nécessaire.
\n\n\nGEOS est une bibliothèque C++ destinée aux opérations géométriques et constitue la représentation géométrique interne par défaut que GeoDjango utilise (derrière les objets géométriques « différés »). Spécifiquement, l’API de la bibliothèque C (par ex. libgeos_c.so) est appelée directement depuis Python à l’aide de ctypes.
Premièrement, téléchargez GEOS à partir du site Web GEOS et décompressez l’archive des sources :
\n$ wget https://download.osgeo.org/geos/geos-X.Y.Z.tar.bz2\n$ tar xjf geos-X.Y.Z.tar.bz2\nPuis, placez-vous dans le répertoire où GEOS a été décompressé et lancez le script « configure », compilez et installez :
\n$ cd geos-X.Y.Z\n$ ./configure\n$ make\n$ sudo make install\n$ cd ..\nLorsque GeoDjango ne peut pas trouver GEOS, cette erreur apparaît :
\nImportError: Could not find the GEOS library (tried "geos_c"). Try setting GEOS_LIBRARY_PATH in your settings.\nLa solution la plus courante est de configurer correctement Réglages d’environnement de bibliothèques ou de définir GEOS_LIBRARY_PATH dans vos réglages.
\nSi vous utilisez un paquet binaire de GEOS (par ex. sur Ubuntu), il peut être utile de Installation de binutils.
\nGEOS_LIBRARY_PATHLien vers cette rubrique#Si votre bibliothèque GEOS se trouve à un emplacement non standard ou que vous ne souhaitez pas modifier le chemin des bibliothèques système, il est possible d’ajouter le réglage GEOS_LIBRARY_PATH dans votre fichier de réglages Django et d’y indiquer le chemin complet vers la bibliothèque GEOS en C. Par exemple :
GEOS_LIBRARY_PATH = '/home/bob/local/lib/libgeos_c.so'\nVoir aussi Mes fichiers journaux sont remplis d’erreurs liées à GEOS.
\nPROJ.4 est une bibliothèque de conversion de données géospatiales vers différents systèmes de référence de coordonnées.
\nPremièrement, téléchargez le code source de PROJ.4 et les fichiers de données associés (« datum shifting files ») [1] :
\n$ wget https://download.osgeo.org/proj/proj-X.Y.Z.tar.gz\n$ wget https://download.osgeo.org/proj/proj-datumgrid-X.Y.tar.gz\nNext, untar the source code archive, and extract the datum shifting files in the\ndata subdirectory (use nad subdirectory for PROJ < 6.x). This must be\ndone prior to configuration:
$ tar xzf proj-X.Y.Z.tar.gz\n$ cd proj-X.Y.Z/data\n$ tar xzf ../../proj-datumgrid-X.Y.tar.gz\n$ cd ..\nPour terminer, lancez « configure » et « make » et installez PROJ.4 :
\n$ ./configure\n$ make\n$ sudo make install\n$ cd ..\nGDAL est une excellente bibliothèque géospatiale libre capable de lire la plupart des formats de données spatiales vectoriels et matriciels. Actuellement, GeoDjango ne prend en charge que les fonctionnalités des données vectorielles de GDAL [2]. GEOS et PROJ.4 devraient être installés avant de compiler GDAL.
\nTéléchargez d’abord la dernière version publiée de GDAL et décompressez l’archive :
\n$ wget https://download.osgeo.org/gdal/X.Y.Z/gdal-X.Y.Z.tar.gz\n$ tar xzf gdal-X.Y.Z.tar.gz\n$ cd gdal-X.Y.Z\nLancez les opérations « configure », « make » et « install » :
\n$ ./configure\n$ make # Go get some coffee, this takes a while.\n$ sudo make install\n$ cd ..\nSi vous rencontrez un problème, consultez la section dépannage ci-dessous pour y trouver des suggestions et des solutions.
\nLorsque GeoDjango ne peut pas trouver la bibliothèque GDAL, configurez vos Réglages d’environnement de bibliothèques ou définissez GDAL_LIBRARY_PATH dans vos réglages.
\nGDAL_LIBRARY_PATHLien vers cette rubrique#Si votre bibliothèque GDAL se trouve à un emplacement non standard ou que vous ne souhaitez pas modifier le chemin des bibliothèques système, il est possible d’ajouter le réglage GDAL_LIBRARY_PATH dans votre fichier de réglages Django et d’y indiquer le chemin complet vers la bibliothèque GDAL. Par exemple :
GDAL_LIBRARY_PATH = '/home/sue/local/lib/libgdal.so'\nNotes de bas de page
\n\n