Ennalta määritellyn tiedon lataus vakioidulla kyselyllä (WFS 2.0 Stored Query) Tiedon lataus vapailla kyselyillä (WFS 2.0 Ad hoc query) Paikkatiedon latauspalvelut - koulutuspäivä 20.11.2012 Jari Reini 1
Latauspalvelut Inspire-direktiivi VERKKOPALVELUT 11 artikla latauspalvelut, jotka mahdollistavat paikkatietoaineistojen ja niiden osien kopioinnin omalle tietokoneelle ja, mahdollisuuksien mukaan, suoran pääsyn niihin linkki 2
Hyödyntäminen Palvelukerros Kohdeym. luettelot Tietoaineistot Rajapinnat Paikkatietoinfrastruktuurissa Palveluväylä Luettelopalvelu Sovellukset ja paikkatietoportaalit Hakupalvelu Palvelujen metatiedot Tiedon keruu ja ylläpito Paikkatietoaineistojen metatiedot Katselupalvelu 3 Oikeuksien hallinnan kerros Latauspalvelu Paikkatietoaineistot Muunnospalvelu ATOM Vakioitu kysely (WFS 2.0 Stored Query) Vapaa kysely (WFS 2.0 Ad hoc) Käynnistyspalvelu
Huomioitavaa Jatkossa mainittu ISO 19142 WFS tunnetaan myös nimellä OGC Web Feature Service 2.0 ja ISO 19143 Filter Encoding nimellä OGC Filter Encoding 2.0 4
Paikkatietojen kyselypalvelu (WFS) Asiakasohjelma tekee metatietokyselyn (GetCapabilities), jonka tuloksesta käy ilmi mm. palvelun tukemat kyselyoperaatiot ja tarjolla olevien kohdeluokkien nimet ja kattavuusalueet Asiakasohjelma tekee tietomallikyselyn (DescribeFeatureType) valitsemastaan palvelun tarjoamasta kohdeluokasta. Tulosviestistä selviää ko. kohdeluokan sisältämät ominaisuudet, niiden tietotyypit ja pakollisuus/toistuvuusmääreet Saamansa metatiedon pohjalta asiakasohjelma pystyy nyt luomaan järkevän paikkatietokyselyn (GetFeature) ja lähettämään sen palveluun Palvelu prosessoi kyselyn ja palauttaa Geography Markup Language (GML) -muotoisen vastausviestin (tai mahdollisen virheviestin, jos prosessointi syystä tai toisesta epäonnistui) 5
Kyselypalvelu vakioidut kyselyt (osa A *) WFS 2.0 palvelu (Stored Query) *) Komission asetus: Lataustoiminnot 6
Tuettavat operaatiot Toiminto Rooli Toteutus Get Download Service Metadata (Anna latauspalvelun metatiedot Get Spatial Data Set (Anna paikkatietoaineisto) Describe Spatial Data Set (Kuvaile paikkatietoaineisto) Link Download Service (Linkitä latauspalvelu) Tiedot palvelusta, palvelun ominaisuuksista ja paikkatietoaineistoista Paikkatietoaineiston haku Kuvaus paikkatietokohteista Linkki latauspalveluun WFS GetCapabilties, (josta linkki Paikkatietohakemiston metatietoihin) WFS Stored query WFS GetCapabilities Latauspalvelun metatiedot Paikkatietohakemistossa 7
Vakioitu kysely Lataus WFS Stored Query periaatteella ISO 19142 WFS / OGC WFS 2.0: Simple WFS ISO 19142 WFS / OGC WFS 2.0: HTTP GET ISO 19143 Filter Encoding / OGC FE 2.0: Query Lisäksi palveluun on määriteltävä tarvittavat ennalta määritellyt kyselyt (Stored Query) kaikille tarjolla oleville tietotuote / koordinaattijärjestelmäkombinaatioille Lisäksi Inspire-kielivaatimukset SupportedLanguages DefaultLanguage ResponseLanguage 8
19142 Simple WFS toteutuksen vaatimukset GetCapabilities Palvelun ja aineistojen tiedot &REQUEST= GetCapabilities DescribeFeatureType kuvaus paikkatietokohteiden tyypeistä ListStoredQueries Esittää luettelon tallennetuista kyselyistä &REQUEST= ListStoredQueries DescribeStoredQueries &REQUEST=DescribeStoredQueries&STOREDQUERY_ID= GetFeature operaatio stored query GetFeatureById parametrilla Palauttaa ID-mukaisen kohteen 9
19142 Simple WFS Stored Query Kyselyt ovat palvelimelle lähetettyjä pyyntöjä, joilla haetaan kyselyn mukaisia tietoja tietovarastosta. Stored query on palvelimelle tallennettu kysely, jota voidaan kutsua kyselyn id:llä Stored Queryn määrittely Title Abstract Metadata Name Type 10
Esimerkkejä: Vakioidut kyselyt (Stored Query) ListStoredQueries &request=liststoredqueries DescribeStoredQuery &request=describestoredqueries&storedquery_id =urn:ogc:def:query:ogc-wfs::getfeaturebyid Suorita vakiokysely &STOREDQUERY_ID=urn:ogc:def:query:OGC- WFS::GetFeatureById&ID=NAVNONAME3 http://www.myinspirewfs.com/wfs?service=wfs&r equest=getfeature&storedquery_id=urnx:wfs:stor edqueryid:mynamspace:getdatasetbyidandcr S&DataSetID=123abc&CRS=EPSG:4258 11
19142 HTTP GET Palvelun tulee toteuttaa KVP (Key Value Pair) kaikille operaatioille, jotka on listattu GetCapabilities - dokumentin OperationsMetadata kohdassa Parametreille on sallittava satunnainen järjestys sekä merkkikokoriippumattomuus (case-insensitive) Esim. DescribeFeatureType vs. describefeaturetype vs. DEScRiBEfeaturEType 12
Suosituksia ja vaatimuksia Jokaiselle INSPIRE tietotuotteelle suositellaan oma palvelun päätepiste (endpoint) Latauspalvelun metadatan tulee sisältää luettelo palvelun tuetuista kielistä Jos kysytty kieli on tuettu, tulee vastauksen olla kysytyssä kielessä. Jos kysyttyä kieltä ei ole tuettu, tulee kieliparametri jättää huomioimatta 13
Kielivaatimukset Kielivaatimusten toteuttamiseksi ISO 19142 WFS operaatioita tulee laajentaa: GetCapabilities-operaatiolle parametri LANGUAGE Jos asiakas pyytää tietoja ei tuetulla kielellä, palautetaan vastaus palvelun oletuskielelellä Esim. GetCabilities-vastaus (kun kysytty LANGUAGE=swe): <inspire_common:supportedlanguages> <inspire_common:defaultlanguage> <inspire_common:language>fin</inspire_common:language> </inspire_common:defaultlanguage> <inspire_common:supportedlanguage> <inspire_common:language>swe</inspire_common:language> </inspire_common:supportedlanguage> </inspire_common:supportedlanguages> <inspire_common:responselanguage> <inspire_common:language>swe</inspire_common:language> </inspire_common:responselanguage </inspire_vs:extendedcapabilities> 14
Koordinaatistovaatimukset ETRS89 maantieteellinen (EPSG:4258), ellei muuta määritelty ko. tietotuotteelle yhteentoimivuusasetuksessa. ETRS89-TM35FIN (EPSG:3067). 15
Demo Vakioitu kysely ListStoredQuery DescribeStoredQueries CreateStoredQuery DropStoredQuery 16
Suorasaantilataus (Osat B ja C) Kyselypalvelu - vapaat kyselyt WFS 2.0 palvelu (Ad hoc -kyselyt) 17
Vapaat kyselyt Vapaita kyselyjä tukeva kyselypalvelu tarjoaa samat toiminnot kuin vakioituja kyselyjä tukeva kyselypalvelu, mutta lisäksi se tarjoaa mahdollisuuden tehdä omia WFS-standardin mukaisia kyselyjä ja ladata aineiston osajoukkoja. 18
Tuettavat operaatiot Toiminto Rooli Toteutus Get Download Service Metadata (Anna latauspalvelun metatiedot Get Spatial Data Set (Anna paikkatietoaineisto) Describe Spatial Data Set (Kuvaile paikkatietoaineisto) Link Download Service (Linkitä latauspalvelu) Tiedot palvelusta, palvelun ominaisuuksista ja paikkatietoaineistoista Paikkatietoaineiston haku Kuvaus paikkatietokohteista Linkki latauspalveluun WFS GetCapabilties, josta linkki Paikkatietohakemiston metatietoihin WFS Stored query WFS GetCapabilities Latauspalvelun metatiedot Paikkatietohakemistossa 19
Tuettavat operaatiot Toiminto Rooli Toteutus Get Spatial Object (Anna paikkatietokohde) Paikkatietokohteiden haku omalle koneelle ad hoc - kyselyn perusteella. WFS GetFeature Describe Spatial Object Type (Kuvaile paikkatietokohdetyyppi) Kuvaus pyydetyistä paikkatietokohdetyypeistä WFS DescribeFeatureType 20
Get Spatial Object -toiminnossa käytettävät hakukriteerit Toiminto Rooli Toteutus Unique Resource Identifier paikkatietokohteiden keskeiset attribuutit ja suhteet; erityisesti paikkatietokohteen yksilöivä resurssitunniste ja aikaulottuvuuteen liittyvät ominaisuudet, kuten päivitysajankohta Paikkatietoaineiston yksilöivä resurssitunniste Yksilöivä tunniste RESOURCEIDparametri Ad hoc -kysely Bounding Box rajaava suorakaide &BBOX Spatial Data Theme paikkatiedon aihe &GetFeature& TypeName=XXX 21
Vapaa kysely - toteutettavat standardit ISO 19142 WFS / OGC WFS 2.0: Simple WFS ISO 19142 WFS / OGC WFS 2.0: HTTP GET ISO 19142 WFS / OGC WFS 2.0: Basic WFS ISO 19143 Filter Encoding / OGC FE 2.0: Query ISO 19143 Filter Encoding / OGC FE 2.0: Ad Hoc Query ISO 19143 Filter Encoding / OGC FE 2.0: Resource Identification ISO 19143 Filter Encoding / OGC FE 2.0: Minimum Standard Filter ISO 19143 Filter Encoding / OGC FE 2.0: Minimum Spatial Filter ISO 19143 Filter Encoding / OGC FE 2.0: Minimum Temporal Filter ISO 19143 Filter Encoding / OGC FE 2.0: Minimum Xpath Lisäksi Inspire-kielivaatimukset 22
ISO 19143 Ad hoc Query (vapaa kysely) Toisin kuin Stored Query, Ad hoc kysely ei ole etukäteen tiedossa Ad hoc kyselyä voi käyttää GetFeature, GetPropertyValue, GetFeatureWithLock ja LockFeature operaatioissa Ad hoc kysely sisältää mm. parametrit typenames (pakollinen) Valintakriteerin (selection) Järjestelyn (sorting) 23
ISO 19143 Ad hoc Query Parametrit o TYPENAMES (pakollinen) o ALIASES o PROPERTYNAME o FILTER o FILTER_LANGUAGE (oletus OGC-FES) o RESOURCEID o BBOX o SORTBY 24
Esimerkki ad-hoc kysely http://www.someserver.com/wfs.cgi? SERVICE=WFS& VERSION=2.0.0 REQUEST=GetFeature& TYPENAMES=(myns:Parks)(myns:Lakes)& FILTER=(<fes:Filter><fes:BBOX><fes:ValueReference>/RS1/geome try</fes:valuereference> <gml:envelope+srsname="urn:ogc:def:crs:epsg::4326"> <gml:lowercorner>49.1874-123.2778</gml:lowercorner> <gml:uppercorner>49.3504-122.8892</gml:uppercorner> </gml:envelope></fes:bbox><fes:filter>)(<fes:filter> <fes:bbox><fes:valuereference>/rs1/geometry</fes:valuerefere nce> <gml:envelope+srsname="urn:ogc:def:crs:epsg::4326"> <gml:lowercorner>44.6113-63.7058</gml:lowercorner> <gml:uppercorner>44.7256-63.4641</gml:uppercorner> </gml:envelope></fes:bbox><fes:filter>) 25
ISO 19143 Minimum XPath XML Xpath (XML Path Language) on kieli, jolla voidaan etsiä osia XML-tiedostosta Esim. addresses/address[street="oxfordstrasse"]/number 26
ISO 19143 jatkuu... ISO 19143 Resource Identification Palvelun tulee tukea Resourceid- operaattoria ja rid parametria Jokaisella kohteella on yksilöivä tunniste Poistetun kohteen tunnistetta ei voi uudelleenkäyttää ISO 19143 Minimum Standard Filter Toteutettava seuraavat loogiset operaattorit PropertyIsEqualTo, PropertyIsNotEqualTo, PropertyIsLessThan, PropertyIsGreaterThan, PropertyIsLessThanOrEqualTo, PropertyIsGreaterThanOrEqualTo ISO 19143 Minimum Spatial Filter BBOX operaattori tulee olla tuettuna ISO 19143 Minimum Temporal Filter Palvelun tulee toteuttaa During -operaatio 27
Get Spatial Object -toiminnossa käytettävät hakukriteerit paikkatietoaineiston yksilöivä resurssitunniste (Unique Resource Identifier), kaikki asiaan liittyvät paikkatietokohteiden keskeiset attribuutit ja suhteet asetuksen (EU) N:o 1089/2010 mukaisesti; erityisesti paikkatietokohteen yksilöivä resurssitunniste ja aikaulottuvuuteen liittyvät ominaisuudet, kuten päivitysajankohta, rajaava suorakaide, ilmaistuna jonkin asetuksessa (EU) N:o 1089/2010 luetellun koordinaattijärjestelmän mukaisesti, paikkatiedon aihe (Spatial Data Theme) 28
Esimerkkejä Paikkatietokohteiden haku omalle koneelle ad hoc - kyselyn perusteella.tyypillisiä hakuja: Hae kaikki kohteet suorakaiteen sisältä Hae yksittäinen kohde yksilöllisellä tunnisteella Hae kaikki kohteet joltain aikaväliltä Hae kaikki kohteet joilla on tietty ominaisuus (tai jollain välillä) Hae kaikki kohteet joilla on tietty ominaisuus ja ovat 50 metrin sisällä käyttäjän määrittelemästä sijainnista tai alueesta Kuvaus pyydetyistä paikkatietokohdetyypeistä Service=WFS&version=2.0.0&request=DescribeFeature Type&TypeNames=MinunData 29
Esimerkkejä Paikkatietoaineiston yksilöivä resurssitunniste Service=WFS&version=2.0.0&request=GetFeature&TypeNames=nls :municipalities&resourceid=municipalities.1,municipalities.3 Rajaava suorakaide &BBOX=18.54,-72.3544,18.62,-72.2564 Paikkatiedon aihe &GetFeature&TypeNames=ps:ProtectedSite During operaatio <fes:during> <fes:valuereference>ps:protectedsite//gml:validtime</fes:valuereference> <fes:literal> <gml:timeperiod gml:id="id1"> <gml:beginposition>2009-10- 30T00:00:00.000Z</gml:beginPosition> </fes:during> <gml:endposition>2009-10-31t00:00:00.000z</gml:endposition> </gml:timeperiod> </fes:literal> 30
Yhteenveto Kehityspolku nykypalveluille: Tiedostopohjaiset latauspalvelut -> ATOM syöte WFS-rajapintaan pohjautuvat latauspalvelut -> Vakoitu kysely (WFS/FE Simple) jos mahdollista vapaa kysely (WFS/FE Basic) JHS-180 Paikkatiedon sisältöpalvelut lausuntokierroksella Liite 2 Paikkatiedon kyselypalvelu 31
Yhteenveto: vaihtoehdot Latauspalvelut Lataustoiminnot Osa A Anna latauspalvelun metatiedot Anna paikkatietoaineisto Kuvaile paikkatietoaineisto Linkitä latauspalvelu Suorasaantilataus Osa B Anna paikkatietokohde Kuvaile paikkatietokohdetyyppi Hakukriteerit Osa C yksilöivä resurssitunniste paikkatietokohteiden keskeiset attribuutit rajaava suorakaide (BBOX) paikkatiedon aihe (teema) 32
Kiitos mielenkiinnosta! Kysymyksiä / Palautetta: inspire@nls.fi 33