Viktigt

Översättning är en gemenskapsinsats du kan gå med i. Den här sidan är för närvarande översatt till 100.00%.

3.2. Webbkarttjänst (WMS)

WMS-standarderna 1.1.1 och 1.3.0 som implementerats i QGIS Server tillhandahåller ett HTTP-gränssnitt för att begära kart- eller legendbilder som genererats från ett QGIS-projekt. En typisk WMS-begäran definierar det QGIS-projekt som ska användas, de lager som ska återges samt det bildformat som ska genereras. Grundläggande stöd finns också för Styled Layer Descriptor (SLD).

Specifikationer:

Standardförfrågningar som tillhandahålls av QGIS Server:

Förfrågan	Beskrivning
GetCapabilities	Returnerar XML-metadata med information om servern
GetMap	Returnerar en karta
GetFeatureInfo	Hämtar data (geometri och värden) för en pixelplats
GetLegendGraphic	Returnerar legendsymboler
GetStyle(s)	Returnerar XML-dokument med stilbeskrivning i SLD
DescribeLayer	Returnerar information om WFS- respektive WCS-tillgänglighet för vektor- och rasterlager

Leverantörsförfrågningar som tillhandahålls av QGIS Server:

Förfrågan	Beskrivning
GetPrint	Returnerar en QGIS-layout
GetProjectSettings	Returnerar specifik information om QGIS Server
GetSchemaExtension	Returnerar XML-metadata om valfria utökade funktioner

3.2.1. GetCapabilities

Standardparametrar för GetCapabilities-begäran enligt OGC WMS 1.1.1 och 1.3.0-specifikationerna:

Parameter	Obligatorisk	Beskrivning
SERVICE	Ja	Namn på tjänsten (WMS)
REQUEST	Ja	Namn på begäran (GetCapabilities)
VERSION	Nej	Version av tjänsten

Begäran GetCapabilities stöder även följande leverantörsparametrar:

Parameter	Obligatorisk	Beskrivning
MAP	Ja	QGIS-projektfil

Exempel på URL:

http://localhost/qgisserver?
SERVICE=WMS
&VERSION=1.3.0
&REQUEST=GetCapabilities

3.2.2. GetMap

Standardparametrar för GetMap-begäran enligt OGC WMS 1.1.1 och 1.3.0-specifikationerna:

Parameter	Obligatorisk	Beskrivning
SERVICE	Ja	Namn på tjänsten (WMS)
REQUEST	Ja	Namn på begäran (GetMap)
VERSION	Ja	Version av tjänsten
LAYERS	Nej	Lager som ska visas
STYLES	Nej	Layers stil
SRS / CRS	Ja	Referenssystem för koordinater
BBOX	Ja	Kartans utbredning
WIDTH	Ja	Bildens bredd i pixlar
HEIGHT	Ja	Bildens höjd i pixlar
FORMAT	Nej	Bildformat
TRANSPARENT	Nej	Transparent bakgrund
SLD	Nej	URL till en SLD som ska användas för styling
SLD_BODY	Nej	In-line SLD (XML) som ska användas för styling

Utöver standardparametrarna stöder QGIS Server redlining, externa WMS-lager samt följande extra parametrar:

Parameter	Obligatorisk	Beskrivning
MAP	Ja	QGIS-projektfil
BGCOLOR	Nej	Ange bakgrundsfärg
DPI	Nej	Ange utgångsupplösning
IMAGE_QUALITY	Nej	JPEG-komprimering
OPACITIES	Nej	Opacitet för lager eller grupp
FILTER	Nej	Undergrupp av funktioner
SELECTION	Nej	Markera funktioner
FILE_NAME	Nej	Filnamn på den nedladdade filen Endast för `FORMAT=application/dxf`
FORMAT_OPTIONS	Nej	Alternativ för det angivna filformatet Endast för `FORMAT=application/dxf`
TILED	Nej	Arbetar i tiled mode (lutande läge)

Exempel på URL:

http://localhost/qgisserver?
SERVICE=WMS
&VERSION=1.3.0
&REQUEST=GetMap
&MAP=/home/qgis/projects/world.qgs
&LAYERS=mylayer1,mylayer2,mylayer3
&STYLES=style1,default,style3
&OPACITIES=125,200,125
&CRS=EPSG:4326
&WIDTH=400
&HEIGHT=400
&FORMAT=image/png
&TRANSPARENT=TRUE
&DPI=300
&TILED=TRUE

VERSION

Denna parameter gör det möjligt att ange vilken version av tjänsten som ska användas. Tillgängliga värden för parametern VERSION är:

1.1.1
1.3.0

Beroende på versionsnumret kan man förvänta sig små skillnader, vilket förklaras senare för nästa parameter:

CRS / SRS
BBOX

LAYERS

Med denna parameter kan du ange vilka lager som ska visas på kartan. Namnen måste separeras med ett kommatecken.

Dessutom har QGIS Server infört några alternativ för att välja lager efter:

lagrets id: projektalternativet som gör det möjligt att välja lager efter deras id finns i QGIS Server ► WMS fliken i Projekt ► Egenskaper… dialogen. Markera kryssrutan Use layer ids as names för att aktivera detta alternativ.
a kortnamn

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetMap
&LAYERS=mylayerid1,mylayerid2
&...

STYLES

Denna parameter kan användas för att ange ett lagers stil för renderingssteget. Stilarna måste separeras med ett kommatecken. Namnet på standardstilen är default.

SRS / CRS

Denna parameter gör det möjligt att ange det spatiala referenssystemet för kartutdata i WMS 1.1.1 och måste utformas som EPSG:XXXX. Observera att CRS också stöds om den aktuella versionen är 1.1.1.

För WMS 1.3.0 är parametern CRS att föredra, men SRS stöds också.

Observera att om både parametrarna CRS och SRS anges i begäran, är det den aktuella versionen som anges i parametern VERSION som är avgörande.

I nästa fall behålls parametern SRS oavsett parametern VERSION eftersom CRS inte anges:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetMap
&VERSION=1.3.0
&SRS=EPSG:2854
&...

I nästa fall behålls parametern SRS i stället för CRS på grund av parametern VERSION:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetMap
&VERSION=1.1.1
&CRS=EPSG:4326
&SRS=EPSG:2854
&...

I nästa fall behålls parametern CRS i stället för SRS på grund av parametern VERSION:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetMap
&VERSION=1.3.0
&CRS=EPSG:4326
&SRS=EPSG:2854
&...

BBOX

Denna parameter gör det möjligt att ange kartans utsträckning med enheter enligt aktuellt CRS. Koordinaterna måste separeras med ett kommatecken.

Parametern BBOX är utformad som min_a,min_b,max_a,max_b men a och b axeldefinitionen är olika beroende på den aktuella parametern VERSION:

i WMS 1.1.1 är axelordningen alltid öst/nord
i WMS 1.3.0 beror axelordningen på CRS-auktoriteten

