Collapse AllExpand All

GetMap

GetMap-kyselyllä haetaan karttakuva annettujen parametrien mukaisesti.

Kysely

Kysely suoritetaan HTTP GET -metodilla seuraavan esimerkin mukaisesti: 
http://palvelu.kunta.fi/WMS.ashx?REQUEST=GetMap&SERVICE=WMS&VERSION=1.1.1&LAYERS=Pohjakartta
&STYLES=&FORMAT=image/png&BGCOLOR=0xFFFFFF&TRANSPARENT=TRUE&SRS=EPSG:4326
&BBOX=22.2417654438629,60.4332136082583,22.2501766100941,60.4410854939752
&WIDTH=1045&HEIGHT=978
Käytettäessä asiakasohjelmaa kysely luodaan yleensä suoraan asiakasohjelman toiminnoilla.
Kyselyssä käytetään seuraavia parametrejä:
  • VERSION: WMS-versio. Palvelu tukee versiota 1.1.1.
  • REQUEST: Kyselytyyppi. GetMap-kyselyssä aina GetMap.
  • SERVICE: Palvelu. Trimble Locus WMS -palvelussa aina wms.
  • LAYERS: Tasot, jotka halutaan mukaan haettavaan karttakuvaan. Anna tasot listana pilkulla erotettuina.
  • SRS: Koordinaattijärjestelmä, jossa BBOX-parametrilla osoitettava koordinaattirajaus on annettu.
  • BBOX: Haettavan karttakuvan koordinaattirajaus SRS-parametrilla määritetyssä koordinaattijärjestelmässä.
  • WIDTH: Haettavan karttakuvan leveys pikseleinä.
  • HEIGHT: Haettavan karttakuvan korkeus pikseleinä.
  • FORMAT: Haettavan karttakuvan tiedostomuoto. Trimble Locus WMS-palvelussa aina image/png.
  • TRANSPARENT: Haettavan karttakuvan läpinäkyvyys. Kun arvo on true, karttakuva on läpinäkyvä, ja kun arvo on false, karttakuva ei ole läpinäkyvä. Oletusarvoisesti false.
  • BGCOLOR: Haettavan karttakuvan taustaväri heksadesimaalilukuna. Oletusarvoisesti 0xFFFFFF.
  • EXCEPTIONS: Virheviestin esitysmuoto. Oletusarvoisesti 'XML' / application/vnd.ogc.se_xml.
Parametrien nimet voidaan kirjoittaa suurilla tai pienillä kirjaimilla, mutta parametrien arvoissa suurilla ja pienillä kirjaimilla on merkitysero. Parametrien järjestyksellä kyselyviestissä ei ole merkitystä.
Jos parametrin arvo sisältää välilyönnin tai pilkun, tulee se korvata yleisten URL-koodaussääntöjen mukaisesti (välilyönti %20, pilkku %2C).

Vastaus

GetMap-kyselyn vastauksena palvelu palauttaa kuvatiedoston, joka sisältää kyselyn parametrejä vastaavan karttapalan.