Requiere la instalación generalmente de:
base_de_datos_geoespacial
Detalles de cada uno de los requisitos y las instrucciones de instalación se proporcionan en las secciones que siguen a continuación. Además, están disponibles instrucciones específicas para cada plataforma:
ventanas
Usa la Fuente
Porque GeoDjango aprovecha las últimas tecnologías de software geoespacial de código abierto, son necesarias versiones recientes de las bibliotecas. Si no están disponibles paquetes binarios para tu plataforma, puede ser necesario instalar desde la fuente. Al compilar las bibliotecas desde la fuente, por favor sigue las instrucciones con cuidado, especialmente si eres un principiante.
Porque GeoDjango está incluido en Django, por favor consulta las instrucciones de instalación de Django para obtener detalles sobre cómo instalarlo.
PostgreSQL (con PostGIS), MySQL, Oracle y SQLite (con SpatiaLite) son las bases de datos espaciales actualmente soportadas.
Nota
Se recomienda PostGIS, porque es la base de datos espacial de código abierto más madura y rica en características.
Las bibliotecas geoespaciales necesarias para una instalación GeoDjango dependen de la base de datos espacial utilizada. A continuación se listan los requisitos de biblioteca, versiones soportadas y notas para cada uno de los backends de bases de datos soportados:
Base de datos |
Requisitos de Bibliotecas |
Supported Versions |
Notas |
|---|---|---|---|
PostgreSQL |
GEOS, GDAL, PROJ, PostGIS |
14+ |
Requiere PostGIS. |
MySQL |
GEOS, GDAL |
8.0.11+ |
|
Oracle |
GEOS, GDAL |
19+ |
No se admite XE. |
SQLite |
GEOS, GDAL, PROJ, SpatiaLite |
3.31.0+ |
Requiere SpatiaLite 4.3+ |
Consulta también la `matriz de comparación`__ en el Wiki OSGeo para combinaciones posibles de PostgreSQL/PostGIS/GEOS/GDAL.
DATABASES¶Establece la configuración del parámetro ENGINE en uno de los backends espaciales:ref:spatial-backends.
django.contrib.gis a INSTALLED_APPS¶Al igual que otras aplicaciones contribuyentes de Django, solo necesitarás agregar django.contrib.gis a INSTALLED_APPS en tus configuraciones. Esto es para que los templates gis puedan ser localizados – si no se hace, entonces características como el administrador geográfico o las cartografías KML no funcionarán correctamente.
Si no encuentras la solución a tu problema aquí, participa en la comunidad. Puedes:
Pregúntale en el foro de GeoDjango.
Presenta un informe de incidencia en el `Django trac`__ si crees que hay un error. Asegúrate de proporcionar una descripción completa del problema, las versiones utilizadas y especifica el componente como «GIS».
Por lo general, el problema más común al instalar GeoDjango es que las bibliotecas compartidas externas (por ejemplo, para GEOS y GDAL) no pueden ser localizadas. [1] Normalmente, la causa de este problema es que el sistema operativo no está informado del directorio donde se instalaron las bibliotecas construidas desde fuentes.
En general, el camino de la biblioteca puede estar configurado en una base por usuario estableciendo una variable de entorno, o configurando el camino de la biblioteca para todo el sistema.
LD_LIBRARY_PATH¶Un usuario puede establecer esta variable de entorno para personalizar los directorios de bibliotecas que desee utilizar. El directorio típico de bibliotecas para software construido a partir de fuentes es /usr/local/lib. Por lo tanto, /usr/local/lib necesita incluirse en la variable LD_LIBRARY_PATH. Por ejemplo, el usuario podría colocar lo siguiente en su perfil de bash:
export LD_LIBRARY_PATH=/usr/local/lib
En sistemas GNU/Linux, típicamente hay un archivo en /etc/ld.so.conf, que puede incluir rutas adicionales de archivos en otro directorio, como /etc/ld.so.conf.d. Como usuario root, agrega la ruta personalizada de bibliotecas (como /usr/local/lib) en una nueva línea en ld.so.conf. Este es un ejemplo de cómo hacerlo:
$ sudo echo /usr/local/lib >> /etc/ld.so.conf
$ sudo ldconfig
Los usuarios de OpenSolaris pueden modificar el camino del sistema de bibliotecas utilizando la utilidad crle. Ejecuta crle sin opciones para ver la configuración actual y utiliza crle -l para establecer con el nuevo camino de bibliotecas. Sé muy cuidadoso al modificar el camino del sistema de bibliotecas:
# crle -l $OLD_PATH:/usr/local/lib
binutils¶GeoDjango utiliza la función find_library (del módulo Python ctypes.util) para descubrir bibliotecas. La rutina find_library utiliza un programa llamado objdump (parte del paquete binutils) para verificar una biblioteca compartida en sistemas GNU/Linux. Por lo tanto, si binutils no está instalado en tu sistema Linux entonces Python’s ctypes puede que no pueda encontrar tu biblioteca incluso si el camino de la biblioteca está configurado correctamente y las bibliotecas geoespaciales se construyeron perfectamente.
El paquete binutils puede ser instalado en sistemas Debian y Ubuntu utilizando el siguiente comando:
$ sudo apt-get install binutils
De manera similar, en sistemas Red Hat y CentOS:
$ sudo yum install binutils
Por la variedad de sistemas de paquetes disponibles para macOS, los usuarios tienen varias opciones diferentes para instalar GeoDjango. Estas opciones son:
Postgres.app (más fácil y recomendado)
:fink
:macports
:build_from_source
Esta sección también incluye instrucciones para instalar una versión actualizada de :macos_python desde paquetes proporcionados por la Fundación del Software Python, sin embargo, esto no es necesario.
Aunque macOS viene con Python instalado, los usuarios pueden utilizar `instaladores de marco`__ proporcionados por la Fundación del Software Python. Una ventaja al usar el instalador es que el Python de macOS permanecerá «puro» para uso interno del sistema operativo.
Nota
Deberás modificar la variable de entorno PATH en tu archivo .profile para que se utilice la nueva versión de Python cuando se ingrese python en la línea de comandos:
export PATH=/Library/Frameworks/Python.framework/Versions/Current/bin:$PATH
Postgres.app es un servidor PostgreSQL independiente que incluye la extensión PostGIS. También necesitarás instalar gdal y libgeoip con :homebrew.
Después de instalar Postgres.app, agrega lo siguiente a tu .bash_profile para poder ejecutar los programas del paquete desde la línea de comandos. Reemplaza X.Y con la versión de PostgreSQL en el Postgres.app que instalaste:
export PATH=$PATH:/Applications/Postgres.app/Contents/Versions/X.Y/bin
Puedes verificar si la ruta está configurada correctamente escribiendo which psql en una ventana de terminal.
`Homebrew`__ proporciona «recetas» para construir binarios y paquetes a partir de fuentes. Proporciona recetas para las prerequisitos de GeoDjango en computadoras Macintosh que ejecutan macOS. Dado que Homebrew sigue construyendo el software a partir de fuentes, Xcode es requerido.
Resumen:
$ brew install postgresql
$ brew install postgis
$ brew install gdal
$ brew install libgeoip
`Kurt Schwehr`__ ha sido lo suficientemente amable como para crear paquetes GeoDjango para usuarios del sistema de paquetes `Fink`__. Están disponibles diferentes paquetes (comenzando con django-gis), dependiendo de la versión de Python que desee utilizar.
`MacPorts`__ puede usarse para instalar las prerequisitos de GeoDjango en computadoras que ejecutan macOS. Dado que MacPorts sigue construyendo el software a partir de fuentes, Xcode es requerido.
Resumen:
$ sudo port install postgresql14-server
$ sudo port install geos
$ sudo port install proj6
$ sudo port install postgis3
$ sudo port install gdal
$ sudo port install libgeoip
Nota
También deberás modificar la variable PATH en tu archivo .profile para que los programas de MacPorts sean accesibles desde la línea de comandos:
export PATH=/opt/local/bin:/opt/local/lib/postgresql14/bin
Además, agrega la configuración DYLD_FALLBACK_LIBRARY_PATH para que las bibliotecas puedan ser encontradas por Python:
export DYLD_FALLBACK_LIBRARY_PATH=/opt/local/lib:/opt/local/lib/postgresql14
Pasa por las siguientes secciones de forma secuencial para instalar GeoDjango en Windows. En este tutorial instalaremos versiones 64 bits de cada aplicación.
Instala una versión 64 bits de Python. Consulta Instalar Python para obtener más información.
Descarga el último `instalador PostgreSQL 15.x`__ desde el sitio web `EnterpriseDB`__. Después de descargarlo, ejecuta el instalador, sigue las instrucciones en pantalla y mantén las opciones predeterminadas a menos que sepas las consecuencias de cambiarlas.
Nota
El instalador de PostgreSQL crea un superusuario de base de datos postgres. Se te pedirá una vez que establezcas la contraseña – asegúrate de recordarla!
Cuando el instalador complete su proceso, te preguntará si quieres «Iniciar el Constructor de Pilas al salir?» – mantén esta opción seleccionada, ya que es necesario para instalar PostGIS.
Nota
Si se ha instalado correctamente, el servidor PostgreSQL funcionará en segundo plano cada vez que arranques el sistema como un servicio de Windows. Se creará un grupo de inicio de sesión PostgreSQL 15 y contendrá atajos para el Constructor de Pilas (ASB) así como la “Concha SQL”, lo que lanzará una ventana de comando psql.
Desde dentro del Constructor de Pilas (para ejecutarlo fuera del instalador, ), selecciona desde el menú desplegable y haz clic en siguiente. Amplía el árbol de menú Categorías --> Extensiones espaciales y selecciona .
Después de hacer clic en siguiente, se te pedirá que confirmes la paquetería seleccionada y el directorio de descarga. Haz clic en siguiente nuevamente, lo que descargará PostGIS y te preguntará que hagas clic en siguiente para comenzar con el instalador de PostGIS. Selecciona las opciones predeterminadas durante la instalación. El proceso de instalación incluye cuatro cuadros de diálogo Yes/No, la opción predeterminada para todos ellos es «No».
El instalador OSGeo4W ayuda a instalar las bibliotecas PROJ, GDAL y GEOS requeridas por GeoDjango. Primero, descarga el `instalador OSGeo4W`_, y ejecútalo. Selecciona y haz clic en siguiente. En la lista de “Paquetes”, asegúrate de que GDAL esté seleccionado. Si cualquier otro paquete está habilitado por defecto, no son necesarios para GeoDjango y pueden desmarcarse con seguridad. Después de hacer clic en siguiente y aceptar los acuerdos de licencia, los paquetes se descargarán e instalarán automáticamente, después de lo cual puedes salir del instalador.
Para utilizar GeoDjango, necesitarás agregar tus directorios OSGeo4W a tu sistema Path de Windows, así como crear las variables de entorno GDAL_DATA y PROJ_LIB. El siguiente conjunto de comandos, ejecutable con cmd.exe, configurará esto. Reinicia tu dispositivo una vez que esté completo para que los nuevos variables de entorno sean reconocidos:
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%"
Nota
Se requieren privilegios de administrador para ejecutar estos comandos. Para hacer esto, ejecuta la ventana de comando como administrador y entra en los comandos anteriores. Necesitarás cerrar sesión y volver a iniciar sesión nuevamente para que los ajustes surtan efecto.
Nota
Si personalizaste los directorios de instalación OSGeo4W, entonces necesitarás modificar las variables OSGEO4W_ROOT en consecuencia.
Instala Django en tu sistema. Se recomienda que crees un entorno virtual para cada proyecto que creas.
El módulo Python psycopg proporciona la interfaz entre Python y la base de datos PostgreSQL. psycopg se puede instalar mediante pip dentro de tu entorno virtual Python:
...\> py -m pip install psycopg
Notas al pie
may 31, 2026