Till exempel i fallet med EPSG:4326 och WMS 1.1.1, a är longituden (öst) och b latituden (nord), vilket leder till en begäran som:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetMap
&VERSION=1.1.1
&SRS=epsg:4326
&BBOX=-180,-90,180,90
&...

Men när det gäller WMS 1.3.0 är den axelordning som definieras i EPSG-databasen nord/öst, så ”a” är latitud och ”b” longitud:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetMap
&VERSION=1.3.0
&CRS=epsg:4326
&BBOX=-90,-180,90,180
&...

WIDTH

Med den här parametern kan du ange bredden i pixlar på utdatabilden.

HEIGHT

Med den här parametern kan du ange höjden i pixlar för den utgående bilden.

FORMAT

Denna parameter kan användas för att ange formatet på kartbilden. Tillgängliga värden är:

jpg
jpeg
image/jpeg
image/png
image/png; mode=1bit
image/png; mode=8bit
image/png; mode=16bit
image/webp
application/dxf: endast lager som har läsbehörighet i WFS-tjänsten exporteras i DXF-format

application/pdf

Exempel på URL:

http://localhost/qgisserver?
SERVICE=WMS&VERSION=1.3.0
&REQUEST=GetMap
&FORMAT=application/dxf
&LAYERS=Haltungen,Normschacht,Spezialbauwerke
&CRS=EPSG%3A21781
&BBOX=696136.28844801,245797.12108743,696318.91114315,245939.25832905
&WIDTH=1042
&HEIGHT=811
&FORMAT_OPTIONS=MODE:SYMBOLLAYERSYMBOLOGY;SCALE:250
&FILE_NAME=plan.dxf

TRANSPARENT

Denna booleska parameter kan användas för att ange bakgrundens transparens. Tillgängliga värden är (inte skiftlägeskänsliga):

TRUE
FALSE

Denna parameter ignoreras dock om formatet på den bild som anges med FORMAT är ett annat än PNG.

BGCOLOR

Denna parameter gör det möjligt att ange en bakgrundsfärg för kartbilden. Den kan dock inte kombineras med parametern TRANSPARENT när det gäller PNG-bilder (transparens prioriteras). Färgen kan vara bokstavlig eller i hexadecimal notation.

URL-exempel med bokstavlig notation:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetMap
&VERSION=1.3.0
&BGCOLOR=green
&...

URL-exempel med hexadecimal notation:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetMap
&VERSION=1.3.0
&BGCOLOR=0x00FF00
&...

DPI

Denna parameter kan användas för att ange önskad upplösning på utmatningen.

IMAGE_QUALITY

Denna parameter används endast för JPEG-bilder. Som standard är JPEG-komprimeringen -1.

Du kan ändra standardvärdet för varje QGIS-projekt i menyn OWS Server ► WMS capabilities i dialogrutan Projekt ► Egenskaper…. Om du vill åsidosätta den i en GetMap-begäran kan du göra det med hjälp av parametern IMAGE_QUALITY.

OPACITIES

Kommaseparerad lista med opacitetsvärden. Opaciteten kan ställas in på lager- eller gruppnivå. Tillåtna värden sträcker sig från 0 (helt transparent) till 255 (helt ogenomskinlig).

Exempel på URL:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetMap
&VERSION=1.3.0
&WIDTH=400
&HEIGHT=200
&CRS=EPSG:4326
&LAYERS=countries,places
&BBOX=42,-6,52,15
&OPACITIES=255,0

../../../_images/wms_getmap_opacities.png — Fig. 3.3 Till vänster `OPACITIES=255,0` och till höger `OPACITIES=255,255`

FILTER

En delmängd av lager kan väljas med parametern FILTER. Syntaxen är i princip densamma som för QGIS subset-strängen. Det finns dock vissa begränsningar för att undvika SQL-injektioner i databaser via QGIS Server. Om en farlig sträng hittas i parametern kommer QGIS Server att returnera nästa fel:

<ServiceExceptionReport>
  <ServiceException code="Security">The filter string XXXXXXXXX has been rejected because of security reasons.
  Note: Text strings have to be enclosed in single or double quotes. A space between each word / special character is mandatory.
  Allowed Keywords and special characters are IS,NOT,NULL,AND,OR,IN,=,<,=<,>,>=,!=,',',(,),DMETAPHONE,SOUNDEX.
  Not allowed are semicolons in the filter expression.</ServiceException>
</ServiceExceptionReport>

Exempel på URL:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetMap
&VERSION=1.3.0
&WIDTH=400
&HEIGHT=300
&CRS=EPSG:4326
&BBOX=41,-6,52,10
&LAYERS=countries_shapeburst,countries,places
&FILTER=countries_shapeburst,countries:"name" = 'France';places: "name" = 'Paris'

../../../_images/wms_getmap_filter.png — Fig. 3.4 Serverns svar på en GetMap-begäran med parametern FILTER

I det här exemplet tillämpas samma filter "name" = "France" på lagren countries och countries_shapeburst, medan filtret "name" = "Paris" endast tillämpas på places.

Observera

Det är möjligt att göra attributsökningar via GetFeatureInfo och utelämna X/Y-parametern om det finns ett FILTER. QGIS Server returnerar sedan information om de matchande funktionerna och genererar en kombinerad bounding box i XML-utdata.

SELECTION

Parametern SELECTION kan markera funktioner från ett eller flera lager. Vektorfunktioner kan väljas genom att skicka kommaseparerade listor med funktions-id.

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetMap
&LAYERS=mylayer1,mylayer2
&SELECTION=mylayer1:3,6,9;mylayer2:1,5,6
&...

Följande bild visar svaret från en GetMap-begäran med alternativet SELECTION, t.ex. http://myserver.com/...&SELECTION=countries:171,65.

Eftersom dessa funktions-ID:n i källdatasetet motsvarar Frankrike och Rumänien är de markerade med gult.

../../../_images/server_selection_parameter.png — Fig. 3.5 Serverns svar på en GetMap-begäran med parametern SELECTION

FORMAT_OPTIONS

Denna parameter kan användas för att ange alternativ för det valda formatet. Endast för FORMAT=application/dxf i GetMap-begäran. Tar emot en lista med nyckel:värde-par separerade med semikolon:

SCALE (SKALA): används för symbologiregler, filter och stilar (inte faktisk skalning av data - data förblir i den ursprungliga skalan).
MODE: motsvarar de exportalternativ som erbjuds i DXF-exportdialogen i QGIS Desktop. Möjliga värden är NOSYMBOLOGY, FEATURESYMBOLOGY och SYMBOLLAYERSYMBOLOGY.
LAYERATTRIBUTES: ange ett fält eller, om det finns många lager, en kommaseparerad lista med fält som innehåller värden för DXF-lagernamn - om inget anges används de ursprungliga QGIS-lagernamnen.
USE_TITLE_AS_LAYERNAME: om detta är aktiverat kommer lagrets titel att användas som lagernamn.
CODEC: ange en codec som ska användas för kodning. Standard är ISO-8859-1 kontrollera dialogrutan DXF-export i QGIS desktop för giltiga värden.
NO_MTEXT: Använd TEXT i stället för MTEXT för etiketter.
FORCE_2D: Tvinga fram 2D-utdata. Detta krävs för polylinjebredd.

