Latauspalvelun toteutusvaihtoehdot Paikkatiedon latauspalvelut - koulutuspäivä 31.1.2012 Jani Kylmäaho 1
KOLME TOTEUTUSVAIHTOEHTOA Liite 1: Palvelun laatu Osa A Lataustoiminnot Get Download Service Metadata Anna latauspalvelun metatiedot Get Spatial Data Set Anna paikkatietoaineisto Describe Spatial Data Set Kuvaile paikkatietoaineisto Link Download Service Linkitä latauspalvelu Osa B Suorasaantilataustoiminnot Get Spatial Object Anna paikkatietokohde Describe Spatial Object Type Kuvaile paikkatietokohdetyyppi 2 Osa C Get Spatial Object toiminnossa käytettävät hakukriteerit 1) ATOM-syöte TAI 2) WFS 2.0 Stored Query TAI
TAI, mikäli mahdollista, Liite 1: Palvelun laatu Osa A Lataustoiminnot Get Download Service Metadata Anna latauspalvelun metatiedot Get Spatial Data Set Anna paikkatietoaineisto Describe Spatial Data Set Kuvaile paikkatietoaineisto Link Download Service Linkitä latauspalvelu Osa B Suorasaantilataustoiminnot Get Spatial Object Anna paikkatietokohde Describe Spatial Object Type Kuvaile paikkatietokohdetyyppi Osa C Get Spatial Object toiminnossa käytettävät hakukriteerit 3) WFS 2.0 Ad Hoc Query 3
TAI kaikki kolme, eri käyttötarpeisiin Liite 1: Palvelun laatu Osa A Lataustoiminnot Get Download Service Metadata Anna latauspalvelun metatiedot Get Spatial Data Set Anna paikkatietoaineisto Describe Spatial Data Set Kuvaile paikkatietoaineisto Link Download Service Linkitä latauspalvelu Osa B Suorasaantilataustoiminnot Get Spatial Object Anna paikkatietokohde Describe Spatial Object Type Kuvaile paikkatietokohdetyyppi Osa C Get Spatial Object toiminnossa käytettävät hakukriteerit 1) ATOM-syöte 2) WFS 2.0 Stored Query 3) WFS 2.0 Ad Hoc Query 4
Ennalta määritellyn tiedon lataus ATOM-syötteen avulla Paikkatiedon latauspalvelut - koulutuspäivä 31.1.2012 Jani Kylmäaho 5
Sisältö ATOM-syöte Toimintojen toteutus ATOM-syötteen koostaminen o Syöte (Feed) o Merkintä (Entry) o Alisyötteet o Kielet ja koordinaattijärjestelmät Kysymyksiä ja vastauksia 6
ATOM-syöte 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 XML-pohjainen dokumenttiformaatti Dokumentissa kuvataan lista syötteitä (feed) Syöte koostuu yhdestä tai useammasta merkinnästä (entry) Syötteessä ja merkinnöissä voi molemmissa olla ATOMstandardin mukaisia metatietoja Syötteen voi tilata tavanomaiseen WWW-selaimeen tai muuhun syötteiden lukemiseen tarkoitettuun ohjelmaan ATOM-syöte ei ole rajapinta, mutta sen katsotaan täyttävän latauspalveluasetuksen Osan A vaatimukset 7
Esimerkkisyöte <?xml version="1.0" encoding="utf-8"?> <feed xmlns="http://www.w3.org/2005/atom > <title>tämä on ATOM-syöte</title> <link href="http://example.org/"/> <updated>2003-12-13t18:30:02z</updated> <author> </author> <name>erkki Esimerkki</name> <id>urn:uuid:60a76c80-d399-11d9-b93c-0003939e0af6</id> <entry> </entry> </feed> <title>ensimmäinen merkintäni</title> <link href="http://example.org/2003/12/13/atom03"/> <id>urn:uuid:1225c695-cfb8-4ebb-aaaa-80da344efa6a</id> <updated>2003-12-13t18:30:02z</updated> <summary>tämä on merkintä syötteen sisällä.</summary> 8
Lataustoimintojen toteutus ATOM-syötteen avulla 9
Verkkopalveluasetuksen rakenne Liite 1: Palvelun laatu Osa A Lataustoiminnot Get Download Service Metadata Anna latauspalvelun metatiedot ATOM-syöte Get Spatial Data Set Anna paikkatietoaineisto Describe Spatial Data Set Kuvaile paikkatietoaineisto Link Download Service Linkitä latauspalvelu RFC 4287 10
Tuettavat toiminnot Toiminto Rooli Toteutustapa 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 ATOM-syöte, jossa linkki palvelun metatietoihin Paikkatietohakemistoon ATOM-syötteessä linkki ladattavaan tiedostoon tai WFS Stored Queryyn ATOM-syötteessä linkki kohteiden kuvauksiin Feature Concept Dictionaryssa Latauspalvelun metatiedot julkaistuna Paikkatietohakemistossa 11
ATOM-syötteen koostaminen Syötteen sisältö (yksityiskohdat voivat vielä muuttua) 12
0) Nimiavaruudet Pakollinen tieto <feed xmlns=http://www.w3.org/2005/atom xmlns:xsi=http://www.w3.org/2001/xmlschema-instance xmlns:georss="http://www.georss.org/georss"> </feed> 13
1) Syötteen otsikko (title) Kertoo ATOM-syötteen otsikon Pakollinen tieto <title xml:lang= fi >Rakennustietojen INSPIRE-latauspalvelu</title> 14
2) Syötteen alaotsikko (subtitle) Selittävää lisätietoa palvelusta <subtitle xml:lang= fi">kuntajaotuksen INSPIRE-latauspalvelu perustuu kiinteistörekisterin tietoihin. Aineisto päivitetään kerran kuukaudessa.</subtitle> 15
3) Linkki palvelun metatietoihin (link, describedby) Linkitys latauspalvelun metatietoihin, jotka on syötetty hakupalveluun (Paikkatietohakemistoon) CSW-standardin mukainen GetRecordById kysely [METADATA_IDENTIFIER] osa korvataan palvelun metatiedon tiedostotunnisteella Esimerkiksi bc407a22-9fee-4372-ad6b-25e5645c2b77 Linkin rel-elementin arvoksi asetettava describedby Pakollinen tieto <link href= http://www.paikkatietohakemisto.fi/geonetwork/srv/fi/csw?service =CSW&Request=GetRecordById&Version=2.0.2&id=[METADAT A_IDENTIFIER]&outputSchema=http://www.isotc211.org/2005/g md&elementsetname=full rel= describedby /> 16
4) Linkki palveluun itseensä (link, self) Linkki, joka viittaa syötteeseen itseensä HTTP URI muotoinen Linkin rel-elementin arvoksi asetettava self Pakollinen tieto <link href="http://www.nls.fi/latauspalvelu rel= self type="application/atom+xml hreflang= fi" title="tämä syöte /> 17
5) Linkki palvelun kieliversioihin (link, alternate) Linkki, joka viittaa syötteen toiseen kieliversioon HTTP URI muotoinen Linkin rel-elementin arvoksi asetettava alternate Kielivaihtoehtoja voi olla useita, jolloin niiden titleelementtien on oltava erilaisia Pakollinen tieto, mikäli muunkielisiä syötteitä on tarjolla <link href="http://www.nls.fi/nedladdningstjanst rel= alternate type="application/atom+xml hreflang= fi" title= Maanmittauslaitoksen ruotsinkielinen latauspalvelu /> 18
6) Syötteen vaihtoehtoiset muodot (link, alternate) Syötteen voi toimittaa normaalin ATOM-XML-muodon lisäksi esimerkiksi HTML-muotoisena Linkin rel-elementin arvoksi asetettava alternate <link href=http://www.nls.fi/latauspalvelu/index.html rel= alternate type= text/html hreflang= fi" title= Maanmittauslaitoksen latauspalvelun käyttöliittymä /> 19
7) Syötteen yksilöivä tunniste (id) Syötteessä on oltava yksilöivä tunniste Tunnisteen lopullista muotoa ei vielä päätetty Pakollinen tieto <id>http://www.nls.fi/latauspalvelu/kuntajaotus-2012</id> 20
8) Tieto syötteen oikeuksista tai rajoitteista (rights) Tieto latauspalvelua koskevista käyttöoikeuksista tai rajoitteista Tyypillisesti sama tieto, kuin palvelun metatietojen accessconstraints elementissä Pakollinen tieto <rights>palvelun käyttö vaatii autentikointia eli tunnistautumista käyttäjätunnuksen ja salasanan avulla.</rights> 21
9) Tieto syötteen päivitysajankohdasta (updated) Tieto siitä, milloin syötettä on viimeksi päivitetty Pakollinen tieto <updated>2012-01-30t12:22:09z </updated> 22
10) Yhteenveto syötteen sisällöstä (summary) Tietoa latauspalvelun sisällöstä <summary>palvelun kautta saa käyttöön ajantasaiset rasterimuotoiset perus-, maasto- ja yleiskartat sekä ilmakuvat. Palvelu on tarkoitettu WMS-standardia tukevien sovellusten käyttöön.</summary> 23
11) Tieto syötteen ylläpitäjästä (author) Syötettä ylläpitävän organisaation yhteystiedot Pakollinen tieto <author> <name>maanmittauslaitos</name> <email>karttapaikkaasiakas@maanmittauslaitos.fi </email> </author> 24
ATOM-syötteen koostaminen Merkinnän sisältö (yksityiskohdat voivat vielä muuttua) 25
12) Merkintä (entry) Jokaista ladattavaa tietotuotetta kohden on oltava merkintä Merkinnän sisällä osin samannimisiä elementtejä kuin syötteessä, mutta sisältö koskee tietotuotetta Pakolliset elementit: entry ja sen sisällä title, id, updated, rights (mikäli tietotuotetta koskee muita ehtoja kuin koko syötettä) Valinnaiset elementit: subtitle, author, rights (valinnainen, mikäli syötteen rights-elementti pätee kaikkiin tietotuotteisiin) <entry> <title xml:lang= fi >Kuntajaotus/> <subtitle xml:lang= fi >Vuoden 2012 kuntajaotus/> <id>http://www.nls.fi/latauspalvelu/kuntajaotus-2012.gml</id> <updated>2012-01-30t12:22:09z</updated> <rights>aineisto on vapaasti käytettävissä.</rights> </entry> 26
13) Linkki ladattavaan tietotuotteeseen (link, alternate) Jokaisessa merkinnässä tulee olla vähintään yksi linkki Ladattava tiedosto voi olla esimerkiksi gml-tiedosto tai shape-tiedosto Linkin rel-elementin arvoksi asetettava alternate Pakollinen tieto <link rel="alternate href="http://www.nls.fi/latauspalvelu/kuntajaotus-2012.gml type="application/gml+xml;version=3.2" hreflang= fi title= Vuoden 2012 kuntajaotus GML 3.2.muodossa ETRS89- TM35FIN-koordinaatistossa (http://www.opengis.net/def/crs/epsg/0/3067)/> 27
14) Tietotuotteen kattavuusalue (georss:box) Ilmaisee tietotuotteen maantieteellisen kattavuusalueen Ilmoitetaan WGS84-koordinaatteina Tieto on erikseen jokaisen merkinnän sisällä <georss:box>19.08317 59.45414 31.58673 70.09230</georss:box> 28
15) Kategoria (category) Jokaiselle ladattavalle tietotuotteelle on määriteltävä kategoria Kategoriatieto on merkinnän sisällä Kategoria merkitään viittaamalla INSPIRE:n Feature Concept Dictionaryyn (FCD) Kategorioiksi merkitään tietotuotteen sisältämät kohdetyypit Pakollinen tieto <category term="administrative unit scheme="http://inspireregistry.jrc.ec.europa.eu/registers/fcd/ label= Administrative unit" xml:lang= en"/> <category term= Administrative boundary scheme="http://inspireregistry.jrc.ec.europa.eu/registers/fcd/ label=" Administrative boundary " xml:lang= en"/> 29
ATOM-syötteen koostaminen Tietotuotteiden jaottelu 30
16) Tietotuotteiden jaottelu, esimerkki Pääsyöte Tietotuotteen voi jakaa useisiin alisyötteisiin, joihin viitataan pääsyötteestä Kussakin alisyötteessä voi olla 1-n merkintää Esimerkki: tiestön tarjoaminen ladattavaksi maakunnittain ja niiden sisällä kunnittain Koko Suomi Koko Uusimaa Helsinki Kerava 31 Uusimaasyöte Kanta- Häme -syöte Koko Kanta- Häme Jokioinen Forssa
16) Tietotuotteiden jaottelu, esimerkki <feed xmlns= Pääsyöte > <entry> Koko Suomen tiet <entry/> <link rel="alternate href="http://www.nls.fi/latauspalvelu/tiestokokosuomi.gml type="application/gml+xml;version=3.2" hreflang= fi title= Koko Suomen tiet /> <entry> Uusimaa-syöte </entry> </feed> <link rel="alternate href="http://www.nls.fi/latauspalvelu/tiestouusimaa.xml type="application/atom+xml" hreflang= fi title= Uusimaa-syöte subtitle= Syöte sisältää koko Uudenmaan latauslinkin sekä kunnittaiset latauslinkit /> 32
<feed xmlns= Uusimaa-syöte > <entry> Koko Uusimaa <link rel="alternate href="http://www.nls.fi/latauspalvelu/tiestouusimaa.gml type="application/gml+xml;version=3.2" hreflang= fi title= Koko Uudenmaan tiet /> <entry/> <entry> Helsinki <link rel="alternate href="http://www.nls.fi/latauspalvelu/tiestohelsinki.gml type="application/gml+xml;version=3.2" hreflang= fi title= Helsingin tiet /> <entry/> <entry> Kerava <link rel="alternate href="http://www.nls.fi/latauspalvelu/tiestokerava.gml type="application/gml+xml;version=3.2" hreflang= fi title= Keravan tiet /> </entry> </feed> 33
17) Sama tietotuote useissa koordinaattijärjestelmissä Mikäli tietotuote on ladattavissa useissa eri koordinaattijärjestelmissä, linkit eri koordinaattijärjestelmäversioihin on tarjottava erikseen Suositus: eri koordinaattijärjestelmissä tarjottavat tietotuotteet esitetään alisyötteessä kukin tietotuote erikseen Pääsyöte: <feed> <entry> <title xml:lang= fi >Kuntajaotus 2012</title> <link rel="alternate href="http://www.nls.fi/latauspalvelu/kuntajaotus-2012-crs.xml type="application/atom+xml" title= Linkki syötteeseen, joka sisältää kuntajaotuksen eri koordinaattijärjestelmissä /> </entry> </feed> 34
Alisyöte: <feed> <entry> <title xml:lang= fi >Kuntajaotus 2012, CRS EPSG:3067</title> <link rel="alternate href="http://www.nls.fi/latauspalvelu/kuntajaotus- 2012-3067.gml type="application/gml+xml;version=3.2" title= Kuntajaotus ETRS89-TM35FIN-koordinaatistossa (http://www.opengis.net/def/crs/epsg/0/3067) /> </entry> <entry> <title xml:lang= fi >Kuntajaotus 2012, CRS EPSG:4258</title> <link rel="alternate href="http://www.nls.fi/latauspalvelu/kuntajaotus- 2012-4258.gml type="application/gml+xml;version=3.2" title= Kuntajaotus ETRS89-lat/lon-koordinaatistossa (http://www.opengis.net/def/crs/epsg/0/4258) /> </entry> </feed> 35
18) Sama tietotuote useilla eri kielillä Mikäli tietotuote on ladattavissa useilla eri kielillä, linkit eri kieliversioihin on tarjottava eri syötteissä Jokaisessa syötteessä on tarjottava linkki nykyiseen syötteeseen Linkin rel-elementin arvo on tässä tapauksessa self Jokaisessa syötteessä on tarjottava linkki muulla kielellä tarjottuun, samat tiedot sisältävään syötteeseen Linkin rel-elementin arvo on tässä tapauksessa alternate 36
18) Sama tietotuote useilla eri kielillä Suomenkielinen syöte: <feed> <entry> </entry> </feed> <link rel= self href="http://www.nls.fi/latauspalvelu type="application/atom+xml hreflang= fi title= Syöte suomenkielisille tietotuotteille /> <link rel="alternate href="http://www.nls.fi/nedladdningstjanst type="application/atom+xml hreflang= fi title= Syöte ruotsinkielisille tietotuotteille /> 37
18) Sama tietotuote useilla eri kielillä Ruotsinkielinen syöte: <feed> <entry> </entry> </feed> <link rel= self href="http://www.nls.fi/nedladdningstjanst type="application/atom+xml" hreflang= sv title= Atom-flöde för dataprodukter på svenska /> <link rel="alternate href="http://www.nls.fi/latauspalvelu type="application/atom+xml" hreflang= sv title= Atom-flöde för dataprodukter pä finska /> 38
Kysymyksiä ja vastauksia Mitä tiedostomuotoja latauspalvelusta on tarjottava? Missä koordinaattijärjestelmissä tietoa on tarjottava? Vuoteen 2017/2019 saakka riittävät nykyiset tiedostomuodot, ja koordinaattijärjestelmät, mutta tiedon harmonisoinnin ja yhteiskäytön edistämiseksi suositellaan GML3-muotoista tietoa ja ETRS89-maantieteellistä tai ETRS89-TM35FIN koordinaattijärjestelmää Miten luon ATOM-syötteen? Valmiita välineitä löytyy esim. Googlen avulla hakemalla ATOM feed creator / publisher Voinko jotenkin validoida, onko ATOM-syötteeni oikeanlainen? W3C:llä on yleinen syötteiden validointityökalu: http://validator.w3.org/feed/ Myös Komissio tulee aikanaan validoimaan latauspalveluiden vaatimustenmukaisuutta 39
Kysymyksiä ja vastauksia Miten tarjoan latauspalvelun usealla eri kielellä ATOM-syötteen avulla? Jokaiselle kielelle tulee toteuttaa erillinen syöte Miten tarjoan latauspalvelun useassa eri koordinaattijärjestelmässä ATOM-syötteen avulla? Eri koordinaattijärjestelmille kannattaa toteuttaa alisyötteet Onko jossain nähtävillä kokonainen Inspire-ATOM-syöte? Ei vielä, koska teknisen ohjeen laadinta on kesken. Kokonainen toteutusmalli julkaistaan teknisen ohjeen mukana Milloin lopullinen tekninen ohje on saatavilla? Helmikuun 2012 aikana Milloin annetaan JHS-suositus aiheesta? JHS-suosituksen 180 päivitys on menossa ja se valmistuu kevään aikana Milloin tulee lisätietoa palvelutasovaatimusten tulkinnasta? Toukokuun 2012 aikana julkaistaan ohje palvelutasovaatimuksista 40
41
Teknisen ohjeen lukuohjeita Teknisessä ohjeessa määritelty yhteentoimivuusluokka, joka on yksi vaihtoehto ohjeen mukaisen palvelun toteuttamiseksi Vaatimus, jota on noudatettava ko. standardin takia Tämä vaatimus on täytettävä, jotta palvelu olisi teknisen ohjeen mukainen Suositeltava menettely teknisen ohjeen mukaisissa palveluissa 42
Kiitos mielenkiinnosta! Kysymyksiä / Palautetta: inspire@nls.fi 43