Важно

Prevod je zajednički napor :ref:`možete se pridružiti `. Ova stranica je trenutno prevedena na |napredak prevođenja|.

3.2. Web Map Service (WMS)

WMS standardi 1.1.1 i 1.3.0 implementirani u QGIS Serveru pružaju HTTP interfejs za zahtevanje slika karte ili legende generisanih iz QGIS projekta. Tipičan WMS zahtev definiše QGIS projekat koji se koristi, slojeve za iscrtavanje, kao i format slike koji se generiše. Dostupna je i osnovna podrška za Styled Layer Descriptor (SLD).

Specifikacije:

Standardni zahtevi koje pruža QGIS Server:

Zahtev

Opis

GetCapabilities

Vraća XML metapodatke sa informacijama o serveru

GetMap

Vraća kartu

GetFeatureInfo

Preuzima podatke (geometriju i vrednosti) za poziciju piksela

GetLegendGraphic

Vraća simbole legende

GetStyle(s)

Vraća XML dokument sa opisom stila u SLD-u

DescribeLayer

Vraća informacije o dostupnosti WFS-a i WCS-a za vektorske odnosno rasterske slojeve

Zahtevi specifični za QGIS Server:

Zahtev

Opis

GetPrint

Vraća QGIS prikaz

GetProjectSettings

Vraća specifične informacije o QGIS Serveru

GetSchemaExtension

Vraća XML metapodatke o opcionim proširenim mogućnostima

3.2.1. GetCapabilities

Standardni parametri za zahtev GetCapabilities prema OGC WMS 1.1.1 i 1.3.0 specifikacijama:

Parametar

Obavezno

Opis

SERVICE

Da

Naziv servisa (WMS)

REQUEST

Da

Naziv zahteva (GetCapabilities)

VERSION

Ne

Verzija servisa

Zahtev GetCapabilities podržava i sledeće parametre specifične za QGIS Server:

Parametar

Obavezno

Opis

MAP

Da

QGIS projektna datoteka

Primer URL-a:

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

3.2.2. GetMap

Standardni parametri za zahtev GetMap prema OGC WMS 1.1.1 i 1.3.0 specifikacijama:

Parametar

Obavezno

Opis

SERVICE

Da

Naziv servisa (WMS)

REQUEST

Da

Naziv zahteva (GetMap)

VERSION

Da

Verzija servisa

LAYERS

Ne

Slojevi za prikaz

STYLES

Ne

Stil slojeva

SRS / CRS

Da

Koordinatni referentni sistem

BBOX

Da

Obuhvat karte

WIDTH

Da

Širina slike u pikselima

HEIGHT

Da

Visina slike u pikselima

FORMAT

Ne

Format slike

TRANSPARENT

Ne

Prozirna pozadina

SLD

Ne

URL SLD-a koji se koristi za stilizovanje

SLD_BODY

Ne

Ugrađeni SLD (XML) koji se koristi za stilizovanje

Pored standardnih, QGIS Server podržava obeležavanje, spoljne WMS slojeve, kao i sledeće dodatne parametre:

Parametar

Obavezno

Opis

MAP

Da

QGIS projektna datoteka

BGCOLOR

Ne

Zadaje boju pozadine

DPI

Ne

Zadaje izlaznu rezoluciju

IMAGE_QUALITY

Ne

JPEG kompresija

OPACITIES

Ne

Neprozirnost sloja ili grupe

FILTER

Ne

Podskup objekata

SELECTION

Ne

Istakni objekte

FILE_NAME

Ne

Naziv preuzete datoteke

Samo za FORMAT=application/dxf

FORMAT_OPTIONS

Ne

Opcije zadatog formata datoteke

Samo za FORMAT=application/dxf

TILED

Ne

Rad u režimu pločica

Primer URL-a:

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

Ovaj parametar omogućava zadavanje verzije servisa koja se koristi. Dostupne vrednosti za parametar VERSION su:

  • 1.1.1

  • 1.3.0

U zavisnosti od broja verzije, treba očekivati manje razlike, kako je objašnjeno u nastavku za sledeće parametre:

  • CRS / SRS

  • BBOX

LAYERS

Ovaj parametar omogućava zadavanje slojeva koji se prikazuju na karti. Nazivi moraju biti razdvojeni zarezom.

Pored toga, QGIS Server je uveo neke opcije za izbor slojeva po:

  • ID-ju sloja: opcija projekta koja omogućava izbor slojeva po njihovom ID-ju nalazi se u kartici QGIS Server ► WMS dijaloga Projekat ► Svojstva…. Označite polje Koristi ID-jeve slojeva kao nazive da biste aktivirali ovu opciju.

  • po kratkom nazivu

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

STYLES

Ovaj parametar se može koristiti za zadavanje stila sloja u koraku iscrtavanja. Stilovi moraju biti razdvojeni zarezom. Naziv podrazumevanog stila je default.

SRS / CRS

Ovaj parametar omogućava naznačavanje prostornog referentnog sistema izlazne karte u WMS 1.1.1 i mora biti formiran kao EPSG:XXXX. Imajte u vidu da je CRS takođe podržan ako je trenutna verzija 1.1.1.

Za WMS 1.3.0 parametar CRS je poželjniji, ali je i SRS podržan.

Imajte u vidu da, ako su u zahtevu naznačena oba parametra CRS i SRS, presudna je trenutna verzija naznačena u parametru VERSION.

