URI:n muodostamisen prosessi (suositusluonnoksen liite 1) Keskustelutilaisuus JHS-suositusluonnoksesta Paikkatiedon yksilöivät tunnisteet Kai Koistinen 19.11.2014
Liite 1. URI:n muodostamisen prosessi Sisällys 1.Johdanto 2.Paikallisen tunnisteen 3. en varaaminen Paikkatietokohteet (so) Reaalimaailman kohteet (id) Paikkatietokäsitteet (def) 4.
2. Paikallisen tunnisteen Tietokantaan perustetaan kenttä paikallista tunnistetta (localid) varten Paikallisena tunnisteena voidaan soveltaa järjestelmien sisäisiä tunnisteita tai muita vakiintuneita tunnisteita Ellei paikallista tunnistejärjestelmää ole olemassa, voidaan käyttää esim. UUID (Universally Unique Identifier) - tunnistejärjestelmää Paikallisen tunnisteen
2. Paikallisen tunnisteen Paikallisille tunnisteille laaditaan elinkaarisäännöt Suositusluonnoksen liite 3: Elinkaarisääntöjen muodostaminen Paikallisen tunnisteen
3. Yksilöivät HTTP URI tunnisteet ovat muotoa: http://paikkatiedot.fi/{type}/{aineistotunniste}/{paikallinen tunniste}, jossa type = yksilöitävän paikkatietokohteille so reaalimaailman kohteille id paikkatietokäsitteille def aineistotunniste = Paikkatietohakemiston aineistotunniste paikallinen tunniste = perustettu yksilöivä paikallinen tunniste (localid) Paikallisen tunnisteen
3. Paikallisen tunnisteen
3.1. en varaaminen Kuvataan aineisto Paikkatietohakemistoon Ohjeistusta Paikkatietoikkunassa ja JHS 158 Paikkatiedon metatiedot Paikkatietohakemiston aineistotunnisteen, joka on osana yksilöivän HTTP URI tunnisteen nimiavaruutta, saa osoitteesta metatieto@maanmittauslaitos.fi Paikallisen tunnisteen
3.2. : Paikkatietokohteet (so) 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 Paikallisen tunnisteen
3.2. : Paikkatietokohteet (so) INSPIRE-tietotuotteiden HTTP-URI tunnisteet julkaistaan tietotuotemäärittelyiden mukaisesti Identifier-elementtinä: <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 gml:identifier elementtiä: <gml:identifier codespace= http://paikkatiedot.fi/so/{aineistotunniste}/ > {paikallinen tunniste}[/{versiotunniste}] </gml:identifier> Paikallisen tunnisteen
3.2. : Reaalimaailman kohteet (id) Yleinen URI-kaava reaalimaailman kohteelle on http://paikkatiedot.fi/id/{aineistotunniste}/{paikallinen tunniste} Esim: http://paikkatiedot.fi/id/123456/abc123 Paikallisen tunnisteen
3.2. : Reaalimaailman kohteet (id) INSPIRE-paikkatietokohteesta vastaava viranomainen perustaa paikkatietokohdetta (so) vastaavalle reaalimaailman kohteelle tunnisteen (id) Reaalimaailman kohteen tunnisteessa käytetään samaa aineistotunnistetta ja paikallista tunnistetta kuin sitä vastaavan paikkatietokohteen tunnisteessa Muille kuin INSPIRE-tietokohteille kaikki toimijat voivat perustaa id-tunnisteita, jolloin laajimmin linkitykseen käytetyt tunnisteet muodostuvat de facto -standardeiksi Paikallisen tunnisteen
3.2. : Paikkatietokäsitteet (def) Yleinen URI-kaava paikkatietokäsitteelle on http://paikkatiedot.fi/def/{aineistotunniste}/{paikallinen tunniste} Esim: http://paikkatiedot.fi/def/1001000/vakavesi Paikallisen tunnisteen
3.2. : Paikkatietokäsitteet (def) Käsitelähteenä voi olla mikä tahansa tiedontuottajan käyttämä sanasto en sanastolle saa osoitteesta metatieto@maanmittauslaitos.fi Kansallista Finto-ontologiapalvelua käytetään jakelukanavana ontologian muodossa esitetyille käsitteistöille Paikallisen tunnisteen
4. Paikkatiedot.fi toimii kansallisena paikkatietojen HTTP URI tunnisteiden uudelleenohjauspalveluna ohjaa pyynnöt 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 tiedontuottajat toimittavat uudelleenohjauksien määrittelyt INSPIRE-sihteeristölle osoitteeseen metatieto@nls.fi Paikallisen tunnisteen
4. Verkko-osoite, johon paikkatietokohteen, reaalimaailman kohteen tai paikkatietokäsitteen tunnisteeseen kohdistuva kysely uudelleenohjataan, on yleisesti muotoa: http://{verkkotunnus}/doc/{aineistotunniste}/{paikallinen tunniste}[/{versiotunniste}] Paikallisen tunnisteen
4. Paikallisen tunnisteen
4. Palvelun, johon paikkatiedot.fi uudelleenohjaa pyynnöt, tulisi antaa vastaus RDF/XML muodossa (suositusluonnoksen liite 2) Paikallisen tunnisteen
Luokka Ominaisuus Ominaisuuden arvoalue jhs:doc jhs:data jhs:so jhs:id RDF-skeema Paikkatietokohteen tunniste Reaalimaailman kohteen tunniste Toistuvuus Kuvaus Resurssiin liittyvä dokumentaatio 0..1 Jos kuvailun kohteena on paikkatietokohde, viittaus paikkatietokohteeseen, jota kuvaus koskee 0..1 Viittaus reaalimaailman kohteeseen, jota kuvailtava paikkatietokohde mallintaa. dc:hasformat jhs:data 1..n Resurssista saatavilla olevat esitysmuodot dc:subject Käsitteen tunniste 0..n Viittaus resurssia kuvailevaan käsitteeseen rdfs:seealso Kohteeseen tai käsitteeseen liittyvää lisäinformaatiota 0..n Viittaus esimerkiksi samaa reaalimaailman kohdetta mallintavaan paikkatietokohteeseen jhs:so jhs:def Paikkatietokohteen tunniste Paikkatietokäsitteen tunniste Resurssin esitysmuoto jhs:crs Esitysmuodon koordinaattijärjestelmä 0..1 Esitysmuodon koordinaattijärjestelmän EPSG-koodi (vain paikkatietokohteille) dc:format Esitysmuodon formaatti 1 Esitysmuodon MIMEtyyppi 0..1 Viittaus esitettävään paikkatietokohteeseen 0..1 Viittaus esitettävään paikkatietokäsitteeseen Tiedontuottaja voi vapaasti lisätä edellä määriteltyyn RDF-rakenteeseen omia elementtejään. Näitä voivat olla esimerkiksi erityyppiset linkitykset muihin tietokohteisiin.
<rdf:rdf xmlns:jhs="http://paikkatiedot.fi/jhs-skeema#" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"> RDF-skeema <jhs:doc rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447"> <jhs:data rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447/epsg:3067.json"> <jhs:data rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447/epsg:3067.gml2"> <jhs:data rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447/epsg:3878.json"> <jhs:data rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447/epsg:3878.gml2"> <dc:subject rdf:resource="http://www.yso.fi/onto/yso/p17892"/> <rdfs:seealso rdf:resource="http://paikkatiedot.fi/so/1000040/172353"/> <jhs:id rdf:resource="http://paikkatiedot.fi/id/1000040/172353"/> <jhs:so rdf:resource="http://paikkatiedot.fi/so/1000358/6447"/> </jhs:doc> </rdf:rdf>
<rdf:rdf xmlns:jhs="http://paikkatiedot.fi/jhs-skeema#" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"> <jhs:doc rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447"> Tämän dokumentin URL-osoite, eli osoite johon paikkatiedot.fi -palvelu uudelleenohjaa <jhs:data rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447/epsg:3067.json"> <jhs:data rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447/epsg:3067.gml2"> <jhs:data rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447/epsg:3878.json"> <jhs:data rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447/epsg:3878.gml2"> <dc:subject rdf:resource="http://www.yso.fi/onto/yso/p17892"/> <rdfs:seealso rdf:resource="http://paikkatiedot.fi/so/1000040/172353"/> <jhs:id rdf:resource="http://paikkatiedot.fi/id/1000040/172353"/> <jhs:so rdf:resource="http://paikkatiedot.fi/so/1000358/6447"/> </jhs:doc> </rdf:rdf> RDF-skeema
<rdf:rdf xmlns:jhs="http://paikkatiedot.fi/jhs-skeema#" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"> RDF-skeema <jhs:doc rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447"> <jhs:data rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447/epsg:3067.json"> <jhs:data rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447/epsg:3067.gml2"> <jhs:data rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447/epsg:3878.json"> <jhs:data rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447/epsg:3878.gml2"> <dc:subject rdf:resource="http://www.yso.fi/onto/yso/p17892"/> <rdfs:seealso rdf:resource="http://paikkatiedot.fi/so/1000040/172353"/> <jhs:id rdf:resource="http://paikkatiedot.fi/id/1000040/172353"/> <jhs:so rdf:resource="http://paikkatiedot.fi/so/1000358/6447"/> </jhs:doc> Paikkatietokohteen esitysmuodot </rdf:rdf>
<rdf:rdf xmlns:jhs="http://paikkatiedot.fi/jhs-skeema#" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"> RDF-skeema <jhs:doc rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447"> <jhs:data rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447/epsg:3067.json"> <jhs:data rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447/epsg:3067.gml2"> <jhs:data rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447/epsg:3878.json"> <jhs:data rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447/epsg:3878.gml2"> <dc:subject rdf:resource="http://www.yso.fi/onto/yso/p17892"/> Linkki kohdetta kuvailevaan käsitteeseen <rdfs:seealso rdf:resource="http://paikkatiedot.fi/so/1000040/172353"/> <jhs:id rdf:resource="http://paikkatiedot.fi/id/1000040/172353"/> <jhs:so rdf:resource="http://paikkatiedot.fi/so/1000358/6447"/> </jhs:doc> </rdf:rdf>
<rdf:rdf xmlns:jhs="http://paikkatiedot.fi/jhs-skeema#" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"> RDF-skeema <jhs:doc rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447"> <jhs:data rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447/epsg:3067.json"> <jhs:data rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447/epsg:3067.gml2"> <jhs:data rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447/epsg:3878.json"> <jhs:data rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447/epsg:3878.gml2"> </jhs:doc> </rdf:rdf> <dc:subject rdf:resource="http://www.yso.fi/onto/yso/p17892"/> <rdfs:seealso rdf:resource="http://paikkatiedot.fi/so/1000040/172353"/> <jhs:id rdf:resource="http://paikkatiedot.fi/id/1000040/172353"/> <jhs:so rdf:resource="http://paikkatiedot.fi/so/1000358/6447"/> Linkki muuhun kohteeseen liittyvään dokumentaatioon, tässä tapauksessa toiseen paikkatietokohteeseen
<rdf:rdf xmlns:jhs="http://paikkatiedot.fi/jhs-skeema#" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"> RDF-skeema <jhs:doc rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447"> <jhs:data rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447/epsg:3067.json"> <jhs:data rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447/epsg:3067.gml2"> <jhs:data rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447/epsg:3878.json"> <jhs:data rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447/epsg:3878.gml2"> <dc:subject rdf:resource="http://www.yso.fi/onto/yso/p17892"/> <rdfs:seealso rdf:resource="http://paikkatiedot.fi/so/1000040/172353"/> <jhs:id rdf:resource="http://paikkatiedot.fi/id/1000040/172353"/> Kohdetta vastaavan reaalimaailman kohteen tunniste <jhs:so rdf:resource="http://paikkatiedot.fi/so/1000358/6447"/> </jhs:doc> </rdf:rdf>
<rdf:rdf xmlns:jhs="http://paikkatiedot.fi/jhs-skeema#" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"> RDF-skeema <jhs:doc rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447"> <jhs:data rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447/epsg:3067.json"> <jhs:data rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447/epsg:3067.gml2"> <jhs:data rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447/epsg:3878.json"> <jhs:data rdf:about="http://kartat.tampere.fi/uri/doc/1000358/6447/epsg:3878.gml2"> <dc:subject rdf:resource="http://www.yso.fi/onto/yso/p17892"/> <rdfs:seealso rdf:resource="http://paikkatiedot.fi/so/1000040/172353"/> <jhs:id rdf:resource="http://paikkatiedot.fi/id/1000040/172353"/> <jhs:so rdf:resource="http://paikkatiedot.fi/so/1000358/6447"/> Tämän paikkatietokohteen tunniste </jhs:doc> </rdf:rdf>
Kiitos!