Tiedon lataus vapailla kyselyillä (WFS 2.0 Ad hoc query)

Transkriptio

1 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ä Jari Reini 1

2 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

3 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

4 Huomioitavaa Jatkossa mainittu ISO WFS tunnetaan myös nimellä OGC Web Feature Service 2.0 ja ISO Filter Encoding nimellä OGC Filter Encoding 2.0 4

5 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

6 Kyselypalvelu vakioidut kyselyt (osa A *) WFS 2.0 palvelu (Stored Query) *) Komission asetus: Lataustoiminnot 6

7 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

8 Vakioitu kysely Lataus WFS Stored Query periaatteella ISO WFS / OGC WFS 2.0: Simple WFS ISO WFS / OGC WFS 2.0: HTTP GET ISO 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

9 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

10 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

11 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 equest=getfeature&storedquery_id=urnx:wfs:stor edqueryid:mynamspace:getdatasetbyidandcr S&DataSetID=123abc&CRS=EPSG:

12 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

13 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

14 Kielivaatimukset Kielivaatimusten toteuttamiseksi ISO 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

15 Koordinaatistovaatimukset ETRS89 maantieteellinen (EPSG:4258), ellei muuta määritelty ko. tietotuotteelle yhteentoimivuusasetuksessa. ETRS89-TM35FIN (EPSG:3067). 15

16 Demo Vakioitu kysely ListStoredQuery DescribeStoredQueries CreateStoredQuery DropStoredQuery 16

17 Suorasaantilataus (Osat B ja C) Kyselypalvelu - vapaat kyselyt WFS 2.0 palvelu (Ad hoc -kyselyt) 17

18 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

19 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

20 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

21 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

22 Vapaa kysely - toteutettavat standardit ISO WFS / OGC WFS 2.0: Simple WFS ISO WFS / OGC WFS 2.0: HTTP GET ISO WFS / OGC WFS 2.0: Basic WFS ISO Filter Encoding / OGC FE 2.0: Query ISO Filter Encoding / OGC FE 2.0: Ad Hoc Query ISO Filter Encoding / OGC FE 2.0: Resource Identification ISO Filter Encoding / OGC FE 2.0: Minimum Standard Filter ISO Filter Encoding / OGC FE 2.0: Minimum Spatial Filter ISO Filter Encoding / OGC FE 2.0: Minimum Temporal Filter ISO Filter Encoding / OGC FE 2.0: Minimum Xpath Lisäksi Inspire-kielivaatimukset 22

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

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

25 Esimerkki ad-hoc kysely 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> </gml:lowercorner> <gml:uppercorner> </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> </gml:lowercorner> <gml:uppercorner> </gml:uppercorner> </gml:envelope></fes:bbox><fes:filter>) 25

26 ISO Minimum XPath XML Xpath (XML Path Language) on kieli, jolla voidaan etsiä osia XML-tiedostosta Esim. addresses/address[street="oxfordstrasse"]/number 26

27 ISO jatkuu... ISO Resource Identification Palvelun tulee tukea Resourceid- operaattoria ja rid parametria Jokaisella kohteella on yksilöivä tunniste Poistetun kohteen tunnistetta ei voi uudelleenkäyttää ISO Minimum Standard Filter Toteutettava seuraavat loogiset operaattorit PropertyIsEqualTo, PropertyIsNotEqualTo, PropertyIsLessThan, PropertyIsGreaterThan, PropertyIsLessThanOrEqualTo, PropertyIsGreaterThanOrEqualTo ISO Minimum Spatial Filter BBOX operaattori tulee olla tuettuna ISO Minimum Temporal Filter Palvelun tulee toteuttaa During -operaatio 27

28 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

29 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

30 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, ,18.62, 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> T00:00:00.000Z</gml:beginPosition> </fes:during> <gml:endposition> t00:00:00.000z</gml:endposition> </gml:timeperiod> </fes:literal> 30

31 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

32 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

33 Kiitos mielenkiinnosta! Kysymyksiä / Palautetta: inspire@nls.fi 33