Skip to main content

Django geographic store and vector tile generation

Project description

Build Status codecov Maintainability Documentation Status

Python Version Django Version


Dynamic geographic datastore with Vector Tiles generation from PostGIS and json schema definition and validation.



  • Python 3.6+
  • Postgresql 10+
  • PostGIS 2.4+

Optionnal to use PgRouting functionnalities :

  • PgRouting 2.5+


these are debian packages required

  • libpq-dev (psycopg2)
  • gettext (translations)
  • binutils (django.contrib.gis)
  • libproj-dev (django.contrib.gis)
  • gdal-bin (django.contrib.gis)


  • postgresql-client (if you want to use ./ dbshell command)


from PYPI

pip install django-geostore

from GitHub

git clone
cd django-geostore
python3 install

in your project settings

    #'geostore.routing'  # uncomment to enable routing functionality


with docker :

docker-compose build
docker-compose up
docker-compose run web ./ test

with pip :

python3.6 -m venv venv
source activate venv/bin/activate
pip install -e .[dev]


0.4.0 (2020-09-02)

  • WARNING Breaking Changes !!

    • to continue to use PGRouting features, please add geostore.routing to INSTALLED_APPS
    • Some changes in routing API response. Now final geometry and full feature segment list are provided by API
    • Configurable tolerance for routing topologies (Default value from 0.0001 to 0.00001)
    • HOSTNAME setting is deprecated. Default request HOST is now used to generate absolute full urls for vector tiles. You can set TERRA_TILES_HOSTNAMES = [HOSTNAME, ] to avoid this
  • Improvements :

    • Officially support django 3.1
    • Set HOSTNAME or TERRA_TILES_HOSTNAMES is not required anymore. Now full absolute urls are prefixed with current host request
    • Installing PGRouting is not required anymore.
    • source / target routing attributes :
      • add indexes
      • Hide by default (editable=False)
    • Using JSONField from django.db.models
    • Updating DjangoModelFactory location

0.3.19 (2020-06-25)

  • WARNING : Ordering and Searching in feature properties are disabled for layers without schema.
  • OPTIMIZATIONS : Improve API feature by disabling big queries to find layer's properties
  • Fix duplicated index

0.3.18 (2020-06-24)

  • Improve database indexes

0.3.17 (2020-03-04)

  • Factorize Feature Extra Geom serializer to be customized directly in ViewsSet

0.3.16 (2020-01-27)

  • Manage relations between layers and features (manual / intersections or distances).
  • GeoJson renderer. Now API can render .json or .geojson endpoint (or format=?geojson)
  • Partial properties patch. A patch on feature viewset keep properties not sended.
  • Add Json value search filter in FeatureViewset

0.3.15 (2019-12-13)

  • support django rest framework 3.11

0.3.14 (2019-12-11)

  • Officially support django 3.0
  • Add possibility to modify, create, update, delete extra geometries
  • Add field editable to extra layers

0.3.13 (2019-12-09)

  • Order extra geometries by layer

0.3.12 (2019-12-03)


  • Improve documentation


  • Ability to define and package extra geometries for features (One to One)

0.3.11 (2019-11-05)


  • Prevent token group id decoding error

0.3.10 (2019-10-16)


  • Ability to sort API feature results with property key content


  • Add missing migration file

0.3.9 (2019-10-15)

  • Admin part is removed. Please use your own admin in project.
  • DRF yasg is removed. Configure it in your project if required.
  • Add authentication management on layers

0.3.8 (2019-10-11)


  • Add permission management on FeatureViewset

0.3.7 (2019-10-09)


  • Fix tilejson's layer attribution and description parsing

0.3.6 (2019-10-09)


  • Fix tilejson when Layer has no Feature
  • Fix deprecation warning : "ST_Line_Substring signature was deprecated in 2.1.0. Please use ST_LineSubstring"
  • Fix tile generation when no feature is present in the layer
  • Fix permission management of layers

0.3.5 (2019-10-03)


  • Add a method to get json schema property type by its name


  • Fix bug with shapefile export on geometry defined layer.
  • Fix group's tiles URLs in tilejson
  • Fix tilejson when Layer has no Feature
  • Return a tilejson even if it has no feature

0.3.4 (2019-09-26)


  • integrate test/factories in packaging

0.3.3 (2019-09-25)

Breaking Changes with front

  • key to access tilejson is changed from 'layer_tilejson' and 'group_tilejson' to 'tilejson' in both cases.


  • Fix migration file that prevent old terracommon app migration

0.3.2 (2019-09-24)


  • Fix migration file that prevent old terracommon app migration

0.3.1 (2019-09-11)

Breaking Changes

  • App name move from terra to geostore. Structure is the same, so backup and restore your data

0.3.0 (2019-09-09)

First public tag

  • Terra app extracted from terracommon.terra

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for django-geostore, version 0.4.0
Filename, size File type Python version Upload date Hashes
Filename, size django-geostore-0.4.0.tar.gz (43.1 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page