QWC oblique imagery service¶

Serves oblique imagery, consumable as an XYZ layer source.

Place your oblique images below <dataset_basedir>/<dataset_name>/*.tif. For each dataset, add a resource configuration entry needs to be added, specifying the CRS, and patterns to distinguish images based on their filename for the four possible cardinal directions.

The dataset configuration, queried via

http://localhost:5020/<dataset_name>/config

returns, for each available cardinal direction, the tile grid configuration, the tile URL as well as the centers of the available images. The tile grid configuration can be used to set up an OpenLayers XYZ source.

Tiles can be queried via the returned tile URL

http://localhost:5020/<dataset_name>/tiles/<cardinal_direction>/{z}/{x}/{y}.png

The client can also ensure only tiles from the closest image are queried by calculating the closest image (based on the image centers returned by /<dataset_name>/config), and passing the array index of the closest image to the tiles query

http://localhost:5020/Wolfsburg/tiles/<cardinal_direction>/{z}/{x}/{y}.png?img=<index>

Configuration¶

The static config files are stored as JSON files in $CONFIG_PATH with subdirectories for each tenant, e.g. $CONFIG_PATH/default/*.json. The default tenant name is default.

Elevation Service config¶

• JSON schema
• File location: $CONFIG_PATH/<tenant>/obliqueImageryConfig.json

Example:

{
  "$schema": "https://raw.githubusercontent.com/qwc-services/qwc-oblique-imagery-service/master/schemas/qwc-oblique-imagery-service.json",
  "service": "elevation",
  "config": {
    "dataset_basedir": "/images",
    "tile_size": 256,
    "margin": 500
  },
  "resources": {
    "document_templates": [
      {
        "name":"<dataset_name>",
        "crs":"EPSG:3857",
        "pattern_north":"*_North_*.tif",
        "pattern_east":"*_East_*.tif",
        "pattern_south":"*_South_*.tif",
        "pattern_west":"*_West_*.tif"
      }
    ]
  }
}

Environment variables¶

Config options in the config file can be overridden by equivalent uppercase environment variables.

Run locally¶

Install dependencies and run:

export CONFIG_PATH=<CONFIG_PATH>
uv run src/server.py

To use configs from a qwc-docker setup, set CONFIG_PATH=<...>/qwc-docker/volumes/config.

Set FLASK_DEBUG=1 for additional debug output.

Set FLASK_RUN_PORT=<port> to change the default port (default: 5000).

Docker usage¶

The Docker image is published on Dockerhub.

See sample docker-compose.yml of qwc-docker.