Tekninen kuvaus Karttakuvapalvelu (WMTS)

Palvelu perustuu WMTS 1.0.0 standardiin (Web Map Tile Service). Palvelussa ovat tuettuina sekä KVP- että REST-koodaukset ja GetCapabilities ja GetTile operaatiot (sekä KVP että REST-koodauksen mukaisena), mutta GetFeatureInfo ei ole tuettuna.

Karttakuvapalveluun kytkeydyttäessä käytetään WMTS-asiakassovelluksessa seuraavia palvelun metatietokuvauksen mukaisia osoitteita: https://karttakuva.maanmittauslaitos.fi/maasto/wmts/1.0.0/WMTSCapabilities.xml (maastokartat), https://karttakuva.maanmittauslaitos.fi/kiinteisto/wmts/1.0.0/WMTSCapabilities.xml (kiinteistörajat) ja https://karttakuva.maanmittauslaitos.fi/teema/wmts/1.0.0/WMTSCapabilities.xml (teemakartat). Metatietokuvauksesta selviää mm. ne palveluosoitteet, joita käytetään kytkemään asiakassovellus rajapintaan. Kytkeytyvän sovelluksen tulee hakea nämä kuvaukset ajantasaisena itse palvelusta. Tarvittavat tunnukset saat verkkopalveluiden asiakastuesta. 

Suorituskyky

Suorituskyvyn parantamiseksi suosittelemme, että haettuja karttakuvia puskuroidaan asiakkaiden välitys/sovelluspalvelimissa. Tässä voi hyödyntää jokaisen vastauksen yhteydessä palvelun palauttamia
HTTP-otsikkokenttiä (Expires, Cache-Control):

Expires: Tue, 01 Oct 2013 09:04:26 GMT
Cache-Control: public, max-age=604800

Tyypillisesti puskurointia tukevat välityspalvelimet osaavat hyödyntää näitä tietoja suoraan. Vaihtoehtoisesti karttakuvia voi puskuroida viikon ajan.

Edelleen suosittelemme Expires ja Cache-Control -otsikkokenttien välittämistä www-sovelluksissa palvelun loppukäyttäjien selaimille sellaisenaan, jolloin myös nämä osaavat tallentaa karttakuvia välimuistiin.

Palvelun suorituskyky riippuu myös käytettävästä aineistosta ja mittakaavatasosta. Esimerkiksi Maastokartta- ja Taustakartta-tuotteiden osalta vasteajat ovat parhaimmillaan mittakaavatasoilla 0 - 13. Jos palvelua käyttävässä sovelluksessa on tarve päästä samaan vasteaikaan myös tarkimmilla tasoilla 14-15 niin tällöin kannattaa harkita tason 13 karttatiilien käyttöä (uudelleennäytteistettynä) näilläkin tasoilla mikäli käytettävä asiakasohjelmisto tämän mahdollistaa.

maasto-alipalvelu:

Aineistotunniste Nimi Formaatti Tuetut JHS-tasot Lisätiedot
maastokartta Maastokartta PNG8

ETRS-TM35FIN: tasot 0-15

ETRS-GK 19-31: tasot 0-15

WGS84 Pseudo-Mercator: tasot 0-18

 
taustakartta Taustakartta PNG8

ETRS-TM35FIN: tasot 0-15

ETRS-GK 19-31: tasot 0-15

WGS84 Pseudo-Mercator: tasot 0-18

 
selkokartta Selkokartta PNG8 ETRS-TM35FIN: tasot 0-15  
ortokuva Ortokuva JPEG ETRS-TM35FIN: tasot 1-15  
ortokuva_vaaravari Ortokuva (vääräväri) JPEG ETRS-TM35FIN: tasot 9-15  
korkeusmalli_vinovalo Korkeusmalli vinovalovarjoste PNG8 ETRS-TM35FIN: tasot 0-15  
korkeusmalli_korkeusvyohyke Korkeusmalli korkeusvyohyke PNG8 ETRS-TM35FIN: tasot 0-15  

 