TILED

Av prestandaskäl kan QGIS Server användas i tiled-läge. I det här läget begär klienten flera små plattor med fast storlek och sätter ihop dem till en hel karta. På så sätt kan symboler på eller nära gränsen mellan två plattor visas som utklippta, eftersom de bara finns i en av plattorna.

Sätt parametern TILED till TRUE för att tala om för QGIS Server att arbeta i tiled-läge och att använda den Tile-buffert som konfigurerats i QGIS-projektet (se Konfigurera ditt projekt).

När TILED är TRUE och när en Tile-buffert som inte är noll har konfigurerats i QGIS-projektet ritas funktioner utanför tile-utbredningen för att undvika klippsymboler vid tile-gränser.

standardvärdet för TILED är FALSE.

3.2.3. GetFeatureInfo

Standardparametrar för GetFeatureInfo-begäran enligt OGC WMS 1.1.1 och 1.3.0-specifikationerna:

Parameter	Obligatorisk	Beskrivning
SERVICE	Ja	Namn på tjänsten (WMS)
REQUEST	Ja	Namn på begäran (GetFeatureInfo)
VERSION	Nej	Version av tjänsten
QUERY_LAYERS	Ja	Lager att fråga på
LAYERS	Ja	Lager som ska visas (identiskt med QUERY_LAYERS)
STYLES	Nej	Layers stil
SRS / CRS	Ja	Referenssystem för koordinater
BBOX	Nej	Kartans utbredning
WIDTH	Ja	Bildens bredd i pixlar
HEIGHT	Ja	Bildens höjd i pixlar
TRANSPARENT	Nej	Transparent bakgrund
INFO_FORMAT	Nej	Utdata format
FEATURE_COUNT	Nej	Maximalt antal funktioner som ska returneras
I	Nej	Pixelkolumn för den punkt som ska frågas
X	Nej	Samma som parametern I, men i WMS 1.1.1
J	Nej	Pixelrad för den punkt som ska frågas
Y	Nej	Samma som parametern J, men i WMS 1.1.1
WMS_PRECISION	Nej	Den precision (antal siffror) som ska användas vid returnering av geometri (se hur man lägger till geometri i funktionssvar). Standardvärdet är `-1`, vilket innebär att den precision som definieras i projektet används.

Utöver standardparametrarna har QGIS Server stöd för följande extra parametrar:

Parameter	Obligatorisk	Beskrivning
MAP	Ja	QGIS-projektfil
FILTER	Nej	Undergrupp av funktioner
FI_POINT_TOLERANCE	Nej	Tolerans i pixlar för punktlager
FI_LINE_TOLERANCE	Nej	Tolerans i pixlar för linjelager
FI_POLYGON_TOLERANCE	Nej	Tolerans i pixlar för polygonlager
FILTER_GEOM	Nej	Filtrering av geometri
WITH_DISPLAY_NAME	Nej	Lägg till funktionens visningsnamn i utdata
WITH_MAPTIP	Nej	Lägg till karttips i utskriften
WITH_GEOMETRY	Nej	Lägg till geometri i utdata

Exempel på URL:

http://localhost/qgisserver?
SERVICE=WMS
&VERSION=1.3.0
&REQUEST=GetMap
&MAP=/home/qgis/projects/world.qgs
&LAYERS=mylayer1,mylayer2,mylayer3
&CRS=EPSG:4326
&WIDTH=400
&HEIGHT=400
&INFO_FORMAT=text/xml
&TRANSPARENT=TRUE
&QUERY_LAYERS=mylayer1
&FEATURE_COUNT=3
&I=250
&J=250

INFO_FORMAT

Denna parameter kan användas för att ange resultatets format. Tillgängliga värden är:

text/xml
text/html
text/plain
application/vnd.ogc.gml
application/json

QUERY_LAYERS

Denna parameter anger vilka lager som ska visas på kartan. Namnen separeras med ett kommatecken.

Dessutom introducerar QGIS Server alternativ för att välja lager efter:

kort namn
lager id

Se parametern LAYERS som definieras i GetMap för mer information.

FEATURE_COUNT

Denna parameter anger det maximala antalet funktioner per lager som ska returneras. Om till exempel QUERY_LAYERS är inställt på layer1,layer2 och FEATURE_COUNT är inställt på 3 kommer maximalt 3 funktioner från layer1 att returneras. På samma sätt kommer maximalt 3 funktioner från lager2 att returneras.

Som standard returneras endast 1 funktion per lager.

I

Med denna parameter, som definieras i WMS 1.3.0, kan du ange pixelkolumnen för sökpunkten.

X

Samma parameter som I, men definierad i WMS 1.1.1.

J

Med denna parameter, som definieras i WMS 1.3.0, kan du ange pixelraden för frågepunkten.

Y

Samma parameter som J, men definierad i WMS 1.1.1.

FI_POINT_TOLERANCE

Denna parameter anger toleransen i pixlar för punktlager.

FI_LINE_TOLERANCE

Denna parameter anger toleransen i pixlar för linjelager.

FI_POLYGON_TOLERANCE

Denna parameter anger toleransen i pixlar för polygonlager.

FILTER_GEOM

Denna parameter anger en WKT-geometri som objekten måste korsa.

WITH_DISPLAY_NAME

Denna parameter anger om funktionens visningsnamn ska läggas till i utdata.

Tillgängliga värden är (inte skiftlägeskänsliga):

TRUE
FALSE

WITH_MAPTIP

Den här parametern anger om karttips ska läggas till i utdata.

Tillgängliga värden är (inte skiftlägeskänsliga):

TRUE
FALSE
HTML_FI_ONLY_MAPTIP: som TRUE, med skillnaden att HTML-svaret på begäran om funktionsinformation endast innehåller karttipset. Detta ger full kontroll över HTML-svaret med hjälp av t.ex. den inbyggda redigeraren för karttips för lager.

WITH_GEOMETRY

Denna parameter anger om geometrier ska läggas till i utdata. För att använda den här funktionen måste du först aktivera alternativet Add geometry to feature response i QGIS-projektet. Se Konfigurera ditt projekt.

Tillgängliga värden är (inte skiftlägeskänsliga):

TRUE
FALSE

3.2.4. GetLegendGraphic

Standardparametrar för GetLegendGraphic-begäran enligt OGC WMS 1.1.1 och 1.3.0-specifikationerna:

Parameter	Obligatorisk	Beskrivning
SERVICE	Ja	Namn på tjänsten (WMS)
REQUEST	Ja	Namn på begäran (GetLegendGraphic)
VERSION	Nej	Version av tjänsten
LAYERS	Ja	Lager som ska visas
STYLES	Nej	Layers stil
SRS / CRS	Nej	Referenssystem för koordinater
BBOX	Nej	Kartans utbredning
WIDTH	Nej	Bildens bredd i pixlar
HEIGHT	Nej	Bildens höjd i pixlar
FORMAT	Nej	Format för teckenförklaring
TRANSPARENT	Nej	Transparent bakgrund

Utöver standardparametrarna har QGIS Server stöd för extra parametrar för att ändra storleken på legendelementen eller teckensnittsegenskaperna för lagertitlar och objektetiketter:

Parameter	Obligatorisk	Beskrivning
MAP	Ja	QGIS-projektfil
SRCWIDTH	Nej	Kartans bredd
SRCHEIGHT	Nej	Karthöjd
SHOWFEATURECOUNT	Nej	Lägg till antal funktioner
RULE	Nej	Regelsymbol att återge
RULELABEL	Nej	Rendering av artikeletiketter
BOXSPACE	Nej	Avstånd mellan legendram och innehåll (mm)
LAYERSPACE	Nej	Vertikalt avstånd mellan lagren (mm)
LAYERTITLESPACE	Nej	Vertikalt avstånd mellan lagertitel och artiklar (mm)
SYMBOLSPACE	Nej	Vertikalt avstånd mellan symbol och objekt (mm)
ICONLABELSPACE	Nej	Horisontellt avstånd mellan symbol och etikett (mm)
SYMBOLWIDTH	Nej	Bredd på förhandsgranskningen av symbolen (mm)
SYMBOLHEIGHT	Nej	Höjd på symbolens förhandsgranskning (mm)
LAYERTITLE	Nej	Rendering av lagertitel
LAYERFONTFAMILY	Nej	Layer teckensnittsfamilj
LAYERFONTBOLD	Nej	Titel på lager fet återgivning
LAYERFONTSIZE	Nej	Teckenstorlek för lagertitel (pt)
LAYERFONTITALIC	Nej	Lagertitel kursiv rendering
LAYERFONTCOLOR	Nej	Färg för lagertitel
ITEMFONTFAMILY	Nej	Artikelns teckensnittsfamilj
ITEMFONTBOLD	Nej	Fetstil på artikeletiketten
ITEMFONTSIZE	Nej	Artikeletikettens teckenstorlek (pt)
ITEMFONTITALIC	Nej	Artikeletikett kursiv rendering
ITEMFONTCOLOR	Nej	Färg på artikeletikett
SHOWRULEDETAILS	Nej	Lägger till regeltexten i JSON-utdata
ADDLAYERGROUPS	Nej	Lägger till lagergrupperna i JSON-utdata

BBOX

Denna parameter kan användas för att ange det geografiska område för vilket teckenförklaringen ska byggas (dess format beskrivs här) men kan inte kombineras med parametern RULE. Parametern SRS/CRS blir obligatorisk när parametern BBOX används.

Exempel på URL:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=countries,airports
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326

Observera

När parametern BBOX är definierad kallas teckenförklaringen för en innehållsbaserad teckenförklaring.

WIDTH

Denna parameter används inte som standard, men blir obligatorisk när parametern RULE är inställd. I detta fall gör den det möjligt att ange bredden i pixlar för utdatabilden.

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=getlegendgraphic
&LAYER=testlayer%20%C3%A8%C3%A9
&RULE=rule1
&WIDTH=30
&HEIGHT=30

HEIGHT

Denna parameter används inte som standard, men blir obligatorisk när parametern RULE är inställd. I detta fall gör den det möjligt att ange höjden i pixlar för utdatabilden.

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYER=testlayer%20%C3%A8%C3%A9
&RULE=rule1
&WIDTH=30
&HEIGHT=30

FORMAT

Denna parameter kan användas för att ange formatet på legendbilden. Tillgängliga värden är:

image/jpeg
image/png
application/json

För JSON kodas symbolerna med Base64 och de flesta andra alternativ som rör layout eller teckensnitt beaktas inte eftersom förklaringen måste byggas på klientsidan. Parametern RULE kan inte kombineras med detta format.

URL-exempel med motsvarande JSON-utdata:

http://localhost/qgisserver?
SERVICE=WMS&
REQUEST=GetLegendGraphic&
LAYERS=airports&
FORMAT=application/json

Och motsvarande JSON-utdata:

{
  "nodes":[
    {
      "icon":"<base64 icon>",
      "title":"airports",
      "type":"layer"
    }
  ],
  "title":""
}

SRCWIDTH

Denna parameter kan definieras när parametern RULE är inställd. I detta fall vidarebefordras värdet SRCWIDTH till den underliggande GetMap begäran som parametern WIDTH medan parametern WIDTH i GetLegendGraphic används för storleken på bildens förklaring.

SRCHEIGHT

Denna parameter kan definieras när parametern RULE är inställd. I detta fall vidarebefordras värdet SRCHEIGHT till den underliggande GetMap begäran som parametern HEIGHT medan parametern HEIGHT i GetLegendGraphic används för storleken på bildens förklaring.

SHOWFEATURECOUNT

Denna parameter kan användas för att aktivera funktionsräkning i teckenförklaringen. Tillgängliga värden är (inte skiftlägeskänsliga):

TRUE
FALSE

Till exempel:

../../../_images/getfeaturecount_legend.png

RULE

Denna parameter är tillgänglig på lager med Rule-based rendering och gör det möjligt att bygga en förklaring med endast den namngivna regelsymbolen. Den kan inte kombineras med parametern BBOX. parametrarna HEIGHT och WIDTH måste anges.

Exempel på URL:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=mylayer,
&RULE=myrulename,
&WIDTH=20,
&HEIGHT=20

RULELABEL

Denna parameter gör det möjligt att styra återgivningen av artikeletiketten. Tillgängliga värden är (inte skiftlägeskänsliga):

TRUE: visa artikeletikett
FALSE: dölj artikeletikett
AUTO: dölj objektetikett för lager med Single symbol-rendering

Exempel på URL:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=countries,airports
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&RULELABEL=AUTO

../../../_images/wms_getlegendgraphic_rulelabel.png — Fig. 3.6 Rendering av teckenförklaring utan etikett för lager med enstaka symboler

BOXSPACE

Denna parameter gör det möjligt att ange utrymmet mellan legendramen och innehållet i millimeter. Som standard är värdet för utrymmet 2 mm.

Exempel på URL:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=airports
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&BOXSPACE=0

../../../_images/wms_getlegendgraphic_boxspace.png — Fig. 3.7 Till vänster `BOXSPACE=0` och till höger `BOXSPACE=15`

LAYERSPACE

Denna parameter gör det möjligt att ange det vertikala utrymmet mellan lagren i millimeter. Som standard är utrymmesvärdet 3 mm.

Exempel på URL:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=airports,places
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&LAYERSPACE=0

