Inspire-verkkopalvelut Inspire-sihteeristön verkkokoulutus Teemu Saloriutta 8.3.2016
Esityksen sisältö Mitä ovat verkkopalvelut Mitä vaatimuksia Inspire-direktiivi asettaa verkkopalveluille Miten toteutan katselupalvelurajapinnan (WMS, WMTS) Miten toteutan latauspalvelurajapinnan (WFS, Atom)
Miksi? Komissio kiristää INSPIRE-toimeenpanon seurantaa 23.11.2017
1. Mitä ovat verkkopalvelut?
Mitä ovat verkkopalvelut? Paikkatietojen esittämiseen, käsittelyyn ja muuntamiseen tarkoitettuja, verkkosivuilla olevia palveluita Verkkopalvelut perustuvat rajapintoihin Inspire-direktiivin mukaisia verkkopalveluita ovat: Hakupalvelu Katselupalvelu Latauspalvelu Muunnospalvelu Käynnistyspalvelu
Mitä ovat verkkopalvelut? Paikkatietojen esittämiseen, käsittelyyn ja muuntamiseen tarkoitettuja, verkkosivuilla olevia palveluita Verkkopalvelut perustuvat rajapintoihin Inspire-direktiivin mukaisia verkkopalveluita ovat: Hakupalvelu Katselupalvelu Latauspalvelu Tiedontuottajan vastuulla Muunnospalvelu Käynnistyspalvelu
Rajapintapalvelun toteutusvaihtoehdot Itse tekemällä Rajapintapalvelut suoraan organisaation omaan paikkatietojärjestelmään Mahdollisesti oma järjestelmä tietopalvelua varten Toteutus tilattuna, ylläpito itse Palvelinohjelmistot asennettuna ja rajapinnat toteutettuina, ylläpitovastuu organisaatiolla itsellään Toteutus ja ylläpito tilattuna Avaimet käteen -toteutus, tyypillisesti toimittajan pilvipalveluna sisältäen SLA-sopimuksen
Katselupalvelut Inspiredirektiivissä Katselupalvelu (view service) mahdollistaa vähintään paikkatietoaineistojen tarkastelun, liikkumisen aineistossa, katselumittakaavan muuttamisen, kartan vierityksen tai paikkatietojen esittämisen päällekkäin Käytännössä katselupalvelu on Web Map Service (WMS) tai Web Map Tile Service (WMTS) -rajapinta Paikkatietoaineistojen tuottajat asettavat aineistot karttakuvamuodossa saataville katselupalveluun
WMS ja WMTS WMS Web Map Service Katselupalvelu mahdollistaa paikkatietojen esittämisen asiakassovelluksessa päällekkäin sekä muut perustoiminnot http://www.opengeospatial.org/standards/wms WMTS Web Map Tile Service WMTS-katselupalvelu tarjoaa valmiiksi tuotettuja rasterimuotoisia kuvia mahdollistaen samat toiminnot kuin WMS-palvelu http://www.opengeospatial.org/standards/wmts
Latauspalvelut Inspiredirektiivissä Latauspalvelu (download service) on palvelu, joka mahdollistaa paikkatietoaineistojen ja niiden osien kopioinnin omalle tietokoneelle Paikkatietoja voi olla myös mahdollista hakea reaaliaikaisesti standardimuotoisten kyselyjen avulla Toteutus WFS- tai Atom-pohjaisesti Näistä lisää myöhemmin
2. Mitä vaatimuksia INSPIRE asettaa verkkopalveluille
Mitä kuuluu velvoitteisiin - Palvelutaso Katselu- ja latauspalveluille on määritelty Inspireverkkopalvelujen täytäntöönpanoasetuksessa palvelutasovaatimuksia Palvelutasovaatimusten käytännön soveltamista on tulkittu teknisiin ohjeisiin ja JHS 180 -suosituksen palvelutasoliitteeseen (liite 4) Inspire-direktiivin vaatimusten täyttämättä jättämisestä voi seurata selvityspyyntöjä ja sanktioita Komissiolta, mikäli joku taho tekee asiasta valituksen
Mitä kuuluu velvoitteisiin - palvelutaso Normaalissa tilanteessa GetMap-pyynnön on palautettava 470 kilotavun kokoinen kuva 5 sekunnissa. Normaalilla tilanteella tarkoitetaan aikaa huippukuormituksen ulkopuolella, jonka oletetaan olevan 90 % ajasta. Palvelun on pystyttävä pitämään yllä vaadittu palvelutaso 20 yhtäaikaiselle käyttäjälle. Palvelun on oltava käytettävissä 99 % ajasta (~ei käytettävissä enintään 3,63 vuorokautta vuodessa).
Mitä kuuluu velvoitteisiin - Käytön seuranta Komissio kerää seurantatietoja palvelujen käytöstä vuositasolla MML:n Inspire-sihteeristö hoitaa tietojen keräämisen viranomaisilta ja raportoinnin Komissiolle MMM:n toimeksiannosta Rajapintapalvelusta vastaava viranomainen vastaa palvelupyyntömäärien seurannasta tai seurannan järjestämisestä ja raportoi luvut Inspire-sihteeristölle
Mitä kannattaa muistaa - Pääsynhallinta Rajapinta voi olla täysin avoin - entä aineisto? Osa rajapinnalla olevista aineistoista voi olla saatavilla vain tietylle rooleille tai käyttäjäjoukolle Rajapintoja voi olla useita, ja niillä voi olla erilaisia käyttöoikeuksia Rajapintapalvelulla on aina myös pääkäyttäjä, joka pääsee hallinnoimaan palvelua Aineistojen ylläpito Palvelun asetusten muokkaaminen Käyttäjäoikeuksien hallinnointi
Mitä kannattaa muistaa - Aineiston päivitys Aineisto on pidettävä ajan tasalla Sopiva ajantasaistussykli riippuu aineistosta Päivitysprosessi kannattaa määritellä ja dokumentoida Tarvitaanko aineistolle skeema- tai koordinaattimuunnoksia, kun se viedään rajapinnalle? Päivitetäänkö aineisto itse palveluun vai sovitaanko päivitysrytmi palvelun toimittajan kanssa?
Mitä kannattaa muistaa - Koordinaatistot Inspire vaatii, että katselupalvelu tarjoaa aineistoja ETRS89 lat/lon koordinaattijärjestelmässä (EPSG 4258) Kansallisen yhteentoimivuuden kannalta on suositeltavaa, että tarjotaan myös ETRS-TM35FIN (EPSG 3067) - koordinaattijärjestelmää Latauspalveluissa mahdollisuus valinta seuraavista: ETRS89 lat/lon, ETRS-LCC, ETRS-LAEA, ETRS-TMxx kaistat Vaatimukset voivat riippua tietotuotteesta Useat WMS- ja WFS-palvelimet mahdollistavat aineistojen tarjoamisen helposti useammassa kuin yhdessä koordinaattijärjestelmässä, esim. ETRS89-GK-kaistat
3. Miten toteutan katselupalvelun?
Datasta verkkopalveluksi WMS/ WMTS Esim. GeoServer, MapServer, Deegree Palvelinohjelmisto Uusi Tietokanta
Katselupalvelun toteutus INSPIREssä muutamia lisäyksiä ja täsmennyksiä standardiin WMS/WMTS-rajapintaan A) Skeemalaajennokset B) Kielituki C) Karttatasojen nimeäminen ja ryhmittely D) Viittaukset metatietoihin E) Tuettavat koordinaattijärjestelmät F) Muut tekniset vaatimukset G) Palvelun tietosisältö
A) Skeemalaajennokset GetCapabilities-dokumentin alussa määriteltävä INSPIRE-nimiavaruus ja skeemojen sijainti Ajantasaiset skeemat http://inspire.ec.europa.eu/schemas/ <WMS_Capabilities version="1.3.0" xmlns="http://www.opengis.net/wms" xmlns:inspire_common="http://inspire.ec.europa.eu/schemas/common/1.0" xmlns:inspire_vs="http://inspire.ec.europa.eu/schemas/inspire_vs/1.0" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="http://inspire.ec.europa.eu/schemas/inspire_vs/1.0 http://inspire.ec.europa.eu/schemas/inspire_vs/1.0/inspire_vs.xsd">... </WMS_Capabilities>
B) Kielituki WMS-rajapinnan tulee ymmärtää GetCapabilities-kyselyyn liitettävä LANGUAGE-parametri Vaikka GetCapabilities-kysely lähetettäisiin ilman LANGUAGE-parametria, vastauksessa oltava tieto tuetuista kielistä GetCapabilities-vastausviesti kertoo operaatiokohtaiset tekniset osoitteet joko pyydetyllä kielellä tai palvelun oletuskielellä
B) Kielituki: esimerkki <inspire_vs:extendedcapabilities> <inspire_common:supportedlanguages xsi:type="inspire_common:supportedlanguagestype"> Tähän väliin tuetut kielet </inspire_common:supportedlanguages> </inspire_vs:extendedcapabilities>
B) Kielituki: esimerkki <inspire_common:supportedlanguages xsi:type="inspire_common:supportedlanguagestype"> <inspire_common:defaultlanguage> <inspire_common:language>fin</inspire_common:language> </inspire_common:defaultlanguage> Oletuskieli <inspire_common:supportedlanguage> <inspire_common:language>eng</inspire_common:language> </inspire_common:supportedlanguage> Muut tuetut kielet <inspire_common:supportedlanguage> <inspire_common:language>swe</inspire_common:language> </inspire_common:supportedlanguage> </inspire_common:supportedlanguages>
B) Kielituki: esimerkki <inspire_vs:extendedcapabilities> <inspire_common:supportedlanguages xsi:type="inspire_common:supportedlanguagestype"> <inspire_common:defaultlanguage> <inspire_common:language>fin</inspire_common:language> </inspire_common:defaultlanguage> <inspire_common:supportedlanguage> <inspire_common:language>eng</inspire_common:language> </inspire_common:supportedlanguage> </inspire_common:supportedlanguages> Nykyinen valittu kieli <inspire_common:responselanguage> <inspire_common:language>fin</inspire_common:language> </inspire_common:responselanguage> </inspire_vs:extendedcapabilities>
C) Karttatasojen nimeäminen ja ryhmittely WMS-palvelussa karttatasojen nimien tulee olla Euroopan komission asetuksen 1089/2010 (Paikkatietoaineistojen- ja palvelujen yhteentoimivuus) mukaisia silloin, kun tietosisältö on tietotuotemäärittelyn mukainen Esimerkki: Suojellut alueet Tekninen tunniste (name): PS.ProtectedSite Yleiskielinen otsikko (title): Suojelukohteet Riippuu valitusta kielestä
C) Esimerkki: Ryhmittely Karttatasot voi ryhmitellä myös hierarkkisesti ryhmätasojen alle Ryhmätaso (group layer) HY.PhysicalWaters.Waterbodies HY.PhysicalWaters.Waterbodies.StandingWater HY.PhysicalWaters.Waterbodies.Watercourse
D) Viittaukset metatietoihin Katselupalvelussa voidaan viitata palvelujen ja aineistojen metatietoihin, kun halutaan hyödyntää Paikkatietohakemistoa Ei tarvitse pitää metatietoja kahdessa paikassa Viittaus Paikkatietohakemistoon sijoitetaan kahteen paikkaan rajapintapalvelun GetCapabilities-vastauksessa Lisäksi jokaisen karttatason osalta GetCapabilitiesvastausviestissä tulee olla kohdassa WMS-standardin mukaiset metatietoelementit.
D) Viittaukset metatietoihin GetCapabilities-vastausviestiin tulee viittaus itse katselupalvelun metatietoihin <inspire_vs:extendedcapabilities> -elementin sisälle: <inspire_common:metadataurl> <inspire_common:url> http://www.paikkatietohakemisto.fi/geonetwork/srv/fi/csw?service=csw &Request=GetRecordById&Version=2.0.2&id=[TIEDOSTOTUNNISTE] &outputschema=http://www.isotc211.org/2005/gmd&elementsetname =full </inspire_common:url> <inspire_common:mediatype>application/vnd.iso.19139+xml</ inspire_common:mediatype> </inspire_common:metadataurl>
D) Viittaukset metatietoihin Lisäksi karttatasokohtainen viittaus aineiston metatietoihin <Layer>elementin alle, XML: <MetadataURL type="iso19115:2005"> <Format>text/xml</Format> <OnlineResource xlink:href="http://www.paikkatietohakemisto.fi/geonetwork/srv/fi/csw?r equest=getrecordbyid&service=csw&id=[tiedostotunniste]&el ementsetname=full&outputschema=http://www.isotc211.org/2005/gmd " xlink:type="simple" xmlns:xlink="http://www.w3.org/1999/xlink" /> </MetadataURL> Koneluettava XML-tiedosto
D) Viittaukset metatietoihin Lisäksi karttatasokohtainen viittaus aineiston metatietoihin <Layer>elementin alle, HTML: <MetadataURL type="iso19115:2005"> <Format>text/html</Format> <OnlineResource xlink:href="http://www.paikkatietohakemisto.fi/geonetwork/srv/fi/metad ata.show.portti?uuid=[tiedostotunniste] xlink:type="simple" xmlns:xlink="http://www.w3.org/1999/xlink" /> </MetadataURL> Ihmisille sopiva HTML-tiedosto
D) Metatietoelementit Metatietoviittauksen lisäksi GetCapabilities-vastausviestissä tulee olla jokaisen karttatason osalta seuraavat WMS-standardin mukaiset metatietoelementit: Metatietoelementti Resurssin otsikko Resurssin tiivistelmä Avainsana Kattavuus Yksilöivä tunniste Tekninen tunniste ISO 19128 (WMS 1.3.0) -elementti (wms:layer alielementti) wms:title wms:abstract wms:keywordlist / wms:keyword wms:boundingbox wms:identifier + wms:authorityurl wms:name Koordinaattijärjestelmät wms:crs Tyylit Selite Projisointitasot wms:style wms:legendurl wms:dimension [@name, @units]
E) Tuettavat Koordinaattijärjestelmät Palvelun on tuettava ETRS89-maantieteellistä koordinaattijärjestelmää EPSG:4258. On suositeltavaa, että palvelu tukee myös kansallista ETRS89-TM35FIN (EPSG:3067) -järjestelmää Kunkin karttatason kattavuuden ilmaiseva suorakaide (BBOX) on ilmoitettava jokaisen tuetun koordinaattijärjestelmän osalta
F) Muut tekniset vaatimukset Rajapinnan on tuettava PNG- tai GIF-kuvamuotoa Myös JPEG-formaatin tukeminen on perusteltua esimerkiksi sävykuvamuotoisten aineistojen osalta
G) Palvelun tietosisältö 9.5.2011 lähtien katselupalvelun on tullut sisältää kansalliset aineistot sellaisina kuin ne ovat Liitteen I aineistojen tulee pääsääntöisesti olla katselupalvelussa tietotuotemäärittelyn mukaisina 15.12.2017 mennessä Liitteen II ja II aineistot 15.12.2019 mennessä Myös kuvaustyylin ja sitä vastaavan karttamerkkien selitteen tulee olla saatavina määriteltyihin aikarajoihin mennessä tietotuotemäärittelyn mukaisina.
4. Miten toteutan latauspalvelun?
Inspire-latauspalvelun toteutusvaihtoehdot Latauspalvelun toteutuksessa on kolme vaihtoehtoa: 1. Tiedostojen lataus Atom-syötteen kautta 2. Vain vakioidut kyselyt mahdollistava WFS 2.0 -rajapinta 3. Vapaat kyselyt mahdollistava WFS 2.0 -rajapinta Kaikki nämä täyttävät INSPIREn pakolliset velvoitteet (Verkkopalveluasetuksen osa A) Osien B ja C mukaiset lisäominaisuudet ei mahdollisia Atomsyötteen avulla WFS-rajapintojen toiminnallisuus kuvattu JHS 180 -suosituksen liitteessä 2 (Paikkatiedon kyselypalvelu) Atom-syötteen toiminnallisuus kuvattu JHS 180 -suosituksen liitteessä 3 (Paikkatiedon tiedostopalvelu)
Atom Atom on XML-pohjainen dokumenttiformaatti Perustuu IETF:n (Internet Engineering Task Force) standardiin RFC 4287 Verrattavissa yleisempään RSS-syötteeseen Syötteellä on URL-osoite, josta se on tilattavissa Syöte koostuu yhdestä tai useammasta entry-elementistä Keskeisin osa syötettä tiedostopalvelun kannalta on linkki ladattavaan tietotuotteeseen ATOM-syöte ei ole rajapinta, mutta sen katsotaan täyttävän latauspalveluasetuksen Osan A vaatimukset
Tuettavat toiminnot
Esimerkki: Lounaispaikka http://paikkatietokeskus.lounaispaikka.fi/cms/files/maakunta kaavat_atom/louspire_atom.xml Mahdollisuus ladata maakuntakaavoja
Atom-syötteen rakenne
Atom-syötteen rakenne
Tiedostopalvelusyöte
Linkki tuotesyötteeseen Linkki metatietoihin Ulottuvuus (BBOX)
Atom-syötteen rakenne
Tuotesyöte
WFS-rajapinnan toiminta Paikkatietojen hakeminen WFS-rajapinnasta: Asiakassovellus kysyy rajapintapalvelun metatietoja (GetCapabilities). Asiakassovellus kysyy valitsemansa kohdeluokan tietomallin (DescribeFeatureType). Saamiensa tietojen perusteella asiakassovellus muodostaa paikkatietokyselyn ja lähettää sen rajapintapalveluun (GetFeature). Rajapintapalvelu prosessoi kyselyn ja palauttaa vastauksen (GMLmuotoinen data) tai virheviestin
Datasta WFS-palveluksi WFS Esim. GeoServer, MapServer, Deegree Palvelinohjelmisto Tietokanta Mahdollinen muunnos Uusi Tietokanta
Datasta WFS-palveluksi WFS Esim. GeoServer, MapServer, Deegree Palvelinohjelmisto Mahdollinen muunnos Tietokanta
WFS 2.0 -standardi Palvelun on tuettava WFS 2.0:n Simple WFS -luokkaa: GetCapabilities DescribeFeatureType GetFeature-operaatio StoredQuery-toiminnoilla (vakioitu kysely) ListStoredQueries DescribeStoredQueries Basic WFS -luokka täyttää Simple WFS -vaatimukset ja tukee lisäksi: GetPropertyValue GetFeature-operaatio Query-toiminnolla (vapaa kysely) Suositellaan tuettavan: kohdeluokkien rajaus (typenames), vapaaehtoisten ominaisuuksien valinta (PropertyName), aluerajaus suorakaiteena (Filter/BBOX/Envelope)
Kielet ja tuettavat koordinaattijärjestelmät Kielivaatimukset kuten katselupalveluilla Koordinaattijärjestelmistä tuettava seuraavia: ETRS89 maantieteellinen (EPSG:4258), ellei muuta määritelty ko. tietotuotteelle yhteentoimivuusasetuksessa. ETRS89-TM35FIN (EPSG:3067)
Vakioidut kyselyt Kaikkien WFS 2.0 -standardin mukaisten palvelimien tulee tukea vakioitujen kyselyiden luettelointia, kuvailua sekä suorittamista Lisäksi kaikkien palvelimien tulee oletuksena toteuttaa vakioitu kysely GetFeatureById, joka palauttaa annettua tunnistetta vastaavan kohteen STOREDQUERY_ID pakollinen parametri Vakioidut kyselyt tallennettu wfs:storedqueryelementteihin
Vapaat kyselyt TYPENAMES on vapaissa kyselyissä pakollinen parametri, jonka avulla määritetään kysyttävien kohdetyyppien nimet. ALIASES vaihtoehtoisten nimien antaminen kohdetyypeille SRSNAME koordinaattijärjestelmä PROPERTYNAME luettelo kohdeluokan valinnaisista ominaisuuksista, jotka halutaan vastaukseen Kohteiden valinta FILTER, RESOURCEID tai BBOXparametrilla
Vain vakioidut kyselyt mahdollistava WFS 2.0-rajapinta Vakioituja kyselyjä tukeva kyselypalvelu toteutetaan käyttämällä standardeja ISO 19142 Web Feature Service ISO 19143 Filter Encoding Palvelun on toteutettava seuraavat yhteentoimivuusluokat: ISO 19142 Web Feature Service / OGC WFS 2.0: Simple WFS ISO 19142 Web Feature Service / OGC WFS 2.0: HTTP GET ISO 19143 Filter Encoding / OGC FE 2.0: Query. Kyselyihin tulee sisällyttää kaikki tuetut vaihtoehdot eri koordinaattijärjestelmille, tietotuotteille ja kielille
Vapaat kyselyt mahdollistava WFS 2.0 -rajapinta Samat toiminnot kuin vakioituja kyselyjä tukevassa palvelussa Lisäksi mahdollisuus tehdä omia WFS-standardin mukaisia kyselyjä ja ladata aineiston osajoukkoja Palvelun on pystyttävä toteuttamaan seuraavat hakukriteerit: Paikkatietoaineiston yksilöivä resurssitunniste (Unique Resource Identifier) Kaikki paikkatietokohteiden keskeiset ominaisuustiedot ja suhteet yhteentoimivuusasetuksen mukaisesti. Rajaava suorakaide (BBOX) Paikkatiedon aihe (Spatial Data Theme)
Esimerkki: WFS-kysely elf-wfs.maanmittauslaitos.fi/elf-wfs/services/elfgn?service=wfs&request=getfeature&version=2.0.0&type names=elf-gn:namedplace Hakee kaikki kohteet, joiden kohdetyyppi on elfgn:namedplace Kyselyyn voisi lisätä muita rajaavia parametreja, esim. aluerajauksen (BBOX)
WFS-vastaus GML-muodossa Jokainen kohde on oma wfs:member Kohteen geometriatieto
Kohteen ominaisuustietoja
Lisätietoja http://www.paikkatietoikkuna.fi/web/fi/verkkopalvelut http://www.jhs-suositukset.fi/suomi/jhs180