U sledećem slučaju, parametar SRS se zadržava bez obzira na parametar VERSION, jer CRS nije naznačen:

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

U sledećem slučaju, parametar SRS se zadržava umesto CRS zbog parametra VERSION:

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

U sledećem slučaju, parametar CRS se zadržava umesto SRS zbog parametra VERSION:

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

BBOX

Ovaj parametar omogućava zadavanje obuhvata karte u jedinicama prema tekućem CRS-u. Koordinate moraju biti razdvojene zarezom.

Parametar BBOX se formira kao min_a,min_b,max_a,max_b, ali se definicija osa a i b razlikuje u zavisnosti od trenutnog parametra VERSION:

  • u WMS 1.1.1, redosled osa je uvek istok/sever

  • u WMS 1.3.0, redosled osa zavisi od autoriteta CRS-a

Na primer, u slučaju EPSG:4326 i WMS 1.1.1, a je geografska dužina (istok), a b geografska širina (sever), što daje zahtev poput:

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

Ali u slučaju WMS 1.3.0, redosled osa definisan u EPSG bazi podataka je sever/istok, pa je a geografska širina, a b geografska dužina:

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

WIDTH

Ovaj parametar omogućava zadavanje širine izlazne slike u pikselima.

HEIGHT

Ovaj parametar omogućava zadavanje visine izlazne slike u pikselima.

FORMAT

Ovaj parametar se može koristiti za zadavanje formata slike karte. Dostupne vrednosti su:

  • jpg

  • jpeg

  • image/jpeg

  • image/png

  • image/png; mode=1bit

  • image/png; mode=8bit

  • image/png; mode=16bit

  • image/webp

  • application/dxf: samo slojevi koji imaju pravo čitanja u WFS servisu izvoze se u DXF formatu

  • application/pdf

    Primer URL-a:

    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

Ovaj logički parametar se može koristiti za zadavanje prozirnosti pozadine. Dostupne vrednosti su (bez razlikovanja velikih i malih slova):

  • TRUE

  • FALSE

Međutim, ovaj parametar se zanemaruje ako je format slike naznačen sa FORMAT različit od PNG.

BGCOLOR

Ovaj parametar omogućava naznačavanje boje pozadine slike karte. Međutim, ne može se kombinovati sa parametrom TRANSPARENT u slučaju PNG slika (prozirnost ima prioritet). Boja može biti u doslovnom ili heksadecimalnom zapisu.

Primer URL-a sa doslovnim zapisom:

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

Primer URL-a sa heksadecimalnim zapisom:

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

DPI

Ovaj parametar se može koristiti za zadavanje željene izlazne rezolucije.

IMAGE_QUALITY

Ovaj parametar se koristi samo za JPEG slike. Podrazumevano je JPEG kompresija -1.

Podrazumevanu vrednost možete promeniti po QGIS projektu u meniju OWS Server ► WMS mogućnosti dijaloga Projekat ► Svojstva…. Ako želite da je zamenite u zahtevu GetMap, to možete uraditi pomoću parametra IMAGE_QUALITY.

OPACITIES

Lista vrednosti neprozirnosti razdvojenih zarezima. Neprozirnost se može podesiti na nivou sloja ili grupe. Dozvoljene vrednosti su u opsegu od 0 (potpuno prozirno) do 255 (potpuno neprozirno).

Primer URL-a:

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

Сл. 3.3 Levo OPACITIES=255,0 a desno OPACITIES=255,255

FILTER

Podskup slojeva može se izabrati parametrom FILTER. Sintaksa je u osnovi ista kao za QGIS nisku podskupa. Međutim, postoje neka ograničenja radi izbegavanja SQL injekcija u baze podataka preko QGIS Servera. Ako se u parametru pronađe opasna niska, QGIS Server će vratiti sledeću grešku:

<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>

Primer URL-a:

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

Сл. 3.4 Odgovor servera na GetMap zahtev sa parametrom FILTER

U ovom primeru, isti filter "name" = 'France' primenjuje se na slojeve countries i countries_shapeburst, dok se filter "name" = 'Paris' primenjuje samo na places.

Белешка

Moguće je vršiti pretrage atributa preko GetFeatureInfo i izostaviti parametar X/Y ako je prisutan FILTER. QGIS Server tada vraća informacije o objektima koji se podudaraju i generiše kombinovani granični pravougaonik u XML izlazu.

SELECTION

Parametar SELECTION može istaći objekte sa jednog ili više slojeva. Vektorski objekti mogu se izabrati prosleđivanjem lista ID-jeva objekata razdvojenih zarezima.

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

Sledeća slika prikazuje odgovor na GetMap zahtev pomoću opcije SELECTION, npr. http://myserver.com/...&SELECTION=countries:171,65.

Pošto ti ID-jevi objekata u izvornom skupu podataka odgovaraju Francuskoj i Rumuniji, oni su istaknuti žutom bojom.

../../../_images/server_selection_parameter.png

Сл. 3.5 Odgovor servera na GetMap zahtev sa parametrom SELECTION

FORMAT_OPTIONS