../../../_images/wms_getlegendgraphic_layerspace.png — Fig. 3.8 Till vänster `LAYERSPACE=0` och till höger `LAYERSPACE=10`

LAYERTITLESPACE

Med denna parameter kan du ange det vertikala utrymmet mellan lagertiteln och följande objekt i millimeter. Som standard är värdet på utrymmet 3 mm.

Exempel på URL:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=airports,places
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&LAYERTITLESPACE=0

../../../_images/wms_getlegendgraphic_layertitlespace.png — Fig. 3.9 Till vänster `LAYERTITLESPACE=0` och till höger `LAYERTITLESPACE=10`

SYMBOLSPACE

Denna parameter gör det möjligt att ange det vertikala utrymmet mellan symbolen och följande objekt i millimeter. Som standard är värdet för mellanrummet 2 mm.

Exempel på URL:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=countries
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&SYMBOLSPACE=0

../../../_images/wms_getlegendgraphic_symbolspace.png — Fig. 3.10 Till vänster `SYMBOLSPACE=0` och till höger `SYMBOLSPACE=5`

ICONLABELSPACE

Med denna parameter kan du ange det horisontella utrymmet mellan symbol och etikettext i millimeter. Som standard är värdet för mellanrummet 2 mm.

Exempel på URL:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=getlegendgraphic
&LAYERS=countries,
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&ICONLABELSPACE=0

../../../_images/wms_getlegendgraphic_iconlabelspace.png — Fig. 3.11 Till vänster `ICONLABELSPACE=0` och till höger `ICONLABELSPACE=10`

SYMBOLWIDTH

Med denna parameter kan du ange bredden på symbolförhandsgranskningen i millimeter. Standardvärdet för bredden är 7 mm.

Exempel på URL:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=countries,
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&SYMBOLWIDTH=2

../../../_images/wms_getlegendgraphic_symbolwidth.png — Fig. 3.12 Till vänster `SYMBOLWIDTH=2` och till höger `SYMBOLWIDTH=20`

SYMBOLHEIGHT

Med denna parameter kan du ange höjden på symbolförhandsgranskningen i millimeter. Som standard är höjdvärdet 4 mm.

Exempel på URL:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=countries,
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&SYMBOLHEIGHT=2

../../../_images/wms_getlegendgraphic_symbolheight.png — Fig. 3.13 Till vänster `SYMBOLHEIGHT=2` och till höger `SYMBOLHEIGHT=6`

LAYERTITLE

Denna parameter anger om lagrets titel ska återges.

Tillgängliga värden är (inte skiftlägeskänsliga):

TRUE (standardvärde)
FALSE

LAYERFONTFAMILY

Denna parameter anger vilken teckensnittsfamilj som ska användas för att rendera lagertiteln.

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=countries
&LAYERFONTFAMILY=monospace

LAYERFONTBOLD

Denna parameter anger om lagrets titel ska återges i fet stil. Tillgängliga värden är (inte skiftlägeskänsliga):

TRUE
FALSE

Exempel på URL:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=airports,places
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&LAYERFONTBOLD=TRUE

../../../_images/wms_getlegendgraphic_layerfontbold.png — Fig. 3.14 Förklaring med `LAYERFONTBOLD=TRUE`

LAYERFONTSIZE

Denna parameter anger teckenstorleken för rendering av lagertiteln i punkt.

Exempel på URL:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=airports,places
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&LAYERFONTSIZE=20

../../../_images/wms_getlegendgraphic_layerfontsize.png — Fig. 3.15 Förklaring med `LAYERFONTSIZE=20`

LAYERFONTITALIC

Denna parameter anger om lagrets titel ska återges i kursiv stil. Tillgängliga värden är (inte skiftlägeskänsliga):

TRUE
FALSE

Exempel på URL:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=airports,places
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&LAYERFONTITALIC=TRUE

../../../_images/wms_getlegendgraphic_layerfontitalic.png — Fig. 3.16 Förklaring med `LAYERFONTITALIC=TRUE`

LAYERFONTCOLOR

Denna parameter anger färgen på lagrets titel. Färgen kan vara bokstavlig (röd, grön, …) eller i hexadecimal notation (0xFF0000, 0x00FF00, …).

Exempel på URL:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=airports,places
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&LAYERFONTCOLOR=0x5f9930

../../../_images/wms_getlegendgraphic_layerfontcolor.png — Fig. 3.17 Förklaring med `LAYERFONTCOLOR=0x5f9930`

ITEMFONTFAMILY

Denna parameter anger vilken teckensnittsfamilj som ska användas för att rendera artikeletiketten.

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=countries
&ITEMFONTFAMILY=monospace

ITEMFONTBOLD

Denna parameter anger om artikeletiketten ska återges i fet stil. Tillgängliga värden är (ej skiftlägeskänsliga):

TRUE
FALSE

Exempel på URL:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=airports,places
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&ITEMFONTBOLD=TRUE

../../../_images/wms_getlegendgraphic_itemfontbold.png — Fig. 3.18 Teckenförklaring med `ITEMFONTBOLD=TRUE`

ITEMFONTSIZE

Denna parameter anger teckenstorleken för rendering av lagertiteln i punkt.

Exempel på URL:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=airports,places
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&ITEMFONTSIZE=20

../../../_images/wms_getlegendgraphic_itemfontsize.png — Fig. 3.19 Förklaring med `ITEMFONTSIZE=30`

ITEMFONTITALIC

Denna parameter anger om artikeletiketten ska återges i kursiv stil. Tillgängliga värden är (ej skiftlägeskänsliga):

TRUE
FALSE

Exempel på URL:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=airports,places
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&ITEMFONTITALIC=TRUE

../../../_images/wms_getlegendgraphic_itemfontitalic.png — Fig. 3.20 Förklaring med `ITEMFONTITALIC=TRUE`

ITEMFONTCOLOR

Denna parameter anger färgen på artikeletiketten. Färgen kan vara bokstavlig (röd, grön, …) eller i hexadecimal notation (0xFF0000, 0x00FF00, …).

Exempel på URL:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=airports,places
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&ITEMFONTCOLOR=0x5f9930

../../../_images/wms_getlegendgraphic_itemfontcolor.png — Fig. 3.21 Förklaring med `ITEMFONTCOLOR=0x5f9930`

SHOWRULEDETAILS

Den här parametern anger om JSON-utdata även ska innehålla information om den regel som genererade legendposten. Den här parametern har endast effekt när renderingsprogrammet är regelbaserat eller kategoriserat.

URL-exempel med motsvarande JSON-utdata:

http://localhost/qgisserver?
SERVICE=WMS&
REQUEST=GetLegendGraphic&
LAYERS=airports&
FORMAT=application/json&
SHOWRULEDETAILS=TRUE

Och motsvarande JSON-utdata:

{
  "nodes":[
    {
      "icon":"<base64 icon>",
      "title":"airports",
      "type":"layer",
      "rule": "type = 'airport'"
    }
  ],
  "title":""
}

