De WMTS standaard 1.0.0, geïmplementeerd in QGIS Server, verschaft een interface voor HTTP voor het verzoeken van getegelde kaartafbeeldingen uit een project van QGIS. Een typisch WMTS-verzoek definieert het te gebruiken project van QGIS, enkele parameters voor WMS zoals te renderen lagen en ook parameters voor de tegels.
Specificatiedocument van de service:
• WMTS 1.0.0
Standaardverzoeken verschaft door QGIS Server:
Verzoek Omschrijving
GetCapabilities Geeft XML-metadata terug met informatie over de server GetTile Geeft een tegel terug
GetFeatureInfo Haal gegevens op (geometrie en waarden) voor de locatie van een pixel
3.3.1 GetCapabilities
Standaardparameters voor het verzoek GetCapabilities overeenkomstig de specificaties van OGC WMTS 1.0.0:
Parameter Vereist Omschrijving
SERVICE Ja Naam van de service (WMTS)
REQUEST Ja Naam van het verzoek (GetCapabilities)
In aanvulling op de standaard ondersteunt QGIS Server de volgende extra parameters:
Parameter Vereist Omschrijving
MAP Ja Specificeer het QGIS-projectbestand
Voorbeeld URL:
http://localhost/qgisserver?
SERVICE=WMTS
&REQUEST=GetCapabilities
&MAP=/home/qgis/projects/world.qgs
3.3. Web Map Tile Service (WMTS) 37
SERVICE
Deze parameter moet WMTS zijn in het geval van het verzoek GetCapabilities.
REQUEST
Deze parameter is GetCapabilities in het geval van het verzoek GetCapabilities.
MAP
Deze parameter maakt het mogelijk het te gebruiken projectbestand van QGIS te definiëren.
3.3.2 GetTile
Standaardparameters voor het verzoek GetTile overeenkomstig de specificaties van OGC WMTS 1.0.0:
Parameter Vereist Omschrijving
SERVICE Ja Naam van de service (WMTS)
REQUEST Ja Naam van het verzoek (GetTile)
LAYER Ja Identificatie laag
FORMAT Ja Indeling uitvoer van de tegel TILEMATRIXSET Ja Naam van de piramide
TILEMATRIX Ja Mazen
TILEROW Ja Rijcoördinaat in de mazen
TILECOL Ja Kolomcoördinaat in de mazen
In aanvulling op de standaard ondersteunt QGIS Server de volgende extra parameters:
Parameter Vereist Omschrijving
MAP Ja Specificeer het QGIS-projectbestand
Voorbeeld URL:
http://localhost/qgisserver?
SERVICE=WMTS
&REQUEST=GetTile
&MAP=/home/qgis/projects/world.qgs
&LAYER=mylayer
&FORMAT=image/png
&TILEMATRIXSET=EPSG:4326
&TILEROW=0
&TILECOL=0
SERVICE
Deze parameter moet WMTS zijn in het geval van het verzoek GetTile.
38 Hoofdstuk 3. Services
QGIS Server 3.16 User Guide
REQUEST
Deze parameter is GetTile in het geval van het verzoek GetTile.
LAYER
Deze parameter maakt het mogelijk de op de tegel weer te geven laag te specificeren.
In aanvulling daarop introduceert QGIS Server enkele opties om lagen te selecteren op:
• een verkorte naam
• de laag-ID
De verkorte naam van een laag kan worden geconfigureerd via Eigenschappen Metadata in het menu Laag. Als de korte naam is gedefinieerd, dan wordt die standaard gebruikt in plaats van de naam van de laag:
http://localhost/qgisserver?
SERVICE=WMTS
&REQUEST=GetTile
&LAYER=mynickname
&...
Meer nog, er is een projectoptie die het mogelijk maakt lagen te selecteren op hun ID in het menu OWS Server WMS-mogelijkheden van het dialoogvenster Project Eigenschappen…. Het keuzevak Laag-ID’s als namen gebruiken moet zijn geselecteerd om deze optie te activeren.
http://localhost/qgisserver?
SERVICE=WMTS
&REQUEST=GetTile
&LAYER=mylayerid1
&...
FORMAT
Deze parameter kan worden gebruikt om de indeling van de tegelafbeelding te specificeren. Beschikbare waarden zijn:
• jpg
• jpeg
• image/jpeg
• image/png
Als de parameter FORMAT anders is dan een van deze waarden dan zal in plaats daarvan de standaard indeling PNG worden gebruikt.
TILEMATRIXSET
Deze parameter definieert het te gebruiken CRS bij het berekenen van de onderliggende piramide. Indeling:
EPSG:XXXX.
3.3. Web Map Tile Service (WMTS) 39
TILEMATRIX
Deze parameter maakt het mogelijk de te gebruiken matrix voor het uitvoerbestand te specificeren.
TILEROW
Deze parameter maakt het mogelijk de rij van de op te halen tegel in de matrix te selecteren.
TILECOL
Deze parameter maakt het mogelijk de kolom van de op te halen tegel in de matrix te selecteren.
MAP
Deze parameter maakt het mogelijk het te gebruiken projectbestand van QGIS te definiëren.
Zoals vermeld intabel parameters GetMap, is MAP verplicht omdat een verzoek een project van QGIS nodig heeft om feitelijk te kunnen werken. Echter, de omgevingsvariabele QGIS_PROJECT_FILE mag worden gebruikt om een standaardproject voor QGIS te definiëren. In dit specifieke geval is MAP niet langer een vereiste parameter. Voor meer informatie kunt u kijken naarGevorderde configuratie.
3.3.3 GetFeatureInfo
Standaardparameters voor het verzoek GetFeatureInfo overeenkomstig de specificaties van OGC WMTS 1.0.0:
Parameter Vereist Omschrijving
SERVICE Ja Naam van de service (WMTS)
REQUEST Ja Naam van het verzoek (GetFeatureInfo)
LAYER Ja Identificatie laag
INFOFORMAT Nee Indeling uitvoer
I Nee X-coördinaat van een pixel
J Nee Y-coördinaat van een pixel
TILEMATRIXSET Ja Bekijk GetTile
TILEMATRIX Ja Bekijk GetTile
TILEROW Ja Bekijk GetTile
TILECOL Ja Bekijk GetTile
In aanvulling op de standaard ondersteunt QGIS Server de volgende extra parameters:
Parameter Vereist Omschrijving
MAP Ja Specificeer het QGIS-projectbestand
Voorbeeld URL:
http://localhost/qgisserver?
SERVICE=WMTS
&REQUEST=GetFeatureInfo
&MAP=/home/qgis/projects/world.qgs
&LAYER=mylayer
&INFOFORMAT=image/html
&I=10
&J=5
40 Hoofdstuk 3. Services
QGIS Server 3.16 User Guide
SERVICE
Deze parameter moet WMTS zijn in het geval van het verzoek GetFeatureInfo.
REQUEST
Deze parameter is GetFeatureInfo in het geval van het verzoek GetFeatureInfo.
MAP
Deze parameter maakt het mogelijk het te gebruiken projectbestand van QGIS te definiëren.
Zoals vermeld intabel parameters GetMap, is MAP verplicht omdat een verzoek een project van QGIS nodig heeft om feitelijk te kunnen werken. Echter, de omgevingsvariabele QGIS_PROJECT_FILE mag worden gebruikt om een standaardproject voor QGIS te definiëren. In dit specifieke geval is MAP niet langer een vereiste parameter. Voor meer informatie kunt u kijken naarGevorderde configuratie.
LAYER
Deze parameter maakt het mogelijk de op de tegel weer te geven laag te specificeren.
In aanvulling daarop introduceert QGIS Server enkele opties om lagen te selecteren op:
• een verkorte naam
• de laag-ID
De verkorte naam van een laag kan worden geconfigureerd via Eigenschappen Metadata in het menu Laag. Als de korte naam is gedefinieerd, dan wordt die standaard gebruikt in plaats van de naam van de laag:
http://localhost/qgisserver?
SERVICE=WMTS
&REQUEST=GetFeatureInfo
&LAYER=mynickname
&...
Meer nog, er is een projectoptie die het mogelijk maakt lagen te selecteren op hun ID in het menu OWS Server WMS-mogelijkheden van het dialoogvenster Project Eigenschappen…. Het keuzevak Laag-ID’s als namen gebruiken moet zijn geselecteerd om deze optie te activeren.
http://localhost/qgisserver?
Deze parameter kan worden gebruikt om de indeling van de uitvoer van het resultaat te definiëren. Beschikbare waarden zijn:
• text/xml
• text/html
• text/plain
• application/vnd.ogc.gml De standaardwaarde is text/plain.
3.3. Web Map Tile Service (WMTS) 41
I
Deze parameter maakt het mogelijk de X-coördinaat van de pixel te definiëren waarvoor we de onderliggende informatie willen ophalen.
J
Deze parameter maakt het mogelijk de Y-coördinaat van de pixel te definiëren waarvoor we de onderliggende informatie willen ophalen.