Ovaj parametar se može koristiti za zadavanje opcija izabranog formata. Samo za FORMAT=application/dxf u GetMap zahtevu. Uzima listu parova ključ:vrednost razdvojenih tačkom i zarezom:

  • SCALE: koristi se za pravila simbologije, filtere i stilove (ne za stvarno skaliranje podataka - podaci ostaju u izvornoj razmeri).

  • MODE: odgovara opcijama izvoza koje nudi dijalog za izvoz DXF-a u QGIS Desktopu. Moguće vrednosti su NOSYMBOLOGY, FEATURESYMBOLOGY i SYMBOLLAYERSYMBOLOGY.

  • LAYERATTRIBUTES: zadaje polje ili, u slučaju više slojeva, listu polja razdvojenih zarezima koja sadrže vrednosti za nazive DXF slojeva - ako nije zadato, koriste se izvorni nazivi QGIS slojeva.

  • USE_TITLE_AS_LAYERNAME: ako je uključeno, naslov sloja koristiće se kao naziv sloja.

  • CODEC: zadaje kodek koji se koristi za kodiranje. Podrazumevano je ISO-8859-1; važeće vrednosti potražite u dijalogu za izvoz DXF-a u QGIS desktopu.

  • NO_MTEXT: Koristi TEXT umesto MTEXT za natpise.

  • FORCE_2D: Prisili 2D izlaz. Ovo je potrebno za širinu polilinije.

TILED

Iz razloga performansi, QGIS Server se može koristiti u režimu pločica. U tom režimu klijent zahteva nekoliko malih pločica fiksne veličine i sastavlja ih u celu kartu. Pri tome simboli na granici ili blizu granice između dve pločice mogu izgledati odsečeno, jer su prisutni samo na jednoj od pločica.

Postavite parametar TILED na TRUE da biste QGIS Serveru zadali rad u režimu pločica i primenu Bafera pločice podešenog u QGIS projektu (pogledajte Configure your project).

Kada je TILED postavljeno na TRUE i kada je u QGIS projektu podešen bafer pločice različit od nule, objekti izvan obuhvata pločice se iscrtavaju kako bi se izbegli odsečeni simboli na granicama pločica.

TILED je podrazumevano FALSE.

3.2.3. GetFeatureInfo

Standardni parametri za zahtev GetFeatureInfo prema OGC WMS 1.1.1 i 1.3.0 specifikacijama:

Parametar

Obavezno

Opis

SERVICE

Da

Naziv servisa (WMS)

REQUEST

Da

Naziv zahteva (GetFeatureInfo)

VERSION

Ne

Verzija servisa

QUERY_LAYERS

Da

Slojevi nad kojima se vrši upit

LAYERS

Da

Slojevi za prikaz (isto kao QUERY_LAYERS)

STYLES

Ne

Stil slojeva

SRS / CRS

Da

Koordinatni referentni sistem

BBOX

Ne

Obuhvat karte

WIDTH

Da

Širina slike u pikselima

HEIGHT

Da

Visina slike u pikselima

TRANSPARENT

Ne

Prozirna pozadina

INFO_FORMAT

Ne

Izlazni format

FEATURE_COUNT

Ne

Maksimalan broj objekata koji se vraćaju

I

Ne

Kolona piksela tačke nad kojom se vrši upit

X

Ne

Isto kao parametar I, ali u WMS 1.1.1

J

Ne

Red piksela tačke nad kojom se vrši upit

Y

Ne

Isto kao parametar J, ali u WMS 1.1.1

WMS_PRECISION

Ne

Preciznost (broj cifara) koja se koristi pri vraćanju geometrije (pogledajte kako dodati geometriju u odgovor objekta). Podrazumevana vrednost je -1, što znači da se koristi preciznost definisana u projektu.

Pored standardnih, QGIS Server podržava i sledeće dodatne parametre:

Parametar

Obavezno

Opis

MAP

Da

QGIS projektna datoteka

FILTER

Ne

Podskup objekata

FI_POINT_TOLERANCE

Ne

Tolerancija u pikselima za tačkaste slojeve

FI_LINE_TOLERANCE

Ne

Tolerancija u pikselima za linijske slojeve

FI_POLYGON_TOLERANCE

Ne

Tolerancija u pikselima za poligonske slojeve

FILTER_GEOM

Ne

Filtriranje geometrije

WITH_DISPLAY_NAME

Ne

Dodaj naziv za prikaz objekta u izlaz

WITH_MAPTIP

Ne

Dodaj savete na karti u izlaz

WITH_GEOMETRY

Ne

Dodaj geometriju u izlaz

Primer URL-a:

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

Ovaj parametar se može koristiti za zadavanje formata rezultata. Dostupne vrednosti su:

  • text/xml

  • text/html

  • text/plain

  • application/vnd.ogc.gml

  • application/json

QUERY_LAYERS

Ovaj parametar zadaje slojeve koji se prikazuju na karti. Nazivi se razdvajaju zarezom.

Pored toga, QGIS Server uvodi opcije za izbor slojeva po:

  • kratkom nazivu

  • ID-ju sloja

Više informacija potražite u parametru LAYERS definisanom u GetMap.

FEATURE_COUNT

Ovaj parametar zadaje maksimalan broj objekata po sloju koji se vraćaju. Na primer, ako je QUERY_LAYERS postavljeno na layer1,layer2 a FEATURE_COUNT na 3, tada će biti vraćeno najviše 3 objekta sa layer1. Isto tako, najviše 3 objekta biće vraćeno sa layer2.

Podrazumevano se vraća samo 1 objekat po sloju.

I

Ovaj parametar, definisan u WMS 1.3.0, omogućava vam da zadate kolonu piksela tačke upita.