ADDLAYERGROUPS

Denna parameter anger om JSON-utdata även ska visa namnen på lagergrupperna (och undergrupperna) i legendposten. Möjliga värden är:

TRUE: visa gruppernas etiketter
FALSE (standard): döljer gruppernas etiketter

../../../_images/wms_getlegendgraphic_addlayergroups.png — Fig. 3.22 Förklaring utan (vänster) och med (höger) lagergruppers etiketter display

Motsvarande JSON-utdata som visar gruppnamn skulle se ut som följer:

{ "nodes":
  [{ "nodes":
     [{ "icon":"iVBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAACXBIWXMAABYlAAAWJQFJUiTwAAAAUklEQVQ4jWNgGAXDHzASUqCsrPwfmX/37l28evBKKisr/0+a7IMiNi93C15DcUpgM4wYQ5nwuZAcMIQNvHv3LuO83C0kG0hysoFZRrJNo2AYAQC87BpkGQj1fwAAAABJRU5ErkJggg==",
        "title":"layer_a", "type":"layer"
     },
     { "nodes":
       [{ "icon":"iVBORw0KGgoAAAANSUhEUgAAABMAAAAUCAYAAABvVQZ0AAAACXBIWXMAABYlAAAWJQFJUiTwAAAAHUlEQVQ4jWNgGAWjYCQDxh887r8G2hGjYBQMGAAA1x0CR0FzIkYAAAAASUVORK5CYII=",
          "title":"layer_b", "type":"layer"
        },
        { "icon":"iVBORw0KGgoAAAANSUhEUgAAABMAAAAUCAYAAABvVQZ0AAAACXBIWXMAABYlAAAWJQFJUiTwAAAAHUlEQVQ4jWNgGAWjYCQDxtmzZ/8aaEeMglEwYAAAaIoCzTtn5XoAAAAASUVORK5CYII=",
          "title":"layer_c", "type":"layer"
       }],
       "title":"lines", "type":"group"
     },
     { "icon":"iVBORw0KGgoAAAANSUhEUgAAABMAAAATCAYAAAByUDbMAAAACXBIWXMAABYlAAAWJQFJUiTwAAAAKklEQVQ4jWNUVlX/z0AlwMLAwMDAnXmQKoYxUcWUUcNGDRs1bNSwYWYYACXDAsvQaTuVAAAAAElFTkSuQmCC",
       "title":"layer_d", "type":"layer"
     }],
     "title":"top-level-group", "type":"group"
  }],
  "title":""
}

3.2.5. GetStyle(s)

Standardparametrar för begäran GetStyle (eller GetStyles) enligt OGC WMS 1.1.1-specifikationerna:

Parameter	Obligatorisk	Beskrivning
SERVICE	Ja	Namn på tjänsten (WMS)
REQUEST	Ja	Namn på begäran (GetStyle eller GetStyles)
LAYERS	Ja	Lager att fråga på

Begäran GetStyle stöder även följande leverantörsparametrar:

Parameter	Obligatorisk	Beskrivning
MAP	Ja	QGIS-projektfil

Exempel på URL:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetStyles
&LAYERS=mylayer1,mylayer2

3.2.6. DescribeLayer

Standardparametrar för DescribeLayer-begäran enligt OGC WMS 1.1.1 och 1.3.0-specifikationerna:

Parameter	Obligatorisk	Beskrivning
SERVICE	Ja	Namn på tjänsten (WMS)
REQUEST	Ja	Namn på begäran (DescribeLayer)
LAYERS	Ja	Lager för att beskriva
SLD_VERSION	Ja	SLD-version

Begäran DescribeLayer stöder även följande leverantörsparametrar:

Parameter	Obligatorisk	Beskrivning
MAP	Ja	QGIS-projektfil

Exempel på URL:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=DescribeLayer
&SLD_VERSION=1.1.0
&LAYERS=mylayer1

XML-dokumentet ser ut som följer:

<DescribeLayerResponse xmlns="http://www.opengis.net/sld" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ows="http://www.opengis.net/ows" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:se="http://www.opengis.net/se" xsi:schemaLocation="http://www.opengis.net/sld http://schemas.opengis.net/sld/1.1.0/DescribeLayer.xsd">
    <Version>1.1.0</Version>
    <LayerDescription>
        <owsType>wfs</owsType>
        <se:OnlineResource xlink:href="http://localhost/qgisserver" xlink:type="simple"/>
        <TypeName>
            <se:FeatureTypeName>my_vector_layer</se:FeatureTypeName>
        </TypeName>
    </LayerDescription>
    <LayerDescription>
        <owsType>wcs</owsType>
        <se:OnlineResource xlink:href="http://localhost/qgisserver" xlink:type="simple"/>
        <TypeName>
            <se:FeatureTypeName>my_raster_layer</se:FeatureTypeName>
        </TypeName>
    </LayerDescription>
</DescribeLayerResponse>

SLD_VERSION

Denna parameter gör det möjligt att ange versionen av SLD. Endast värdet 1.1.0 är tillgängligt.

3.2.7. GetPrint

QGIS Server har möjlighet att skapa utskriftslayouter i pdf- eller pixelformat. Utskriftslayoutfönstren i det publicerade projektet används som mallar. I GetPrint-begäran har klienten möjlighet att ange parametrar för de layoutkartor och etiketter som ingår.

Begäran GetPrint stöder redlining, externa WMS-lager samt följande parametrar:

Parameter	Obligatorisk	Beskrivning
MAP	Ja	QGIS-projektfil
SERVICE	Ja	Namn på tjänsten (WMS)
REQUEST	Ja	Namn på begäran (GetPrint)
VERSION	Nej	Version av tjänsten
LAYERS	Nej	Lager som ska visas
TEMPLATE	Ja	Layoutmall att använda
SRS / CRS	Ja	Referenssystem för koordinater
FORMAT	Nej	Utdata format
FORMAT_OPTIONS	Nej	Alternativ för det angivna filformatet Endast för `FORMAT=application/pdf`
ATLAS_PK	Nej	Atlas funktioner
STYLES	Nej	Layers stil
TRANSPARENT	Nej	Transparent bakgrund
OPACITIES	Nej	Opacitet för lager eller grupp
SELECTION	Nej	Markera funktioner
mapX:EXTENT	Nej	Kartans utbredning ”X
mapX:LAYERS	Nej	Lager på kartan ”X
mapX:STYLES	Nej	Layers stil för kartan ”X
mapX:SCALE	Nej	Kartans lagerskala ”X
mapX:ROTATION	Nej	Rotation av kartan ”X
mapX:GRID_INTERVAL_X	Nej	Rutnätsintervall på kartans x-axel ”X
mapX:GRID_INTERVAL_Y	Nej	Rutnätsintervall på kartans y-axel ”X

Exempel på URL:

http://localhost/qgisserver?
SERVICE=WMS
&VERSION=1.3.0
&REQUEST=GetPrint
&MAP=/home/qgis/projects/world.qgs
&CRS=EPSG:4326
&FORMAT=png
&TEMPLATE=Layout%201
&map0:EXTENT=-180,-90,180,90
&map0:LAYERS=mylayer1,mylayer2,mylayer3
&map0:OPACITIES=125,200,125
&map0:ROTATION=45

Observera att layoutmallen kan innehålla mer än en karta. Om du vill konfigurera en specifik karta måste du därför använda parametrarna mapX: där X är ett positivt tal som du kan hämta med hjälp av begäran GetProjectSettings.

Till exempel:

<WMS_Capabilities>
...
<ComposerTemplates xsi:type="wms:_ExtendedCapabilities">
<ComposerTemplate width="297" height="210" name="Druckzusammenstellung 1">
<ComposerMap width="171" height="133" name="map0"/>
<ComposerMap width="49" height="46" name="map1"/></ComposerTemplate>
</ComposerTemplates>
...
</WMS_Capabilities>

TEMPLATE

Denna parameter kan användas för att ange namnet på en layoutmall som ska användas för utskrift.

FORMAT

Denna parameter anger formatet för kartbilden. Tillgängliga värden är:

png (standardvärde)
image/png
jpg
jpeg
image/jpeg
svg
image/svg
image/svg+xml
pdf
application/pdf

Om parametern FORMAT skiljer sig från något av dessa värden returneras ett undantag.

FORMAT_OPTIONS

Denna parameter kan användas för att ange alternativ för det valda formatet. Endast för FORMAT=application/pdf i GetPrint-begäranden. Tar emot en lista med nyckel:värde-par separerade med semikolon:

RASTERIZE_WHOLE_IMAGE: om hela pdf:en ska exporteras som en bild. Standard: false.
FORCE_VECTOR_OUTPUT: om pdf ska exporteras som vektor. Standard: false.
APPEND_GEOREFERENCE: om georeferensinformation ska läggas till i pdf-filen. Standard: true.
EXPORT_METADATA: om metadata ska läggas till i pdf-filen. Standard: true.
TEXT_RENDER_FORMAT: anger textrenderingsformatet för pdf-export. Det kan vara AlwaysOutlines (standard) eller AlwaysText.
SIMPLIFY_GEOMETRY: anger om geometrierna för objekten ska förenklas. Standard: true.
WRITE_GEO_PDF: anger om en geospatial PDF ska exporteras. Standard: false.
USE_ISO_32000_EXTENSION_FORMAT_GEOREFERENCING: Anger om Iso32000 georeferenser ska användas. Standard: false.
USE_OGC_BEST_PRACTICE_FORMAT_GEOREFERENCING: anger om OGC:s bästa praxis för georeferenser ska användas. Standard: false.
EXPORT_THEMES: en kommaseparerad lista över kartteman som ska användas för en Geospatial PDF-export
PREDEFINED_MAP_SCALES: en kommaseparerad lista över kartskalor för att återge kartan
LOSSLESS_IMAGE_COMPRESSION: om bilder som är inbäddade i pdf måste komprimeras med en förlustfri algoritm. Standard: false.
DISABLE_TILED_RASTER_RENDERING: anger om rastrering ska ske i pdf-filen. Standard: false.

Exempel på URL:

http://localhost/qgisserver?
SERVICE=WMS
&VERSION=1.3.0
&REQUEST=GetPrint
&MAP=/home/qgis/projects/world.qgs
&CRS=EPSG:4326
&FORMAT=pdf
&TEMPLATE=Layout%201
&FORMAT_OPTIONS=FORCE_VECTOR_OUTPUT:TRUE;TEXT_RENDER_FORMAT:AlwaysOutlines;PREDEFINED_MAP_SCALES:250

ATLAS_PK

Denna parameter gör det möjligt att aktivera Atlas-rendering genom att ange vilka funktioner som ska skrivas ut. För att hämta en atlas med alla funktioner kan symbolen * användas (i enlighet med det maximala antalet funktioner som tillåts i projektkonfigurationen).

När FORMAT är pdf returneras ett enda PDF-dokument som kombinerar funktionssidorna. För alla andra format returneras en enda sida.

mapX:EXTENT

Denna parameter anger omfattningen för ett layoutmappningsobjekt som xmin,ymin,xmax,ymax.

mapX:ROTATION

Denna parameter anger kartans rotation i grader.

mapX:GRID_INTERVAL_X

Denna parameter anger rutnätets linjetäthet i X-riktningen.

mapX:GRID_INTERVAL_Y

Denna parameter anger rutnätets linjetäthet i Y-riktningen.

mapX:SCALE

Denna parameter anger kartskalan för ett kartobjekt i layouten. Detta är användbart för att säkerställa skalbaserad synlighet av lager och etiketter även om klient och server kan ha olika algoritmer för att beräkna skalans nämnare.

mapX:LAYERS

Den här parametern anger lagren för ett layoutkartobjekt. Se GetMap Layers för mer information om den här parametern.

mapX:STYLES

Den här parametern anger stilarna för de lager som definieras i ett specifikt kartobjekt för layout. Se GetMap Styles för mer information om den här parametern.

3.2.8. GetProjectSettings

Den här begärandetypen fungerar på samma sätt som GetCapabilities, men den är mer specifik för QGIS Server och gör det möjligt för en klient att läsa ytterligare information som inte är tillgänglig i GetCapabilities:

initial synlighet för lager
information om vektorattribut och deras redigeringstyper
information om lagerordning och ritningsordning
lista över lager som publicerats i WFS
visa om en grupp i lagerträdet är ömsesidigt exklusiv

Begäran GetProjectSettings stöder följande parametrar:

Parameter	Obligatorisk	Beskrivning
MAP	Ja	QGIS-projektfil
SERVICE	Ja	Namn på tjänsten (WMS)
REQUEST	Ja	Namn på begäran (GetProjectSettings)

3.2.9. GetSchemaExtension

Begäran GetSchemaExtension gör det möjligt att hämta valfria utökade funktioner och operationer för WMS-tjänsten, såsom de som implementeras av QGIS Server.

Parameter	Obligatorisk	Beskrivning
MAP	Ja	QGIS-projektfil
SERVICE	Ja	Namn på tjänsten (WMS)
REQUEST	Ja	Namn på begäran (GetSchemaExtension)

Exempel på URL:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetSchemaExtension

XML-dokumentet ser ut som följer:

<schema xmlns="http://www.w3.org/2001/XMLSchema" xmlns:wms="http://www.opengis.net/wms" xmlns:qgs="http://www.qgis.org/wms" targetNamespace="http://www.qgis.org/wms" elementFormDefault="qualified" version="1.0.0">
    <import namespace="http://www.opengis.net/wms" schemaLocation="http://schemas.opengis.net/wms/1.3.0/capabilities_1_3_0.xsd"/>
    <element name="GetPrint" type="wms:OperationType" substitutionGroup="wms:_ExtendedOperation"/>
    <element name="GetStyles" type="wms:OperationType" substitutionGroup="wms:_ExtendedOperation"/>
