Installing Geospatial libraries
Django Docs · نسخهٔ 33d2e5948a0b · BSD-3-Clause
===============================
Installing Geospatial libraries
GeoDjango uses and/or provides interfaces for the following open source geospatial libraries:
======================== ==================================== ================================ ================================================= Program Description Required Supported Versions ======================== ==================================== ================================ ================================================= GEOS Geometry Engine Open Source Yes 3.13, 3.12, 3.11, 3.10, 3.9, 3.8 PROJ_ Cartographic Projections library Yes (PostgreSQL and SQLite only) 9.x, 8.x, 7.x, 6.x GDAL Geospatial Data Abstraction Library Yes 3.10, 3.9, 3.8, 3.7, 3.6, 3.5, 3.4, 3.3, 3.2, 3.1 GeoIP IP-based geolocation library No 2 PostGIS__ Spatial extensions for PostgreSQL Yes (PostgreSQL only) 3.4, 3.3, 3.2, 3.1 SpatiaLite__ Spatial extensions for SQLite Yes (SQLite only) 5.1, 5.0, 4.3 ======================== ==================================== ================================ =================================================
Note that older or more recent versions of these libraries *may* also work totally fine with GeoDjango. Your mileage may vary.
.. Libs release dates: GEOS 3.8.0 2019-10-10 GEOS 3.9.0 2020-12-14 GEOS 3.10.0 2021-10-20 GEOS 3.11.0 2022-07-01 GEOS 3.12.0 2023-06-27 GEOS 3.13.0 2024-09-06 GDAL 3.1.0 2020-05-07 GDAL 3.2.0 2020-11-02 GDAL 3.3.0 2021-05-03 GDAL 3.4.0 2021-11-04 GDAL 3.5.0 2022-05-13 GDAL 3.6.0 2022-11-03 GDAL 3.7.0 2023-05-10 GDAL 3.8.0 2023-11-13 GDAL 3.9.0 2024-05-10 GDAL 3.10.0 2024-11-06 PostGIS 3.1.0 2020-12-18 PostGIS 3.2.0 2021-12-18 PostGIS 3.3.0 2022-08-27 PostGIS 3.4.0 2023-08-15 PROJ 9.0.0 2022-03-01 PROJ 8.0.0 2021-03-01 PROJ 8.0.0 2021-03-01 PROJ 7.0.0 2020-02-25 PROJ 6.0.0 2019-02-26 SpatiaLite 4.3.0 2015-09-07 SpatiaLite 5.0.0 2020-08-23 SpatiaLite 5.1.0 2023-08-04
The GeoDjango interfaces to GEOS, GDAL, and GeoIP may be used independently of Django. In other words, no database or settings file required -- import them as normal from django.contrib.gis.
__ https://postgis.net/ __ https://www.gaia-gis.it/gaia-sins/
On Debian/Ubuntu, you are advised to install the following packages which will install, directly or by dependency, the required geospatial libraries:
$ sudo apt-get install binutils libproj-dev gdal-binPlease also consult platform-specific instructions if you are on macos or windows.
Building from source
When installing from source on UNIX and GNU/Linux systems, please follow the installation instructions carefully, and install the libraries in the given order. If using MySQL or Oracle as the spatial database, only GEOS is required.
On Linux platforms, it may be necessary to run the `ldconfig` command after installing each library. For example:
$ sudo make install
$ sudo ldconfigmacOS users must install Xcode_ in order to compile software from source.
GEOS
GEOS is a C++ library for performing geometric operations, and is the default internal geometry representation used by GeoDjango (it's behind the "lazy" geometries). Specifically, the C API library is called (e.g., `libgeos_c.so`) directly from Python using ctypes.
First, download GEOS from the GEOS website and untar the source archive:
$ wget https://download.osgeo.org/geos/geos-X.Y.Z.tar.bz2
$ tar xjf geos-X.Y.Z.tar.bz2Then step into the GEOS directory, create a `build` folder, and step into it:
$ cd geos-X.Y.Z
$ mkdir build
$ cd buildThen build and install the package:
$ cmake -DCMAKE_BUILD_TYPE=Release ..
$ cmake --build .
$ sudo cmake --build . --target installTroubleshooting
Can't find GEOS library
When GeoDjango can't find GEOS, this error is raised:
ImportError: Could not find the GEOS library (tried "geos_c"). Try setting GEOS_LIBRARY_PATH in your settings.The most common solution is to properly configure your libsettings *or* set geoslibrarypath in your settings.
If using a binary package of GEOS (e.g., on Ubuntu), you may need to binutils.
`GEOS_LIBRARY_PATH`
If your GEOS library is in a non-standard location, or you don't want to modify the system's library path then the GEOS_LIBRARY_PATH setting may be added to your Django settings file with the full path to the GEOS C library. For example:
GEOS_LIBRARY_PATH = '/home/bob/local/lib/libgeos_c.so'The setting must be the *full* path to the C shared library; in other words you want to use `libgeos_c.so, not libgeos.so`.
See also My logs are filled with GEOS-related errors <geos-exceptions-in-logfile>.
PROJ
PROJ_ is a library for converting geospatial data to different coordinate reference systems.
First, download the PROJ source code:
$ wget https://download.osgeo.org/proj/proj-X.Y.Z.tar.gz... and datum shifting files (download `proj-datumgrid-X.Y.tar.gz` for PROJ < 7.x) [#]_:
$ wget https://download.osgeo.org/proj/proj-data-X.Y.tar.gzNext, untar the source code archive, and extract the datum shifting files in the `data` subdirectory. This must be done *prior* to configuration:
$ tar xzf proj-X.Y.Z.tar.gz
$ cd proj-X.Y.Z/data
$ tar xzf ../../proj-data-X.Y.tar.gz
$ cd ../..For PROJ 9.x and greater, releases only support builds using `CMake (see PROJ RFC-7`_).
To build with `CMake ensure your system meets the build requirements_. Then create a build` folder in the PROJ directory, and step into it:
$ cd proj-X.Y.Z
$ mkdir build
$ cd buildFinally, configure, make and install PROJ:
$ cmake ..
$ cmake --build .
$ sudo cmake --build . --target installGDAL
GDAL__ is an excellent open source geospatial library that has support for reading most vector and raster spatial data formats. Currently, GeoDjango only supports GDAL's vector data capabilities [#]_. geosbuild and proj4 should be installed prior to building GDAL.
First download the latest GDAL release version and untar the archive:
$ wget https://download.osgeo.org/gdal/X.Y.Z/gdal-X.Y.Z.tar.gz
$ tar xzf gdal-X.Y.Z.tar.gzFor GDAL 3.6.x and greater, releases only support builds using `CMake. To build with CMake create a build` folder in the GDAL directory, and step into it:
$ cd gdal-X.Y.Z
$ mkdir build
$ cd buildFinally, configure, make and install GDAL:
$ cmake ..
$ cmake --build .
$ sudo cmake --build . --target installIf you have any problems, please see the troubleshooting section below for suggestions and solutions.
__ https://gdal.org/
Troubleshooting
Can't find GDAL library
When GeoDjango can't find the GDAL library, configure your libsettings *or* set gdallibrarypath in your settings.
`GDAL_LIBRARY_PATH`
If your GDAL library is in a non-standard location, or you don't want to modify the system's library path then the GDAL_LIBRARY_PATH setting may be added to your Django settings file with the full path to the GDAL library. For example:
GDAL_LIBRARY_PATH = '/home/sue/local/lib/libgdal.so'certain projections. For example, the PROJ string for the Google projection (900913 or 3857) <https://spatialreference.org/ref/epsg/3857/>_ requires the `null grid file only included in the extra datum shifting files. It is easier to install the shifting files now, then to have debug a problem caused by their absence later. <https://gdal.org/user/vector_data_model.html>_ library, a component of GDAL.