JHS XXX Paikkatiedon yksilöivät tunnisteet Liite 1: URI:n muodostamisen prosessi Versio: 2014-11-10 Julkaistu: Voimassaoloaika: 1 Johdanto... 1 2 Paikallisen tunnisteen luominen tietokantaan... 1 3 Yksilöivän HTTP URI -tunnisteen luominen... 2 3.1 Aineistotunnisteen varaaminen... 2 3.2 Yksilöitävän kohteen tyyppi... 3 3.2.1 Paikkatietokohteet (so)... 3 3.2.2 Reaalimaailman kohteet (id)... 4 3.2.3 Paikkatietokäsitteet (def)... 5 4 Uudelleenohjausten asettaminen... 5 1 Johdanto Tässä liitteessä kuvataan vaiheittain prosessi, jolla suosituksen mukaiset yksilöivät URI-tunnisteet voidaan muodostaa. Prosessin vaiheet ovat: Luodaan paikalliset tunnisteet tietokantaan (kohta 2) Varataan aineistotunniste ja luodaan yksilöivät HTTP URI -tunnisteet (kohta 3) Määritellään luotujen HTTP URI-tunnisteiden uudelleenohjaukset kansalliseen paikkatietojen URIpalveluun (kohta 4). 2 Paikallisen tunnisteen luominen tietokantaan Tietoa tuottavan järjestelmän tietokantaan perustetaan kenttä yksilöivää tunnistetta varten. Paikallisena tunnisteena (localid) voidaan soveltaa järjestelmien sisäisiä tunnisteita tai muita vakiintuneita tunnisteita, jos järjestelmän sisäiset tunnisteet ovat: Yksikäsitteisiä Pysyviä Jäljitettäviä Toteutuskelpoisia Ellei em. ehtoja täyttäviä tunnisteita ole olemassa, paikallisena tunnisteena voidaan käyttää IETF:n RFC 4122 -standardin mukaista 128-merkkistä UUID-tunnistetta (Universally Unique Identifier), jonka generointiin on moduleita useissa tiedonhallintajärjestelmissä ja ohjelmointikielissä, esim. Wikipedia: Universally Unique Identifier. 1/6
3 Yksilöivän HTTP URI -tunnisteen luominen Suosituksen mukaiset yksilöivät HTTP URI -tunnisteet ovat muotoa http://paikkatiedot.fi/{type}/{aineistotunniste}/{paikallinen tunniste}, jossa type = yksilöitävän kohteen tyyppi - paikkatietokohteille type = so - reaalimaailman kohteille type = id - paikkatietokäsitteille type = def aineistotunniste = Paikkatietohakemiston aineistotunniste paikallinen tunniste = tietoa tuottavan järjestelmän tietokantaan perustettu yksilöivä paikallinen tunniste Alla oleva kuva havainnollistaa suosituksen mukaisten HTTP URI -tunnisteiden muodostamista. 3.1 Aineistotunnisteen varaaminen Kuvataan aineisto Paikkatietohakemistoon. Aineiston kuvailuun löytyy ohjeistusta Paikkatietoikkunasta ja Paikkatietohakemiston käyttöohjeesta. Julkisen hallinnon suositukseen JHS 158 Paikkatiedon metatiedot on koottu INSPIRE-direktiivin ja standardien vaatimukset. Pakollisena tietona Paikkatietohakemistoon tallennetaan aineiston kuvaus (Tiivistelmä) ja sen vastuutaho. Lisäksi Paikkatietohakemistoon suositetaan tallennettavaksi linkki latauspalveluun, josta aineisto on saatavilla. INSPIRE-aineistoille linkki latauspalveluun on toimeenpanosääntöjen mukaan pakollinen. 2/6
Paikkatietohakemiston aineistotunnisteen, joka on osana yksilöivän HTTP URI-tunnisteen nimiavaruutta, saa osoitteesta metatieto(at)maanmittauslaitos.fi. 3.2 Yksilöitävän kohteen tyyppi Suosituksen mukaan yksilöitäviä kohteita ovat paikkatietokohteet (so), reaalimaailman kohteet (id) ja paikkatietokäsitteet (def). 3.2.1 Paikkatietokohteet (so) Paikkatietokohteen tunniste ilmaistaan URI-kaavassa /so/-polkukomponentilla (so = spatial object). JHSsuosituksessa on pakollisena /so/-tunnisteen perustaminen. Yleinen URI-kaava paikkatietokohteelle on http://paikkatiedot.fi/so/{aineistotunniste}/{paikallinen tunniste}[/{versiotunniste}] INSPIRE-paikkatietokohteille URI-polkuun tulee lisäksi sisältyä INSPIRE-teema ja kohdeluokka: http://paikkatiedot.fi/so/{aineistotunniste}/{theme}/{class}/{paikallinen tunniste}[/{versiotunniste}], esim. http://paikkatiedot.fi/so/123456/hy/standingwater/abc123 Sekä INSPIRE-paikkatietokohteilla että niitä vastaavilla alkuperäisen tietolähteen paikkatietokohteilla on omat /so/-uri:nsa. INSPIRE-paikkatietokohdetta vastaavan alkuperäisen tietolähteen paikkatietokohteen URI on ilman semantiikkaosioita theme ja class. Alkuperäisestä aineistosta johdetulla aineistoilla, kuten INSPIRE-tietotuotteilla, on oma aineistotunniste ja näin ollen myös nimiavaruus. Johdetun aineiston kohteilla voi olla sama paikallinen tunniste kuin alkuperäisessä aineistossa, jos niin katsotaan tarkoituksenmukaiseksi esimerkiksi johdetun aineiston ylläpidon kannalta. Paikkatietokohteen versiotunnistetta käytetään kohteen elinkaarisääntöjen mukaisesti. Versiotunniste ei ole pakollinen. Ellei elinkaarisääntöjä ole määritelty, voi versiotunnisteena olla esimerkiksi kohteen luontipäivämäärä. (esimerkiksi ISO 8601:n mukainen aikaleima: 2014-01-19 T12:38:31+03:00 tai 2014-01- 19). Paikkatietokohteella voi olla useita esitysmuotoja tai sitä voi vastata yksi tai useampi paikkatietokäsite. Nämä liitetään /doc/ -tunnisteeseen. Paikkatietokohteen /so/-tunnisteelle tehdään sitä perustettaessa tähän /doc/-tunnisteeseen (ks. kohta 4 ja suosituksen liite 2). Paikkatietokohteet voidaan helpoimmin linkittää niitä vastaaviin käsitteisiin URI-tunnistetta muodostettaessa. Kohteen linkittämisellä käsitteisiin helpotetaan tiedon löydettävyyttä avoimen tiedon ja Linked data (Yhdistetty tieto) -yhteydessä. INSPIRE-tietotuotteessa paikkatietokohteen HTTP URI -tunniste julkaistaan INSPIRE-tietotuotemäärittelyn vaatimusten mukaisesti. Identifier-elementin lapsielementit määritellään seuraavasti: localid = paikkatietokohteen paikallinen tunniste namespace = paikkatietokohteen HTTP URI -polun alkuosa http://paikkatiedot.fi/so/{aineistotunniste}/{theme}/{class}/ versionid (ei pakollinen) = paikkatietokohteen versiotunniste Yleisesti INSPIREn edellyttämä Identifier-elementti on siis muotoa: 3/6
<base:identifier> <base:localid>{paikallinen tunniste}</base:localid> <base:namespace>http://paikkatiedot.fi/so/{aineistotunniste}/{theme}/{class}/</base:namespace> <base:versionid>[versiotunniste]</base:versionid> </base:identifier> Muille kuin Inspire-aineistoille paikkatietokohteen HTTP URI -tunnisteen julkaisuun suositellaan käytettäväksi OGC:n standardoiman GML-kuvauskielen gml:identifier -elementin. Identifier-elementille pakollisena attribuuttina on codespace, johon sijoitetaan paikkatietokohteen HTTP URI -polun alkuosa http://paikkatiedot.fi/so/{aineistotunniste}/. Paikallinen tunniste ja mahdollinen versiotunniste annetaan gml:identifier -elementin arvoina. Yleisesti gml:identifier -elementti on siis muotoa: <gml:identifier codespace= http://paikkatiedot.fi/so/{aineistotunniste}/ >{paikallinen tunniste}[/{versiotunniste}]</gml:identifier> GML-tietokohteille on myös pakollisena gml:id -attribuutti. Paikallista tunnistetta suositellaan käytettäväksi gml:id -attribuutin arvona niille paikkatietokohteille, joille paikallinen tunniste on tietokantaan luotu (ks. kohta 2). 3.2.2 Reaalimaailman kohteet (id) Paikkatietokohteen kuvaaman reaalimaailman kohteen tai ilmiön tunniste ilmaistaan URI-kaavassa /id/- polkukomponentilla. Reaalimaailman kohteen tunniste toimii informaatiota linkittävänä tunnisteena samaa reaalimaailman kohdetta edustavien paikkatietokohteiden (/so/) välillä ja myös eri verkkotunnusten (domain) tietokohteita ja resursseja siltaavana linkkinä mahdollistaen tiedon laajan käytettävyyden (Linked data). Yleinen URI-kaava reaalimaailman kohteelle on: http://paikkatiedot.fi/id/{aineistotunniste}/{paikallinen tunniste} esim. http://paikkatiedot.fi/id/123456/abc123 INSPIRE-paikkatietokohteesta vastaava viranomainen perustaa tietokohdetta vastaavalle reaalimaailman kohteelle /id/-tunnisteen samalla kun perustaa paikkatietokohteen URI-tunnisteen (/so/).yksikäsitteisyyden varmistamiseksi /id/-uri:ssa käytetään samaa aineistotunnistetta ja paikallista tunnistetta kuin sitä mallintavalla /so/-kohteella. Muille kuin INSPIRE-tietokohteille kaikki toimijat voivat perustaa /id/-tunnisteita, jolloin laajimmin linkitykseen käytetyt /id/-tunnisteet muodostuvat de facto-standardeiksi. Tietojen yhdistelyä (Linked Data) varten samaa reaalimaailman kohdetta tarkoittavat eri toimijoiden /id/-tunnisteet voidaan linkittää käyttäen esimerkiksi owl:sameas- tai skos:exactmatch-linkitystä. Reaalimaailman kohdetta voi vastata yksi tai useampi paikkatietokohde tai -käsite. Nämä liitetään /doc/ - tunnisteeseen. Reaalimaailman kohteen /id/-tunnisteelle tehdään sitä perustettaessa tähän /doc/-tunnisteeseen (ks. kohta 4 ja suosituksen liite 2). 4/6
3.2.3 Paikkatietokäsitteet (def) Paikkatietokäsitteen tunniste ilmaistaan URI-kaavassa /def/ -polkukomponentilla (def = definition). Yleinen URI-kaava paikkatietokäsitteelle on: http://paikkatiedot.fi/def/{aineistotunniste}/{paikallinen tunniste} Käsitelähteenä voi olla mikä tahansa tiedontuottajan käyttämä sanasto, jolle on perustettu URI-muotoinen www-osoite. Sanasto voi olla esimerkiksi asiasanasto, tietomäärittely, skeema, taksonomia tai tesaurus. Käsitelähteenä olevalle sanastolle aineistotunnisteen saa osoitteesta metatieto(at)maanmittauslaitos.fi. Esimerkiksi Paikkatieto-ontologian aineistotunniste on 1001000. Paikkatietokäsitettä voi vastata yksi tai useampi esitysmuoto. Nämä liitetään /doc/ -tunnisteeseen. Paikkatietokäsitteen /def/-tunnisteelle tehdään sitä perustettaessa tähän /doc/-tunnisteeseen (ks. kohta 4 ja suosituksen liite 2). Kansallista Finto-ontologiapalvelua käytetään jakelukanavana palveluun soveltuville käsitteistöille. Lisätietoja: http://finto.fi/fi/. 4 Uudelleenohjausten asettaminen Paikkatietokohteille, reaalimaailman kohteille ja paikkatietokäsitteille suosituksen mukaisesti annetut tunnisteet sijaitsevat paikkatiedot.fi -verkkotunnuksen (domain) alla. Paikkatiedot.fi toimii kansallisena paikkatietojen HTTP URI -tunnisteiden palveluna, joka ohjaa sille tulevat pyynnöt edelleen tiedon tuottajan tarjoamaan palveluun. Tunnisteen antajan tehtävänä on määritellä paikkatiedot.fi -palveluun, mihin osoitteeseen tietyn aineiston kohteisiin kohdistuvat pyynnöt ohjataan. Uudelleenohjauksia hallitaan web-sovelluksella. Alkuvaiheessa kuitenkin tiedontuottajat toimittavat uudelleenohjauksien määrittelyt INSPIRE-sihteeristölle (metatieto@nls.fi), joka vie ne paikkatiedot.fi -palveluun. Tunnisteisiin kohdistuvat uudelleenohjaukset tulisi tehdä tiedon tuottajan tarjoamaan palveluun, josta saatava vastaus on suosituksessa määritellyn vastauskäytänteen mukainen. Suosituksen liitteessä 2 on esimerkki vastauskäytänteen mukaisia vastauksia tarjoavan palvelun teknisestä toteutuksesta. Verkko-osoite, johon paikkatietokohteen, reaalimaailman kohteen tai paikkatietokäsitteen tunnisteeseen tuleva kysely uudelleenohjataan, on yleisesti muotoa: http://{verkkotunnus}/doc/{aineistotunniste}/{paikallinen tunniste}[/{versiotunniste}] Uudelleenohjauksen standardikäytänteet on kuvattu alla. 5/6
Seisova vesi tai vakavesi (Inspire): http://inspire.ec.europa.eu/featureconcept/stan dingwater Seisova vesi tai vakavesi http://paikkatiedot.fi/def/234567/vakavesi Saimaa http://paikkatiedot.fi/def/234567/saimaa http://finto.fi/pto/fi/page/?uri=http://paikkatiedot.fi/def/234567/vakavesi http://finto.fi/pto/fi/page/?uri=http://paikkatiedot.fi/def/234567/saimaa mallinnetaan käsitteinä Reaalimaailman kohde: Saimaa-niminen järvi http://paikkatiedot.fi/id/123456/abc123 Sisävesistä vastaava Inspire-tiedontuottaja: SYKE Muu paikkatiedon tuottaja: Lappeenrannan kaupunki mallinnetaan paikkatietokohteina SYKE perustaa reaalimaailman kohteelle idtunnisteen ja antaa Inspirepaikkatietokohteelleen tätä vastaavan sotunnisteen: http://paikkatiedot.fi/so/123456/hydrography/ StandingWater/abc123 http://www.syke.fi/doc/123456/abc123 Lappeenrannan kaupungilla on aineistossaan Saimaata mallintava paikkatietokohde: http://paikkatiedot.fi/so/345678/qwe456 http://www.lpr.fi/doc/345678/qwe456 6/6