smoothglue_django_map 1.0.0

Enhance your development with SmoothGlue™, Map component for providing backend related map APIs.

SmoothGlue Django Map

A Django app that provides admin-configurable REST APIs for map imagery and terrain providers. Site admins can manage which imagery base layers and terrain sources are available to frontend map clients — including support for Cesium Ion assets — without any code changes.

Designed for deployments across diverse networks, including air-gapped environments where public imagery and terrain services are unavailable. When no providers are configured, frontends fall back to Cesium's bundled NaturalEarth imagery and WGS84 Ellipsoid terrain.

Features

• Imagery Layers — Configure map base-layer providers (ArcGIS, Bing, OpenStreetMap, Cesium Ion, and more) via the Django admin.
• Terrain Layers — Configure terrain providers (Ellipsoid, Cesium Ion, Cesium Terrain, ArcGIS, Google, VR-TheWorld) via the Django admin.
• Cesium Ion Support — Both imagery and terrain layers support Ion asset IDs for loading layers through the Cesium Ion API.
• Default Layer — Mark one imagery layer and one terrain layer as the default. The app enforces a single default per layer type automatically.
• Filterable REST API — Read-only list endpoints with filtering by is_active, is_default, and provider_type.
• Air-Gap Safe — Ellipsoid terrain (WGS84) requires no network access and is the default terrain provider type.

API Endpoints

Endpoint	Description
GET /image-layers/	List active imagery layers
GET /terrain-layers/	List active terrain layers

Both endpoints support query parameters for filtering:

GET /image-layers/?is_default=true
GET /terrain-layers/?provider_type=Cesium+Ion

Response Example

{
  "id": "e6227ca5-9e8a-4793-9e63-d8ffa6e858b7",
  "name": "World Imagery",
  "url": "https://services.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer",
  "provider_type": "ArcGis Map Server",
  "ion_asset_id": null,
  "sort_order": 1,
  "is_active": true,
  "is_default": true
}

Installation

Install the Package

pip install smoothglue-django-map

Configure Django

Add the app to INSTALLED_APPS in your settings.py:

INSTALLED_APPS = [
    "smoothglue.map",
    ...,
]

Include the URL routes in your urls.py:

urlpatterns = [
    path("", include("smoothglue.map.urls")),
    ...,
]

Run migrations:

python manage.py migrate

Optionally load the bundled fixtures to seed default imagery and terrain layers:

python manage.py loaddata imagerylayer
python manage.py loaddata terrainlayer

Development

Set Up Virtual Environment

This project uses Poetry for dependency management.

1. Install Poetry if you haven't already.
2. Run poetry install to create a virtual environment and install dependencies.

Management Commands

• makemigrations.py — Generate migrations for the map app.
• migrate.py — Apply pending migrations.
• loadtests.py — Run all tests (python3.12 loadtests.py).
• loaddata.py — Load fixture data (python3.12 loaddata.py smoothglue/map/fixtures/imagerylayer.json).
• djangoshell.py — Open a Django shell aware of the app.
• boot_django.py — Bootstraps a standalone Django environment via settings.configure(). Used by the other scripts.

Building

poetry build

This creates source and wheel distributions in the dist/ directory.