X

Isti parametar kao I, ali definisan u WMS 1.1.1.

J

Ovaj parametar, definisan u WMS 1.3.0, omogućava vam da zadate red piksela tačke upita.

Y

Isti parametar kao J, ali definisan u WMS 1.1.1.

FI_POINT_TOLERANCE

Ovaj parametar zadaje toleranciju u pikselima za tačkaste slojeve.

FI_LINE_TOLERANCE

Ovaj parametar zadaje toleranciju u pikselima za linijske slojeve.

FI_POLYGON_TOLERANCE

Ovaj parametar zadaje toleranciju u pikselima za poligonske slojeve.

FILTER_GEOM

Ovaj parametar zadaje WKT geometriju sa kojom objekti moraju da se preseku.

WITH_DISPLAY_NAME

Ovaj parametar zadaje da li se naziv za prikaz objekta dodaje u izlaz.

Dostupne vrednosti su (bez razlikovanja velikih i malih slova):

  • TRUE

  • FALSE

WITH_MAPTIP

Ovaj parametar zadaje da li se saveti na karti dodaju u izlaz.

Dostupne vrednosti su (bez razlikovanja velikih i malih slova):

  • TRUE

  • FALSE

  • HTML_FI_ONLY_MAPTIP: kao TRUE, s tom razlikom da HTML odgovor na zahtev za informacije o objektu sadrži samo savet na karti. Time se dobija potpuna kontrola nad HTML odgovorom pomoću npr. ugrađenog uređivača saveta na karti za sloj.

WITH_GEOMETRY

Ovaj parametar zadaje da li se geometrije dodaju u izlaz. Da biste koristili ovu mogućnost, prvo morate omogućiti opciju Dodaj geometriju u odgovor objekta u QGIS projektu. Pogledajte Podesite svoj projekat.

Dostupne vrednosti su (bez razlikovanja velikih i malih slova):

  • TRUE

  • FALSE

3.2.4. GetLegendGraphic

Standardni parametri za zahtev GetLegendGraphic prema OGC WMS 1.1.1 i 1.3.0 specifikacijama:

Parametar

Obavezno

Opis

SERVICE

Da

Naziv servisa (WMS)

REQUEST

Da

Naziv zahteva (GetLegendGraphic)

VERSION

Ne

Verzija servisa

LAYERS

Da

Slojevi za prikaz

STYLES

Ne

Stil slojeva

SRS / CRS

Ne

Koordinatni referentni sistem

BBOX

Ne

Obuhvat karte

WIDTH

Ne

Širina slike u pikselima

HEIGHT

Ne

Visina slike u pikselima

FORMAT

Ne

Format legende

TRANSPARENT

Ne

Prozirna pozadina

Pored standardnih, QGIS Server podržava dodatne parametre za promenu veličine elemenata legende ili svojstava fonta za naslove slojeva i natpise stavki:

Parametar

Obavezno

Opis

MAP

Da

QGIS projektna datoteka

SRCWIDTH

Ne

Širina karte

SRCHEIGHT

Ne

Visina karte

SHOWFEATURECOUNT

Ne

Dodaj broj objekata

RULE

Ne

Simbol pravila koji se iscrtava

RULELABEL

Ne

Iscrtavanje natpisa stavki

BOXSPACE

Ne

Razmak između okvira legende i sadržaja (mm)

LAYERSPACE

Ne

Vertikalni razmak između slojeva (mm)

LAYERTITLESPACE

Ne

Vertikalni razmak između naslova sloja i stavki (mm)

SYMBOLSPACE

Ne

Vertikalni razmak između simbola i stavki (mm)

ICONLABELSPACE

Ne

Horizontalni razmak između simbola i natpisa (mm)

SYMBOLWIDTH

Ne

Širina pregleda simbola (mm)

SYMBOLHEIGHT

Ne

Visina pregleda simbola (mm)

LAYERTITLE

Ne

Iscrtavanje naslova sloja

LAYERFONTFAMILY

Ne

Familija fonta sloja

LAYERFONTBOLD

Ne

Podebljano iscrtavanje naslova sloja

LAYERFONTSIZE

Ne

Veličina fonta naslova sloja (pt)

LAYERFONTITALIC

Ne

Kurzivno iscrtavanje naslova sloja

LAYERFONTCOLOR

Ne

Boja naslova sloja

ITEMFONTFAMILY

Ne

Familija fonta stavke

ITEMFONTBOLD

Ne

Podebljano iscrtavanje natpisa stavke

ITEMFONTSIZE

Ne

Veličina fonta natpisa stavke (pt)

ITEMFONTITALIC

Ne

Kurzivno iscrtavanje natpisa stavke

ITEMFONTCOLOR

Ne

Boja natpisa stavke

SHOWRULEDETAILS

Ne

Dodaje tekst pravila u JSON izlaz

ADDLAYERGROUPS

Ne

Dodaje grupe slojeva u JSON izlaz

BBOX

Ovaj parametar se može koristiti za zadavanje geografske oblasti za koju treba izgraditi legendu (njegov format opisan je ovde), ali se ne može kombinovati sa parametrom RULE. Parametar SRS/CRS postaje obavezan kada se koristi parametar BBOX.

Primer URL-a:

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

Белешка

Kada je parametar BBOX definisan, legenda se naziva legenda zasnovana na sadržaju.

WIDTH

