Configuration

In your project :

Add geostore to your INSTALLED_APPS :

# install required apps
INSTALLED_APPS = [
    ...
    'django.contrib.gis',  # assume contrib.gis is installed
    ...
    'rest_framework',
    'rest_framework_gis',
    'geostore',
    ...
]

Settings

Warning

Geostore will change the geojson serializer on app loading.

INTERNAL_GEOMETRY_SRID

Default: 4326

It’s the installation SRID, it must be set before the first migration and never change after installation, else you must create your own migrations to change your database SRID.

HOSTNAME

Default: empty

Used to feed TERRA_TILES_HOSTNAMES setting

TERRA_TILES_HOSTNAMES

Default: [HOSTNAME, ]

It contains the list of base URLs where are served the vector tiles. Since web browsers limit the number of connections to one domain name, a workaround is to use many domains to serve vector tiles, so browser will create more tcp connections, and the tiles loading will be faster.

MAX_TILE_ZOOM

Default: 15

It represent the max authorized zoom, if a tile with a zoom above this setting is requested, geostore will refuse to serve it.

MIN_TILE_ZOOM

Default: 10

Like for MAX_TILE_ZOOM setting, if a tile of a lesser zoom than this setting is requested, backend will refuse to serve it.

GEOSTORE_LAYER_VIEWSSET

Default: ‘geostore.views.LayerViewSet’

Python dotted path to LayerViewSet. Can be any class inherited from ‘geostore.views.LayerViewSet’

GEOSTORE_LAYER_SERIALIZER

Default: ‘geostore.serializers.LayerSerializer’

Python dotted path to LayerSerializer. Can be any class inherited from ‘geostore.serializers.LayerSerializer’

GEOSTORE_EXPORT_CELERY_ASYNC

Default: False If your project use a celery worker, set to True to enable async exports. URLS will be provided in API, calling these urls will launch asynchronous exports and send email with a link for user download.

URLs

Add to you urls.py file this pattern:

urlpatterns = [
    ...
    path('', include('geostore.urls', namespace='geostore')),
    ...
]

You can customize default url and namespace by including geostore.views directly

Admin

you can disable and / or customize admin