Maastokartta on yhdistelmäaineisto, joka koostuu perus-, maasto- tai yleiskartta-aineistoista. Taustakartta on yhdistelmäaineisto, joka koostuu taustakarttasarjan aineistoista. Selkokartta on yhdistelmätaso, joka koostuu selkokarttasarjan aineistoista. Yhdistelmäaineistojen alkuperäisaineisto on valittu JHS-tasolle sopivan mittakaavan mittakaavan perusteella. Ortokuva koostuu eri-ikäisistä (alueellisesti tuoreimmista) väri- ja mustavalko-ortokuvista, tasoilla 1-9 ortokuvamosaiikista.

Korkeusmalli vinovalovarjoste on laskettu korkeusmalli 2 m ja 10 m aineistoista. Korkeusmalli 2 m -aineisto ei kata koko maata, joten sitä aineistoa käyttävät vinovalovarjosteen tasot 11-15 eivät ole koko maan kattavia. Muut tasot on laskettu Korkeusmalli 10 m -aineistosta ja ne kattavat koko maan. Korkeusvyohykeaineisto on laskettu korkeusmalli 10 m aineistosta ja se kattaa koko maan.
 

kiinteisto-alipalvelu:

Aineistotunniste Nimi Formaatti Tuetut JHS-tasot Lisätiedot
kiinteistojaotus Kiinteistöjaotus PNG8 ETRS-TM35FIN: JHS-tasot 11 - 15 Läpinäkyvä PNG
kiinteistotunnukset Kiinteistötunnukset PNG8 ETRS-TM35FIN: JHS-tasot 11 - 15 Läpinäkyvä PNG
 

teema-alipalvelu:

Aineistotunniste Nimi Formaatti Tuetut JHS-tasot Lisätiedot
kuntarajat Kuntarajat PNG8 ETRS-TM35FIN: JHS-tasot 0 - 15 Läpinäkyvä PNG
kuntatunnukset Kuntatunnukset PNG8 ETRS-TM35FIN: JHS-tasot 0 - 15 Läpinäkyvä PNG
paikannimet Peruskarttarasterin paikannimet PNG8 ETRS-TM35FIN: JHS-tasot 10 - 15 Läpinäkyvä PNG
hallinnolliset_yksikot Peruskarttarasterin hallinnolliset yksikot PNG8 ETRS-TM35FIN: JHS-tasot 10 - 15 Läpinäkyvä PNG
liikenneverkot Peruskarttarasterin liikenneverkot PNG8 ETRS-TM35FIN: JHS-tasot 10 - 15 Läpinäkyvä PNG
hydrografia Peruskarttarasterin hydrografia PNG8 ETRS-TM35FIN: JHS-tasot 10 - 15 Läpinäkyvä PNG
korkeus Peruskarttarasterin korkeus PNG8 ETRS-TM35FIN: JHS-tasot 10 - 15 Läpinäkyvä PNG
maanpeite Peruskarttarasterin maanpeite PNG8 ETRS-TM35FIN: JHS-tasot 10 - 15 Läpinäkyvä PNG
maankaytto Peruskarttarasterin maankaytto PNG8 ETRS-TM35FIN: JHS-tasot 10 - 15 Läpinäkyvä PNG
rakennukset Peruskarttarasterin rakennukset PNG8 ETRS-TM35FIN: JHS-tasot 10 - 15 Läpinäkyvä PNG
osoitteet Osoitteet - Maastotietokannan tienimet ja Vaestotietojarjestelman rakennusten osoitenumerot PNG8 ETRS-TM35FIN: JHS-tasot 10 - 15 Läpinäkyvä PNG
TM35_lehtijako TM35 lehtijako PNG8 ETRS-TM35FIN: JHS-tasot 0 - 15 Läpinäkyvä PNG

Sivulla on ladattavissa demosovellus Karttakuvapalvelu (WMTS):n käytöstä, GetCapabilities-hakuja ja muutamia karttakuvahakuesimerkkejä rajapintaan.

Demosovellus

Demosovellus ja esimerkki Maanmittauslaitoksen Karttakuvapalvelu (WMTS):n käytöstä on ladattavissa tästä linkistä. Pura pakatun kansion sisältö: kartta.html-tiedoston kanssa samassa kansiossa tulee olla proj4js-kirjasto. Kopio siitä tulee pakatussa kansiossa, alkuperäinen löytyy osoitteesta http://trac.osgeo.org/proj4js/. Demosovelluksen hyödyntäjän tulee varmistaa Proj4js kirjaston lisenssin soveltuvuus hyödyntäjän käyttötarkoitukseen.