Ovaj parametar se podrazumevano ne koristi, ali postaje obavezan kada je postavljen parametar RULE. U tom slučaju omogućava zadavanje širine izlazne slike u pikselima.

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

HEIGHT

Ovaj parametar se podrazumevano ne koristi, ali postaje obavezan kada je postavljen parametar RULE. U tom slučaju omogućava zadavanje visine izlazne slike u pikselima.

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

FORMAT

Ovaj parametar se može koristiti za zadavanje formata slike legende. Dostupne vrednosti su:

  • image/jpeg

  • image/png

  • application/json

Za JSON, simboli su kodirani u Base64, a većina drugih opcija vezanih za raspored ili fontove ne uzima se u obzir jer se legenda mora izgraditi na strani klijenta. Parametar RULE ne može se kombinovati sa ovim formatom.

Primer URL-a sa odgovarajućim JSON izlazom:

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

I odgovarajući JSON izlaz:

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

SRCWIDTH

Ovaj parametar se može definisati kada je postavljen parametar RULE. U tom slučaju, vrednost SRCWIDTH prosleđuje se osnovnom zahtevu GetMap kao parametar WIDTH, dok se parametar WIDTH zahteva GetLegendGraphic koristi za veličinu slike legende.

SRCHEIGHT

Ovaj parametar se može definisati kada je postavljen parametar RULE. U tom slučaju, vrednost SRCHEIGHT prosleđuje se osnovnom zahtevu GetMap kao parametar HEIGHT, dok se parametar HEIGHT zahteva GetLegendGraphic koristi za veličinu slike legende.

SHOWFEATURECOUNT

Ovaj parametar se može koristiti za aktiviranje broja objekata u legendi. Dostupne vrednosti su (bez razlikovanja velikih i malih slova):

  • TRUE

  • FALSE

Na primer:

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

RULE

Ovaj parametar je dostupan na slojevima sa iscrtavanjem Zasnovano na pravilima i omogućava izgradnju legende samo sa imenovanim simbolom pravila. Ne može se kombinovati sa parametrom BBOX. HEIGHT i WIDTH moraju biti zadati.

Primer URL-a:

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

RULELABEL

Ovaj parametar omogućava kontrolu iscrtavanja natpisa stavke. Dostupne vrednosti su (bez razlikovanja velikih i malih slova):

  • TRUE: prikaži natpis stavke

  • FALSE: sakrij natpis stavke

  • AUTO: sakrij natpis stavke za slojeve sa iscrtavanjem Jedan simbol

Primer URL-a:

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

Сл. 3.6 Iscrtavanje legende bez natpisa za slojeve sa jednim simbolom

BOXSPACE

Ovaj parametar omogućava zadavanje razmaka između okvira legende i sadržaja u milimetrima. Podrazumevano je vrednost razmaka 2 mm.

Primer URL-a:

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

Сл. 3.7 Levo BOXSPACE=0 a desno BOXSPACE=15

LAYERSPACE

Ovaj parametar omogućava zadavanje vertikalnog razmaka između slojeva u milimetrima. Podrazumevano je vrednost razmaka 3 mm.

Primer URL-a:

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

Сл. 3.8 Levo LAYERSPACE=0 a desno LAYERSPACE=10

LAYERTITLESPACE

Ovaj parametar omogućava zadavanje vertikalnog razmaka između naslova sloja i stavki koje slede, u milimetrima. Podrazumevano je vrednost razmaka 3 mm.

Primer URL-a:

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

Сл. 3.9 Levo LAYERTITLESPACE=0 a desno LAYERTITLESPACE=10

SYMBOLSPACE

Ovaj parametar omogućava zadavanje vertikalnog razmaka između simbola i stavke koja sledi, u milimetrima. Podrazumevano je vrednost razmaka 2 mm.

Primer URL-a:

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

Сл. 3.10 Levo SYMBOLSPACE=0 a desno SYMBOLSPACE=5

ICONLABELSPACE

Ovaj parametar omogućava zadavanje horizontalnog razmaka između simbola i teksta natpisa, u milimetrima. Podrazumevano je vrednost razmaka 2 mm.

Primer URL-a:

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

Сл. 3.11 Levo ICONLABELSPACE=0 a desno ICONLABELSPACE=10

SYMBOLWIDTH

Ovaj parametar omogućava zadavanje širine pregleda simbola u milimetrima. Podrazumevano je vrednost širine 7 mm.

Primer URL-a:

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

Сл. 3.12 Levo SYMBOLWIDTH=2 a desno SYMBOLWIDTH=20

SYMBOLHEIGHT

Ovaj parametar omogućava zadavanje visine pregleda simbola u milimetrima. Podrazumevano je vrednost visine 4 mm.

Primer URL-a:

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

Сл. 3.13 Levo SYMBOLHEIGHT=2 a desno SYMBOLHEIGHT=6

LAYERTITLE

Ovaj parametar zadaje da li se iscrtava naslov sloja.

Dostupne vrednosti su (bez razlikovanja velikih i malih slova):

  • TRUE (podrazumevana vrednost)

  • FALSE

LAYERFONTFAMILY

Ovaj parametar zadaje familiju fonta koja se koristi za iscrtavanje naslova sloja.

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

LAYERFONTBOLD

Ovaj parametar zadaje da li se naslov sloja iscrtava podebljano. Dostupne vrednosti su (bez razlikovanja velikih i malih slova):

  • TRUE

  • FALSE