</schema>

3.2.10. Externa WMS-lager

QGIS Server tillåter inkludering av lager från externa WMS-servrar i WMS GetMap och WMS GetPrint. Detta är särskilt användbart om en webbklient använder ett externt bakgrundslager i webbkartan. Av prestandaskäl bör sådana lager begäras direkt av webbklienten (inte kaskaderas via QGIS-servern). För utskrift bör dock dessa lager kaskadkopplas via QGIS-servern för att visas i den utskrivna kartan.

Externa lager kan läggas till i LAYERS-parametern som EXTERNAL_WMS:<layername>. Parametrarna för de externa WMS-lagren (t.ex. url, format, dpiMode, crs, lager, stilar) kan senare anges som serviceparametrar <layername>:<parameter>. I en GetMap -begäran kan detta se ut så här:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetMap
&LAYERS=EXTERNAL_WMS:basemap,layer1,layer2
&OPACITIES=100,200,255
&STYLES=,,
&basemap:url=http://externalserver.com/wms.fcgi
&basemap:format=image/jpeg
&basemap:dpiMode=7
&basemap:crs=EPSG:2056
&basemap:layers=orthofoto
&basemap:styles=default

På samma sätt kan externa lager användas i GetPrint-begäranden:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetPrint
&TEMPLATE=A4
&map0:layers=EXTERNAL_WMS:basemap,layer1,layer2
&map0:EXTENT=<minx,miny,maxx,maxy>
&OPACITIES=100,200,255
&basemap:url=http://externalserver.com/wms.fcgi
&basemap:format=image/jpeg
&basemap:dpiMode=7
&basemap:crs=EPSG:2056
&basemap:layers=orthofoto
&basemap:styles=default

3.2.11. Redlining

Den här funktionen är tillgänglig och kan användas med förfrågningarna GetMap och GetPrint.

Redlining-funktionen kan användas för att skicka geometrier och etiketter i begäran som överlappas av servern över den standardbild (karta) som returneras. Detta gör det möjligt för användaren att betona eller kanske lägga till kommentarer (etiketter) till vissa områden, platser etc. som inte finns med i standardkartan.

Begäran GetMap har följande format:

http://localhost/qgisserver?
SERVICE=WMS
&VERSION=1.3.0
&REQUEST=GetMap
&HIGHLIGHT_GEOM=POLYGON((590000 5647000, 590000 6110620, 2500000 6110620, 2500000 5647000, 590000 5647000))
&HIGHLIGHT_SYMBOL=<StyledLayerDescriptor><UserStyle><Name>Highlight</Name><FeatureTypeStyle><Rule><Name>Symbol</Name><LineSymbolizer><Stroke><SvgParameter name="stroke">%23ea1173</SvgParameter><SvgParameter name="stroke-opacity">1</SvgParameter><SvgParameter name="stroke-width">1.6</SvgParameter></Stroke></LineSymbolizer></Rule></FeatureTypeStyle></UserStyle></StyledLayerDescriptor>
&HIGHLIGHT_LABELSTRING=Write label here
&HIGHLIGHT_LABELSIZE=16
&HIGHLIGHT_LABELCOLOR=%23000000
&HIGHLIGHT_LABELBUFFERCOLOR=%23FFFFFF
&HIGHLIGHT_LABELBUFFERSIZE=1.5

Motsvarigheten till GetPrint är i formatet (observera att parametern mapX: har lagts till för att tala om vilken karta som har redlining):

http://localhost/qgisserver?
SERVICE=WMS
&VERSION=1.3.0
&REQUEST=GetPrint
&map0:HIGHLIGHT_GEOM=POLYGON((590000 5647000, 590000 6110620, 2500000 6110620, 2500000 5647000, 590000 5647000))
&map0:HIGHLIGHT_SYMBOL=<StyledLayerDescriptor><UserStyle><Name>Highlight</Name><FeatureTypeStyle><Rule><Name>Symbol</Name><LineSymbolizer><Stroke><SvgParameter name="stroke">%23ea1173</SvgParameter><SvgParameter name="stroke-opacity">1</SvgParameter><SvgParameter name="stroke-width">1.6</SvgParameter></Stroke></LineSymbolizer></Rule></FeatureTypeStyle></UserStyle></StyledLayerDescriptor>
&map0:HIGHLIGHT_LABELSTRING=Write label here
&map0:HIGHLIGHT_LABELSIZE=16
&map0:HIGHLIGHT_LABELCOLOR=%23000000
&map0:HIGHLIGHT_LABELBUFFERCOLOR=%23FFFFFF
&map0:HIGHLIGHT_LABELBUFFERSIZE=1.5

Här är bilden som matas ut av ovanstående begäran där en polygon och en etikett ritas ovanpå den normala kartan:

../../../_images/server_redlining.png — Fig. 3.23 Serverns svar på en GetMap-begäran med redlining-parametrar

Du kan se att det finns flera parametrar i denna begäran för att styra redlining-funktionen. Den fullständiga listan innehåller:

HIGHLIGHT_GEOM: Du kan lägga till POINT, MULTILINESTRING, POLYGON etc. Den stöder geometrier med flera delar. Här är ett exempel: HIGHLIGHT_GEOM=MULTILINESTRING((0 0, 0 1, 1 1)). Koordinaterna ska finnas i CRS för GetMap/GetPrint-begäran.
HIGHLIGHT_LABELBUFFERCOLOR: Denna parameter styr etikettens buffertfärg.
HIGHLIGHT_LABELBUFFERSIZE: Denna parameter styr etikettbuffertens storlek.
HIGHLIGHT_LABELCOLOR: Denna parameter styr etikettens färg.
HIGHLIGHT_LABEL_DISTANCE: styr avståndet mellan objektet (t.ex. punkt eller linje) och etiketten i mm
HIGHLIGHT_LABELFONT: Denna parameter styr etikettens teckensnitt (t.ex. Arial)
HIGHLIGHT_LABEL_HORIZONTAL_ALIGNMENT: placerar etiketten horisontellt på en punkt med den angivna inriktningen (t.ex. ”vänster”, ”mitt”, ”höger”)
HIGHLIGHT_LABEL_ROTATION: styr etikettens rotation i grader
HIGHLIGHT_LABELSIZE: Denna parameter styr storleken på etiketten.
HIGHLIGHT_LABELSTRING: Du kan skicka din märkningstext till den här parametern.
HIGHLIGHT_LABEL_VERTICAL_ALIGNMENT: placerar etiketten vertikalt på en punkt med hjälp av den angivna inriktningen (t.ex. ”topp”, ”halv”, ”botten”)
HIGHLIGHT_SYMBOL: Här styrs hur geometrin ska markeras och du kan ändra streckbredd, färg och opacitet.