GetCapabilities-hakuja rajapintaan

GetCapabilities-hakuja voi tehdä kahdella tavalla (KVP ja REST). Haut molemmilla tavoilla sekä maasto-, kiinteistö että teemarastereille:

https://karttakuva.maanmittauslaitos.fi/maasto/wmts?service=WMTS&request=GetCapabilities&version=1.0.0

https://karttakuva.maanmittauslaitos.fi/maasto/wmts/1.0.0/WMTSCapabilities.xml

https://karttakuva.maanmittauslaitos.fi/kiinteisto/wmts?service=WMTS&request=GetCapabilities&version=1.0.0

https://karttakuva.maanmittauslaitos.fi/kiinteisto/wmts/1.0.0/WMTSCapabilities.xml

https://karttakuva.maanmittauslaitos.fi/teema/wmts?service=WMTS&request=GetCapabilities&version=1.0.0

https://karttakuva.maanmittauslaitos.fi/teema/wmts/1.0.0/WMTSCapabilities.xml

Karttakuvahakuesimerkit rajapintaan

Kustakin esimerkistä on lueteltu pyynnön url sekä REST- että KVP-muodoissa ja vastauskuva (PNG8 tai JPEG-kuva). Pyyntöjen vastaukset on tallennettu tämän esimerkkisivun yhteyteen staattisina kopioina eli niitä ei haeta dynaamisesti rajapinnasta.

Maastokartta JHS-taso 0

https://karttakuva.maanmittauslaitos.fi/maasto/wmts/1.0.0/maastokartta/default/ETRS-TM35FIN/0/0/0.png

 

https://karttakuva.maanmittauslaitos.fi/maasto/wmts?service=WMTS&request=GetTile&version=1.0.0&layer=maastokartta&style=default&format=image/png&TileMatrixSet=ETRS-TM35FIN&TileMatrix=0&TileRow=0&TileCol=0

Maastokartta JHS-taso 0

 

 

 

 

 

 

 

 

 

Maastokartta JHS-taso 6

https://karttakuva.maanmittauslaitos.fi/maasto/wmts/1.0.0/maastokartta/default/ETRS-TM35FIN/6/44/27.png

https://karttakuva.maanmittauslaitos.fi/maasto/wmts?service=WMTS&request=GetTile&version=1.0.0&layer=maastokartta&style=default&format=image/png&TileMatrixSet=ETRS-TM35FIN&TileMatrix=6&TileRow=44&TileCol=27

Maastokartta JHS-taso 6

 

 

 

 

 

 

 

 

 

Maastokartta JHS-taso 9

https://karttakuva.maanmittauslaitos.fi/maasto/wmts/1.0.0/maastokartta/default/ETRS-TM35FIN/9/353/219.png

https://karttakuva.maanmittauslaitos.fi/maasto/wmts?service=WMTS&request=GetTile&version=1.0.0&layer=maastokartta&style=default&format=image/png&TileMatrixSet=ETRS-TM35FIN&TileMatrix=9&TileRow=353&TileCol=219

Maastokartta JHS-taso 9

 

 

 

 

 

 

 

 

 

Maastokartta JHS-taso 12

https://karttakuva.maanmittauslaitos.fi/maasto/wmts/1.0.0/maastokartta/default/ETRS-TM35FIN/12/2830/1755.png

https://karttakuva.maanmittauslaitos.fi/maasto/wmts?service=WMTS&request=GetTile&version=1.0.0&layer=maastokartta&style=default&format=image/png&TileMatrixSet=ETRS-TM35FIN&TileMatrix=12&TileRow=2830&TileCol=1755

Maastokartta JHS-taso 9

 

 

 

 

 

 

 

 

 

Taustakartta JHS-taso 3

https://karttakuva.maanmittauslaitos.fi/maasto/wmts/1.0.0/taustakartta/default/ETRS-TM35FIN/3/5/3.png