Primer URL-a:

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

Сл. 3.14 Legenda sa LAYERFONTBOLD=TRUE

LAYERFONTSIZE

Ovaj parametar zadaje veličinu fonta za iscrtavanje naslova sloja u tačkama.

Primer URL-a:

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

Сл. 3.15 Legenda sa LAYERFONTSIZE=20

LAYERFONTITALIC

Ovaj parametar zadaje da li se naslov sloja iscrtava kurzivom. Dostupne vrednosti su (bez razlikovanja velikih i malih slova):

  • TRUE

  • FALSE

Primer URL-a:

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

Сл. 3.16 Legenda sa LAYERFONTITALIC=TRUE

LAYERFONTCOLOR

Ovaj parametar zadaje boju naslova sloja. Boja može biti doslovna (red, green, ..) ili u heksadecimalnom zapisu (0xFF0000, 0x00FF00, …).

Primer URL-a:

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

Сл. 3.17 Legenda sa LAYERFONTCOLOR=0x5f9930

ITEMFONTFAMILY

Ovaj parametar zadaje familiju fonta koja se koristi za iscrtavanje natpisa stavke.

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

ITEMFONTBOLD

Ovaj parametar zadaje da li se natpis stavke iscrtava podebljano. Dostupne vrednosti su (bez razlikovanja velikih i malih slova):

  • TRUE

  • FALSE

Primer URL-a:

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

Сл. 3.18 Legenda sa ITEMFONTBOLD=TRUE

ITEMFONTSIZE

Ovaj parametar zadaje veličinu fonta za iscrtavanje naslova sloja u tačkama.

Primer URL-a:

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

Сл. 3.19 Legenda sa ITEMFONTSIZE=30

ITEMFONTITALIC

Ovaj parametar zadaje da li se natpis stavke iscrtava kurzivom. Dostupne vrednosti su (bez razlikovanja velikih i malih slova):

  • TRUE

  • FALSE

Primer URL-a:

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

Сл. 3.20 Legenda sa ITEMFONTITALIC=TRUE

ITEMFONTCOLOR

Ovaj parametar zadaje boju natpisa stavke. Boja može biti doslovna (red, green, ..) ili u heksadecimalnom zapisu (0xFF0000, 0x00FF00, …).

Primer URL-a:

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

Сл. 3.21 Legenda sa ITEMFONTCOLOR=0x5f9930

SHOWRULEDETAILS

Ovaj parametar zadaje da li će JSON izlaz sadržati i detalje o pravilu koje je generisalo stavku legende. Ovaj parametar ima efekta samo kada je iscrtavač zasnovan na pravilima ili kategorizovan.

Primer URL-a sa odgovarajućim JSON izlazom:

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

I odgovarajući JSON izlaz:

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

ADDLAYERGROUPS

Ovaj parametar zadaje da li će JSON izlaz prikazivati i nazive grupa slojeva (i podgrupa) u stavci legende. Moguće vrednosti su:

  • TRUE: prikaži natpise grupa

  • FALSE (podrazumevano): sakrij natpise grupa

../../../_images/wms_getlegendgraphic_addlayergroups.png

Сл. 3.22 Legenda bez (levo) i sa (desno) prikazom natpisa grupa slojeva

Odgovarajući JSON izlaz koji prikazuje naziv grupa izgledao bi ovako:

{ "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)

Standardni parametri za zahtev GetStyle (ili GetStyles) prema OGC WMS 1.1.1 specifikacijama:

Parametar

Obavezno

Opis

SERVICE

Da

Naziv servisa (WMS)

REQUEST

Da

Naziv zahteva (GetStyle ili GetStyles)

LAYERS

Da

Slojevi nad kojima se vrši upit

Zahtev GetStyle podržava i sledeće parametre specifične za QGIS Server:

Parametar

Obavezno

Opis

MAP

Da

QGIS projektna datoteka

Primer URL-a:

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

3.2.6. DescribeLayer

Standardni parametri za zahtev DescribeLayer prema OGC WMS 1.1.1 i 1.3.0 specifikacijama:

Parametar

Obavezno

Opis

SERVICE

Da

Naziv servisa (WMS)

REQUEST

Da

Naziv zahteva (DescribeLayer)

LAYERS

Da

Slojevi koji se opisuju

SLD_VERSION

Da

Verzija SLD-a

Zahtev DescribeLayer podržava i sledeće parametre specifične za QGIS Server:

Parametar

Obavezno

Opis

MAP

Da

QGIS projektna datoteka

Primer URL-a:

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

XML dokument izgleda ovako:

<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

Ovaj parametar omogućava zadavanje verzije SLD-a. Dostupna je samo vrednost 1.1.0.

3.2.7. GetPrint

QGIS Server ima mogućnost da pravi izlaz štampanog prikaza u pdf ili pikselskom formatu. Prozori štampanog prikaza u objavljenom projektu koriste se kao šabloni. U zahtevu GetPrint klijent ima mogućnost da zada parametre sadržanih karata i natpisa prikaza.

Zahtev GetPrint podržava obeležavanje, spoljne WMS slojeve, kao i sledeće parametre:

Parametar

Obavezno

Opis

MAP

Da

QGIS projektna datoteka

SERVICE

Da

Naziv servisa (WMS)

REQUEST

Da

Naziv zahteva (GetPrint)

VERSION

Ne

Verzija servisa

LAYERS

Ne

Slojevi za prikaz

TEMPLATE

Da

Šablon prikaza koji se koristi

SRS / CRS

Da

Koordinatni referentni sistem

FORMAT

Ne

Izlazni format

FORMAT_OPTIONS

Ne

Opcije zadatog formata datoteke

Samo za FORMAT=application/pdf

ATLAS_PK

Ne

Objekti atlasa

STYLES

Ne

Stil slojeva

TRANSPARENT

Ne

Prozirna pozadina

OPACITIES

Ne

Neprozirnost sloja ili grupe

SELECTION

Ne

Istakni objekte

mapX:EXTENT

Ne

Obuhvat karte „X“

mapX:LAYERS

Ne

Slojevi karte „X“

mapX:STYLES

Ne

Stil slojeva karte „X“

mapX:SCALE

Ne

Razmera slojeva karte „X“

mapX:ROTATION

Ne

Rotacija karte „X“

mapX:GRID_INTERVAL_X

Ne

Interval mreže na x osi karte „X“

mapX:GRID_INTERVAL_Y

Ne

Interval mreže na y osi karte „X“

Primer URL-a:

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

Imajte u vidu da šablon prikaza može sadržati više od jedne karte. Na taj način, ako želite da podesite određenu kartu, morate koristiti parametre mapX:, gde je X pozitivan broj koji možete dobiti zahtevom GetProjectSettings.

Na primer:

<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

Ovaj parametar se može koristiti za zadavanje naziva šablona prikaza koji se koristi za štampanje.

FORMAT

Ovaj parametar zadaje format slike karte. Dostupne vrednosti su:

  • png (podrazumevana vrednost)

  • image/png

  • jpg

  • jpeg

  • image/jpeg

  • svg

  • image/svg

  • image/svg+xml

  • pdf

  • application/pdf

Ako je parametar FORMAT različit od jedne od ovih vrednosti, vraća se izuzetak.

FORMAT_OPTIONS

Ovaj parametar se može koristiti za zadavanje opcija izabranog formata. Samo za FORMAT=application/pdf u GetPrint zahtevima. Uzima listu parova ključ:vrednost razdvojenih tačkom i zarezom:

  • RASTERIZE_WHOLE_IMAGE: da li ceo pdf treba izvesti kao sliku. Podrazumevano: false.

  • FORCE_VECTOR_OUTPUT: da li pdf treba izvesti kao vektor. Podrazumevano: false.

  • APPEND_GEOREFERENCE: da li informacije o georeferenciranju treba dodati u pdf. Podrazumevano: true.

  • EXPORT_METADATA: da li metapodatke treba dodati u pdf. Podrazumevano: true.

  • TEXT_RENDER_FORMAT: postavlja format iscrtavanja teksta za izvoz pdf-a. Može biti AlwaysOutlines (podrazumevano) ili AlwaysText.

  • SIMPLIFY_GEOMETRY: da li geometrije objekata treba uprostiti. Podrazumevano: true.

  • WRITE_GEO_PDF: da li treba izvesti geoprostorni PDF. Podrazumevano: false.

  • USE_ISO_32000_EXTENSION_FORMAT_GEOREFERENCING: da li treba koristiti Iso32000 georeferenciranje. Podrazumevano: false.

  • USE_OGC_BEST_PRACTICE_FORMAT_GEOREFERENCING: da li treba koristiti OGC georeferenciranje po najboljoj praksi. Podrazumevano: false.

  • EXPORT_THEMES: lista tema karte razdvojenih zarezima koje se koriste za izvoz geoprostornog PDF-a

  • PREDEFINED_MAP_SCALES: lista razmera karte razdvojenih zarezima za iscrtavanje karte

  • LOSSLESS_IMAGE_COMPRESSION: da li slike ugrađene u pdf moraju biti kompresovane algoritmom bez gubitaka. Podrazumevano: false.

  • DISABLE_TILED_RASTER_RENDERING: da li rasteri treba da budu bez pločica u pdf-u. Podrazumevano: false.

Primer URL-a:

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

Ovaj parametar omogućava aktiviranje iscrtavanja atlasa naznačavanjem objekata koje želimo da odštampamo. Da biste dobili atlas sa svim objektima, može se koristiti simbol * (u skladu sa maksimalnim brojem objekata dozvoljenim u konfiguraciji projekta).

Kada je FORMAT jednako pdf, vraća se jedan PDF dokument koji kombinuje strane objekata. Za sve ostale formate vraća se jedna strana.

mapX:EXTENT

Ovaj parametar zadaje obuhvat stavke karte u prikazu kao xmin,ymin,xmax,ymax.

mapX:ROTATION

Ovaj parametar zadaje rotaciju karte u stepenima.

mapX:GRID_INTERVAL_X

Ovaj parametar zadaje gustinu linija mreže u pravcu X.

mapX:GRID_INTERVAL_Y

Ovaj parametar zadaje gustinu linija mreže u pravcu Y.

mapX:SCALE

Ovaj parametar zadaje razmeru karte za stavku karte u prikazu. Ovo je korisno za obezbeđivanje vidljivosti slojeva i natpisa zasnovane na razmeri, čak i ako klijent i server imaju različite algoritme za računanje imenioca razmere.

mapX:LAYERS

Ovaj parametar zadaje slojeve za stavku karte u prikazu. Više informacija o ovom parametru potražite u GetMap slojevi.

mapX:STYLES

Ovaj parametar zadaje stilove slojeva definisane u određenoj stavci karte u prikazu. Više informacija o ovom parametru potražite u GetMap stilovi.

3.2.8. GetProjectSettings

Ovaj tip zahteva radi slično kao GetCapabilities, ali je specifičniji za QGIS Server i omogućava klijentu da pročita dodatne informacije koje nisu dostupne u izlazu GetCapabilities:

  • početna vidljivost slojeva

  • informacije o vektorskim atributima i njihovim tipovima uređivanja

  • informacije o redosledu slojeva i redosledu iscrtavanja

  • lista slojeva objavljenih u WFS-u

  • prikaz da li je grupa u stablu slojeva međusobno isključiva

Zahtev GetProjectSettings podržava sledeće parametre:

Parametar

Obavezno

Opis

MAP

Da

QGIS projektna datoteka

SERVICE

Da

Naziv servisa (WMS)

REQUEST

Da

Naziv zahteva (GetProjectSettings)

3.2.9. GetSchemaExtension

Zahtev GetSchemaExtension omogućava preuzimanje opcionih proširenih mogućnosti i operacija WMS servisa, kako ih implementira QGIS Server.

Parametar

Obavezno

Opis

MAP

Da

QGIS projektna datoteka

SERVICE

Da

Naziv servisa (WMS)

REQUEST

Da

Naziv zahteva (GetSchemaExtension)

Primer URL-a:

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

XML dokument izgleda ovako:

<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. Spoljni WMS slojevi

QGIS Server omogućava uključivanje slojeva sa spoljnih WMS servera u WMS GetMap i WMS GetPrint zahteve. Ovo je posebno korisno ako veb klijent koristi spoljni sloj podloge na veb karti. Iz razloga performansi, takve slojeve treba da zahteva direktno veb klijent (ne kaskadno preko QGIS servera). Za štampanje, međutim, ovi slojevi treba da budu kaskadni preko QGIS servera kako bi se pojavili na odštampanoj karti.

Spoljni slojevi mogu se dodati u parametar LAYERS kao EXTERNAL_WMS:<layername>. Parametri za spoljne WMS slojeve (npr. url, format, dpiMode, crs, layers, styles) kasnije se mogu zadati kao servisni parametri <layername>:<parameter>. U GetMap zahtevu, to bi moglo izgledati ovako:

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

Slično, spoljni slojevi mogu se koristiti u GetPrint zahtevima:

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. Obeležavanje (redlining)

Ova mogućnost je dostupna i može se koristiti sa GetMap i GetPrint zahtevima.

Mogućnost obeležavanja može se koristiti za prosleđivanje geometrija i natpisa u zahtevu, koje server preklapa preko standardno vraćene slike (karte). Time se korisniku omogućava da istakne ili možda doda neke komentare (natpise) na neke oblasti, lokacije itd. koje nisu na standardnoj karti.

Zahtev GetMap je u formatu:

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

Ekvivalent GetPrint je u formatu (imajte u vidu da se parametar mapX: dodaje da bi se naznačilo koja karta ima obeležavanje):

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

Evo slike koju daje gornji zahtev, na kojoj su poligon i natpis nacrtani preko normalne karte:

../../../_images/server_redlining.png

Сл. 3.23 Odgovor servera na GetMap zahtev sa parametrima obeležavanja

Vidite da u ovom zahtevu postoji nekoliko parametara za kontrolu mogućnosti obeležavanja. Puna lista uključuje:

  • HIGHLIGHT_GEOM: Možete dodati POINT, MULTILINESTRING, POLYGON itd. Podržava višedelne geometrije. Evo primera: HIGHLIGHT_GEOM=MULTILINESTRING((0 0, 0 1, 1 1)). Koordinate treba da budu u CRS-u GetMap/GetPrint zahteva.

  • HIGHLIGHT_LABELBUFFERCOLOR: Ovaj parametar kontroliše boju bafera natpisa.

  • HIGHLIGHT_LABELBUFFERSIZE: Ovaj parametar kontroliše veličinu bafera natpisa.

  • HIGHLIGHT_LABELCOLOR: Ovaj parametar kontroliše boju natpisa.

  • HIGHLIGHT_LABEL_DISTANCE: kontroliše rastojanje između objekta (npr. tačke ili linije) i natpisa u mm

  • HIGHLIGHT_LABELFONT: Ovaj parametar kontroliše font natpisa (npr. Arial)

  • HIGHLIGHT_LABEL_HORIZONTAL_ALIGNMENT: postavlja natpis horizontalno na tačku pomoću zadatog poravnanja (npr. ’left’, ’center’, ’right’)

  • HIGHLIGHT_LABEL_ROTATION: kontroliše rotaciju natpisa u stepenima

  • HIGHLIGHT_LABELSIZE: Ovaj parametar kontroliše veličinu natpisa.

  • HIGHLIGHT_LABELSTRING: Ovom parametru možete proslediti tekst natpisa.

  • HIGHLIGHT_LABEL_VERTICAL_ALIGNMENT: postavlja natpis vertikalno na tačku pomoću zadatog poravnanja (npr. ’top’, ’half’, ’bottom’)

  • HIGHLIGHT_SYMBOL: Ovo kontroliše kako je geometrija ocrtana i možete promeniti širinu, boju i neprozirnost poteza.