`SpatiaLite`__ agrega soporte espacial a SQLite, convirtiéndolo en una base de datos espacial completa.
Primero, verifica si puedes instalar SpatiaLite desde paquetes del sistema o binarios.
Por ejemplo, en distribuciones basadas en Debian que empaqueta SpatiaLite 4.3+, intenta instalar el paquete libsqlite3-mod-spatialite. Para versiones anteriores, instala spatialite-bin.
Para macOS, sigue las instrucciones a continuación.
Para Windows, puedes encontrar binarios en la página de inicio de `Gaia-SINS`__.
En cualquier caso, siempre deberías poder instalar desde fuente.
GEOS y PROJ debe ser instalado antes de construir SpatiaLite.
Primero comprueba si SQLite está compilado con el módulo R*Tree. Ejecuta la interfaz de línea de comandos sqlite3 y entra en la siguiente consulta:
sqlite> CREATE VIRTUAL TABLE testrtree USING rtree(id,minX,maxX,minY,maxY);
Si obtienes un error, deberás recompilar SQLite desde fuentes. De lo contrario, omite esta sección.
Para instalar desde fuentes, descarga el último archivo de fuente amalgamado desde la `página de descargas de SQLite`<https://www.sqlite.org/download.html>__, y extrae:
$ wget https://www.sqlite.org/YYYY/sqlite-amalgamation-XXX0000.zip
$ unzip sqlite-amalgamation-XXX0000.zip
$ cd sqlite-amalgamation-XXX0000
A continuación, ejecuta el script configure – sin embargo, la variable de entorno CFLAGS necesita ser personalizada para que SQLite sepa construir el módulo R*Tree:
$ CFLAGS="-DSQLITE_ENABLE_RTREE=1" ./configure
$ make
$ sudo make install
$ cd ..
libspatialite)¶Obtén el último paquete de fuentes de la biblioteca SpatiaLite desde la `página de descargas`<https://www.gaia-gis.it/fossil/libspatialite/index>__:
$ wget https://www.gaia-gis.it/gaia-sins/libspatialite-sources/libspatialite-X.Y.Z.tar.gz
$ tar xaf libspatialite-X.Y.Z.tar.gz
$ cd libspatialite-X.Y.Z
$ ./configure
$ make
$ sudo make install
Nota
Para usuarios de macOS que construyen desde fuentes, tanto la biblioteca como las herramientas de SpatiaLite necesitan tener su target configurado:
$ ./configure --target=macosx
Para instalar la biblioteca y las herramientas de SpatiaLite, los usuarios de macOS pueden utilizar Homebrew.
Homebrew gestiona todos los paquetes relacionados con SpatiaLite en tu nombre, incluyendo SQLite, SpatiaLite, PROJ y GEOS. Instálalos de la siguiente manera:
$ brew update
$ brew install spatialite-tools
$ brew install gdal
Finalmente, para que GeoDjango pueda encontrar la biblioteca SpatiaLite, establece el parámetro SPATIALITE_LIBRARY_PATH en su ruta. Esto se encontrará dentro del camino de instalación de brew, que puedes verificar con:
$ brew --prefix
/opt/homebrew
Con este camino de instalación de brew, la ruta completa se puede construir de la siguiente manera:
SPATIALITE_LIBRARY_PATH = "/opt/homebrew/lib/mod_spatialite.dylib"
may 31, 2026