https://karttakuva.maanmittauslaitos.fi/maasto/wmts?service=WMTS&request=GetTile&version=1.0.0&layer=taustakartta&style=default&format=image/png&TileMatrixSet=ETRS-TM35FIN&TileMatrix=3&TileRow=5&TileCol=3

kuva taustakartta jhs-taso 3

 

 

 

 

 

 

 

 

 

Taustakartta JHS-taso 11

https://karttakuva.maanmittauslaitos.fi/maasto/wmts/1.0.0/taustakartta/default/ETRS-TM35FIN/11/1415/877.png

https://karttakuva.maanmittauslaitos.fi/maasto/wmts?service=WMTS&request=GetTile&version=1.0.0&layer=taustakartta&style=default&format=image/png&TileMatrixSet=ETRS-TM35FIN&TileMatrix=11&TileRow=1415&TileCol=877

kuva taustakartta jhs-taso 11

 

 

 

 

 

 

 

 

 

Selkokartta JHS-taso 6

https://karttakuva.maanmittauslaitos.fi/maasto/wmts/1.0.0/selkokartta/default/ETRS-TM35FIN/6/44/27.png

https://karttakuva.maanmittauslaitos.fi/maasto/wmts?service=WMTS&request=GetTile&version=1.0.0&layer=selkokartta&style=default&format=image/png&TileMatrixSet=ETRS-TM35FIN&TileMatrix=6&TileRow=44&TileCol=27

Selkokartta jhs-taso 6

 

 

 

 

 

 

 

 

 

 

Ortokuva JHS-taso 13

https://karttakuva.maanmittauslaitos.fi/maasto/wmts/1.0.0/ortokuva/default/ETRS-TM35FIN/13/5661/3510.jpg

https://karttakuva.maanmittauslaitos.fi/maasto/wmts?service=WMTS&request=GetTile&version=1.0.0&layer=ortokuva&style=default&format=image/jpeg&TileMatrixSet=ETRS-TM35FIN&TileMatrix=13&TileRow=5661&TileCol=3510

Ortokuva JHS.taso 13

 

 

 

 

 

 

 

 

 

Ortokuva (vääräväri) JHS-taso 13

https://karttakuva.maanmittauslaitos.fi/maasto/wmts/1.0.0/ortokuva_vaaravari/default/ETRS-TM35FIN/13/5661/3510.jpg

https://karttakuva.maanmittauslaitos.fi/maasto/wmts?service=WMTS&request=GetTile&version=1.0.0&layer=ortokuva_vaaravari&style=default&format=image/jpeg&TileMatrixSet=ETRS-TM35FIN&TileMatrix=13&TileRow=5661&TileCol=3510

Ortokuva_vaaravari JHS-taso 13

 

 

 

 

 

 

 

 

 

Kiinteistöjaotus JHS-taso 13

https://karttakuva.maanmittauslaitos.fi/kiinteisto/wmts/1.0.0/kiinteistojaotus/default/ETRS-TM35FIN/13/5661/3510.png

https://karttakuva.maanmittauslaitos.fi/kiinteisto/wmts?service=WMTS&request=GetTile&version=1.0.0&layer=kiinteistojaotus&style=default&format=image/png&TileMatrixSet=ETRS-TM35FIN&TileMatrix=13&TileRow=5661&TileCol=3510

Kiinteistojaotus JHS-taso 13

 

 

 

 

 

 

 

 

 

 

Kiinteistötunnukset JHS-taso 13

https://karttakuva.maanmittauslaitos.fi/kiinteisto/wmts/1.0.0/kiinteistotunnukset/default/ETRS-TM35FIN/13/5661/3510.png

https://karttakuva.maanmittauslaitos.fi/kiinteisto/wmts?service=WMTS&request=GetTile&version=1.0.0&layer=kiinteistotunnukset&style=default&format=image/png&TileMatrixSet=ETRS-TM35FIN&TileMatrix=13&TileRow=5661&TileCol=3510

 Kiinteistotunnukset JHS-taso 13

 

 

 

 

 

 

 

 

 

Kuntarajat JHS-taso 5

https://karttakuva.maanmittauslaitos.fi/teema/wmts/1.0.0/kuntarajat/default/ETRS-TM35FIN/5/22/13.png

