Inspire-verkkopalvelut

Transkriptio

1 Inspire-verkkopalvelut Inspire-sihteeristön verkkokoulutus Teemu Saloriutta

2 Esityksen sisältö Mitä ovat verkkopalvelut Mitä vaatimuksia Inspire-direktiivi asettaa verkkopalveluille Miten toteutan katselupalvelurajapinnan (WMS, WMTS) Miten toteutan latauspalvelurajapinnan (WFS, Atom)

3 Miksi? Komissio kiristää INSPIRE-toimeenpanon seurantaa

4 1. Mitä ovat verkkopalvelut?

5 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

6 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

7 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

8 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

9 WMS ja WMTS WMS Web Map Service Katselupalvelu mahdollistaa paikkatietojen esittämisen asiakassovelluksessa päällekkäin sekä muut perustoiminnot WMTS Web Map Tile Service WMTS-katselupalvelu tarjoaa valmiiksi tuotettuja rasterimuotoisia kuvia mahdollistaen samat toiminnot kuin WMS-palvelu

10 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

11 2. Mitä vaatimuksia INSPIRE asettaa verkkopalveluille

12 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

13 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).

14 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

15 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

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

17 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

18 3. Miten toteutan katselupalvelun?

19 Datasta verkkopalveluksi WMS/ WMTS Esim. GeoServer, MapServer, Deegree Palvelinohjelmisto Uusi Tietokanta

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

21 A) Skeemalaajennokset GetCapabilities-dokumentin alussa määriteltävä INSPIRE-nimiavaruus ja skeemojen sijainti Ajantasaiset skeemat <WMS_Capabilities version="1.3.0" xmlns=" xmlns:inspire_common=" xmlns:inspire_vs=" xmlns:xlink=" xmlns:xsi=" xsi:schemalocation=" </WMS_Capabilities>

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

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

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

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

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

27 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

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

29 D) Viittaukset metatietoihin GetCapabilities-vastausviestiin tulee viittaus itse katselupalvelun metatietoihin <inspire_vs:extendedcapabilities> -elementin sisälle: <inspire_common:metadataurl> <inspire_common:url> &Request=GetRecordById&Version=2.0.2&id=[TIEDOSTOTUNNISTE] &outputschema= =full </inspire_common:url> <inspire_common:mediatype>application/vnd.iso xml</ inspire_common:mediatype> </inspire_common:metadataurl>

30 D) Viittaukset metatietoihin Lisäksi karttatasokohtainen viittaus aineiston metatietoihin <Layer>elementin alle, XML: <MetadataURL type="iso19115:2005"> <Format>text/xml</Format> <OnlineResource xlink:href=" equest=getrecordbyid&service=csw&id=[tiedostotunniste]&el ementsetname=full&outputschema= " xlink:type="simple" xmlns:xlink=" /> </MetadataURL> Koneluettava XML-tiedosto

31 D) Viittaukset metatietoihin Lisäksi karttatasokohtainen viittaus aineiston metatietoihin <Layer>elementin alle, HTML: <MetadataURL type="iso19115:2005"> <Format>text/html</Format> <OnlineResource xlink:href=" ata.show.portti?uuid=[tiedostotunniste] xlink:type="simple" xmlns:xlink=" /> </MetadataURL> Ihmisille sopiva HTML-tiedosto

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

33 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

34 F) Muut tekniset vaatimukset Rajapinnan on tuettava PNG- tai GIF-kuvamuotoa Myös JPEG-formaatin tukeminen on perusteltua esimerkiksi sävykuvamuotoisten aineistojen osalta

35 G) Palvelun tietosisältö 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 mennessä Liitteen II ja II aineistot mennessä Myös kuvaustyylin ja sitä vastaavan karttamerkkien selitteen tulee olla saatavina määriteltyihin aikarajoihin mennessä tietotuotemäärittelyn mukaisina.

36 4. Miten toteutan latauspalvelun?

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

38 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

39 Tuettavat toiminnot

40 Esimerkki: Lounaispaikka kaavat_atom/louspire_atom.xml Mahdollisuus ladata maakuntakaavoja

41 Atom-syötteen rakenne

42 Atom-syötteen rakenne

43 Tiedostopalvelusyöte

44

45 Linkki tuotesyötteeseen Linkki metatietoihin Ulottuvuus (BBOX)

46 Atom-syötteen rakenne

47 Tuotesyöte

48

49

50 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

51 Datasta WFS-palveluksi WFS Esim. GeoServer, MapServer, Deegree Palvelinohjelmisto Tietokanta Mahdollinen muunnos Uusi Tietokanta

52 Datasta WFS-palveluksi WFS Esim. GeoServer, MapServer, Deegree Palvelinohjelmisto Mahdollinen muunnos Tietokanta

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

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

55 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

56 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

57 Vain vakioidut kyselyt mahdollistava WFS 2.0-rajapinta Vakioituja kyselyjä tukeva kyselypalvelu toteutetaan käyttämällä standardeja ISO Web Feature Service ISO Filter Encoding Palvelun on toteutettava seuraavat yhteentoimivuusluokat: ISO Web Feature Service / OGC WFS 2.0: Simple WFS ISO Web Feature Service / OGC WFS 2.0: HTTP GET ISO Filter Encoding / OGC FE 2.0: Query. Kyselyihin tulee sisällyttää kaikki tuetut vaihtoehdot eri koordinaattijärjestelmille, tietotuotteille ja kielille

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

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

60 WFS-vastaus GML-muodossa Jokainen kohde on oma wfs:member Kohteen geometriatieto

61 Kohteen ominaisuustietoja

62 Lisätietoja