Quick Start & Workflow Guide

Prepare QGIS

• Create and save your project in QGIS 3.x with all layers styled.
• Define "Map Themes" (a.k.a. Kartteman) for every layer combination you want to cache as a composite.
• Save the project (Ctrl+S) before uploading so the themes are persisted.

Set up the server

• Install OSGeo4W or the standalone QGIS build and configure QGIS_PREFIX, OSGEO4W_BIN, PYTHON_EXE.
• Launch Qtiler with npm start (default http://localhost:3000).
• Optional: install the Windows Service via node service\\install-service.js.

Dashboard overview

Use the top summary to monitor pending jobs, completed caches, and quick actions like Reload layers or Cache all layers.

Layer controls

Each row exposes play/delete/copy/view buttons plus shortcuts to manual or on-demand caching so operators never leave the dashboard.

1️⃣ Upload or refresh projects

Use Upload project for `.qgs/.qgz` files. Qtiler drops them into qgisprojects/ and extracts layers, CRS, extent, and themes. Manual copies work too—just hit Reload layers.

2️⃣ Adjust zoom and extent

Set global min/max zoom and open Show extent map when you need precise bounding boxes. The map supports deep zoom (≈1:100) so you can refine the box in WGS84.

3️⃣ Cache per layer

Each layer row offers:

• ▶ Generate/refresh cache.
• 🗑 Delete stored tiles.
• 📋 Copy tile URL (`/wmts/<project>/<layer>/{z}/{x}/{y}.png`).
• 👁 Open the Leaflet viewer in the layer’s native CRS.

4️⃣ Cache per theme

The Map Themes section lists every theme found. Use ▶ to generate the composite mosaic (`/wmts/<project>/themes/<theme>/…`). Copy the WMTS URL and preview it in the viewer.

Project-wide cache

Cache all layers launches a batch job that iterates over every layer with the current parameters. The “Running tasks” panel tracks progress live.

Scheduled recache

Open the recache menu to define minute-based intervals. The server records last result and next run inside project-config.json.

On-demand caching

Qtiler can serve tiles directly from QGIS whenever a WMTS request misses the cache. Each live render is written back to disk, so manual batch jobs and on-demand traffic stay perfectly aligned.

GIS client integration

• Load the Capabilities URL to register every layer at once.
• Use individual tile URLs when you only need a specific resource.
• Themes are identified as <project>:<theme> and stored under _themes/.

Leaflet viewer

Launch the Leaflet viewer from the eye icon next to each layer or theme. Compare cached tiles against the remote source or preview the cache on its own.

Using Qtiler with Origo Map

For Origo-based portals, point the source to the REST XYZ template (not GetCapabilities) and keep the native CRS. Example source configuration:

{
  "source": "Qtiler_Topografiska_Webbkartan",
  "url": "https://ext.rabbalshedekraft.se/wmts/bakgrunder/Topografiska_Webbkartan/{z}/{x}/{y}.png",
  "type": "XYZ",
  "projection": "EPSG:3006"
}

Example layer entry that references the source:

{
  "name": "bakgrunder_Topografiska_Webbkartan",
  "title": "Topografiska_Webbkartan",
  "group": "background",
  "source": "Qtiler_Topografiska_Webbkartan",
  "type": "XYZ",
  "format": "image/png",
  "visible": true,
  "style": "karta_farg",
  "attribution": "© Lantmäteriet",
  "tileGrid": {
    "alignBottomLeft": false,
    "origin": [ -908609.3787282843, 7825048.779051208 ],
    "resolutions": [
      11426.844956133727, 5713.422478066864, 2856.711239033432,
      1428.355619516716, 714.177809758358, 357.088904879179,
      178.5444524395895, 89.27222621979475, 44.63611310989737,
      22.318056554948686, 11.159028277474343, 5.579514138737172,
      2.789757069368586, 1.394878534684293, 0.6974392673421465,
      0.3487196336710732, 0.1743598168355366, 0.0871799084177683,
      0.04358995420888415, 0.021794977104442077, 0.010897488552221038,
      0.005448744276110519, 0.0027243721380552596
    ]
  }
}