https://karttakuva.maanmittauslaitos.fi/teema/wmts?service=WMTS&request=GetTile&version=1.0.0&layer=kuntarajat&style=default&format=image/png&TileMatrixSet=ETRS-TM35FIN&TileMatrix=5&TileRow=22&TileCol=13

Kuntarajat JHS-taso 5

 

 

 

 

 

 

 

 

 

Kuntatunnukset JHS-taso 5

https://karttakuva.maanmittauslaitos.fi/teema/wmts/1.0.0/kuntatunnukset/default/ETRS-TM35FIN/5/22/13.png

https://karttakuva.maanmittauslaitos.fi/teema/wmts?service=WMTS&request=GetTile&version=1.0.0&layer=kuntatunnukset&style=default&format=image/png&TileMatrixSet=ETRS-TM35FIN&TileMatrix=5&TileRow=22&TileCol=13

Kuntatunnukset JHS-taso 5

 

 

 

 

 

 

 

 

 

Rakennukset JHS-taso 13

https://karttakuva.maanmittauslaitos.fi/teema/wmts/1.0.0/rakennukset/default/ETRS-TM35FIN/13/5661/3510.png

https://karttakuva.maanmittauslaitos.fi/teema/wmts?service=WMTS&request=GetTile&version=1.0.0&layer=rakennukset&style=default&format=image/png&TileMatrixSet=ETRS-TM35FIN&TileMatrix=13&TileRow=5661&TileCol=3510

Rakennukset JHS-taso 13

 

 

 

 

 

 

 

 

 

 

Korkeusmalli vinovalo JHS-taso 11

https://karttakuva.maanmittauslaitos.fi/maasto/wmts/1.0.0/korkeusmalli_vinovalo/default/ETRS-TM35FIN/11/1407/874.png

https://karttakuva.maanmittauslaitos.fi/maasto/wmts?service=WMTS&request=GetTile&version=1.0.0&layer=korkeusmalli_vinovalo&style=default&format=image/png&TileMatrixSet=ETRS-TM35FIN&TileMatrix=11&TileRow=1407&TileCol=874

Korkeusmalli_vinovalo JHS-taso 11

 

 

 

 

 

 

 

 

 

 

 

 

 

Tuotantoversio 2015-11 laajennos

Taustakartta- ja Maastokarttasarjan koordinaatistotukea Karttakuvapalvelu (WMTS):ssä laajennettu ETRS-GK19-31 -koordinaattijärjestelmiin ja WGS84 Pseudo-Mercator -karttaprojektioon 7.11.2017.

ETRS-GK19-31 -koordinaattijärjestelmän hilat eli tiilimatriisi, jonka mukaisesti karttakuvat tarjotaan WMTS-palvelussa, tullaan määrittelemään JHS-180 (Julkisen hallinnon suositus) päivityshankkeessa. Päivityshanke käynnistyy 11/2017 ja suunniteltu valmistusajankohta on 02/2019. Karttakuvapalvelu (WMTS):n koordnaatistotuki ETRS-GK19-31 -koordinaattijärjestelmille tarjotaan BETA-statuksella kunnes JHS-180 päivytshanke on valmistunut. BETA-vaiheen aikana palveluun voi tulla muutoksia.

WGS84 Pseudo-Mercator -karttaprojektion koordinaatistotuki tarjotaan BETA-statuksella 02/2018 asti. BETA-vaiheen aikana palveluun voi tulla muutoksia.

Tuotantoversio 2015-11 laajennos

Selkokartta uutena käyttöön tuotteena 11.10.2017.

Tuotantoversio 2015-11 täydennys

Taustakartta uusittiin (uusi kuvaustekniikka) 6.6.2017.

Tuotantoversio 2015-11 täydennys

Ortokuvatasot 1-6 otettiin käyttöön 13.6.2016.

Tuotantoversio 2015-11

Versio 2015-11 otettiin käyttöön 24.11.2015:

Palvelussa otettiin käyttöön uusia tuotteita

  • kuntarajat teema-alipalveluun
  • kuntatunnukset teema-alipalveluun
  • korkeusmalli_vinovalo maasto-alipalveluun
  • korkeusmalli_korkeusvyohyke maasto-alipalveluun

Tuotantoversio 2015-03 täydennys

Taustakartta tasoilla 13-15 tienimien kuvausta on muutettu 2015-04-10 siten, että tienimet piirretään kunnan kielisyyden mukaan.

Tuotantoversio 2015-03

Versio 2015-03 otettiin käyttöön 2015-03-03:

Kiinteistörajatuotteiden ulkoasuun parannusta

Kiinteistöjaotus- ja kiinteistötunnukset-tuotteiden kuvaustapa muuttui hieman. Kiinteistötunnusten terävyyttä parannettiin ja kiinteistörajan viivaa hieman paksunnettiin.

Palveluun tuli uusia teematuotteita:

Osoitteet (tienimet ja Väestörekisterikeskuksen Väestötietojärjestelmän rakennusten osoitenumerot)

TM35-karttalehtijako (JHS 154-suosituksen mukainen karttalehtijako, 1:200 000 - 1:5 000 lehtikoot kuvattuna)

Peruskartan osaelementit, joissa kuvaustekniikka on Peruskartan mukainen

  • Paikannimet (Peruskartalla näkyvät paikannimet)
  • Hallinnolliset yksiköt (kunnan, maakunnan, Aluehallintoviraston toimialueen ja valtakunnan rajat)
  • Liikenneverkot (tiet, rautatiet, vesikulkuväylät, lentokentät)
  • Hydrografia (meret, järvet, joet, lähteet, vaikeakulkuiset suot, maatuvat vesialueet, matalikot)
  • Korkeus (korkeuskäyrät, syvyyskäyrät, jyrkänteet)
  • Maanpeite (vedet, maatalousmaat, maa-aineksenottoalueet, puistot, suot, metsämaat, kalliot, kivikot, hietikot, lentokentät, autoliikennealueet)
  • Maankaytto (vedet, maatalousmaat, maa-aineksenottoalueet, hautausmaat, varastoalueet, puistot, kaatopaikat, lentokentät, autoliikennealueet)
  • Rakennukset (asuin-, liike-, lomarakennukset, teolliset, kirkolliset, julkiset rakennukset, muut rakennukset ja rakennelmat)

Vanhat teematuotteet poistetaan

Nämä uudet Karttakuvapalvelu (WMTS):n teematuotteet korvaavat tällä hetkellä Karttakuvapalvelu (WMS):ssä olevat teematuotteet (Nimet, Hallintorajat, Rakennukset, Liikenneverkko, Vesistöt, Pellot, Avoimet metsämaat, Kalliot ja hietikot, Korkeuskäyrät, Suot, Tienimet, Väestörekisterikeskuksen Väestötietojärjestelmän (VTJ) rakennusten osoitenumerot). Vanhat teematuotteet poistetaan myöhemmin keväällä.

Tuotantoversio 2014-12

Tuotantoversio 2014-12 otettiin käyttöön 2014-12-16:

  • Taustakartta-tuotteessa otettiin käyttöön uusi tuotantoprosessi: joidenkin jhs-tasojen lähtöaineisto muuttui
  • Tuotannossa otettiin käyttöön tehokkaammat palvelimet

Tuotantoversio 2014-10

Tuotantoversio 2014-10 otettiin käyttöön 2014-10-09:

  • Maastokartta-tuotteessa on otettu käyttöön uusi tuotantoprosessi: joidenkin jhs-tasojen lähtöaineisto on muuttunut
  • Ortokuva (vääräväri) (ortokuva_vaaravari) otettu käyttöön.

Tuotantoversio 2013-09

Tuotantokäyttö on aloitettu 24.9.2013.

Koekäyttöversio

Koekäyttöversio otettu käyttöön 19.06.2013.

Palvelu perustuu WMTS 1.0.0 standardiin (Web Map Tile Service). Palvelussa ovat tuettuina sekä KVP- että REST-koodaukset.

Karttakuvapalvelussa (WMTS) ovat mukana seuraavat aineistot:

  • taustakartta
  • maastokartta
  • ortokuva
  • kiinteistöjaotus
  • kiinteistötunnukset.