JHS XXX Paikkatiedon yksilöivät tunnisteet Liite 2: Esimerkki tiedontuottajan URI-palvelun teknisestä toteutuksesta

Transkriptio

1 JHS XXX Paikkatiedon yksilöivät tunnisteet Liite 2: Esimerkki tiedontuottajan URI-palvelun teknisestä toteutuksesta Versio: Julkaistu: Voimassaoloaika: Sisällys 1 Johdanto Tiedontuottajan URI-palvelun toimintaperiaate ja vastauskäytänteet Tekniset vaatimukset Tiedontuottajan URI-palvelun toteutusvaiheet Tiedontuottajan URI-palvelun palauttaman RDF-tiedon rakennekuvaus Esimerkkitiedostot XSLT-muunnostiedosto SPARQL-kysely RDF-esimerkki Apache.htaccess -tiedosto Johdanto Paikkatietokohteille, reaalimaailman kohteille ja paikkatietokäsitteille suosituksen mukaisesti annetut tunnisteet sijaitsevat paikkatiedot.fi -verkkotunnuksen (domain) alla. Paikkatiedot.fi toimii kansallisena paikkatietojen HTTP URI -tunnisteiden uudelleenohjauspalveluna, joka ohjaa sille tulevat pyynnöt edelleen tiedon tuottajan tarjoamaan palveluun. Tunnisteisiin kohdistuvat uudelleenohjaukset tulisi tehdä tiedon tuottajan tarjoamaan palveluun, josta saatava vastaus on suosituksessa määritellyn vastauskäytänteen mukainen. Verkko-osoite, johon paikkatietokohteen, reaalimaailman kohteen tai paikkatietokäsitteen tunnisteeseen tuleva kysely uudelleenohjataan, on yleisesti muotoa tunniste}[/{versiotunniste}] Tässä liitteessä kuvataan esimerkki suosituksessa määriteltyjen vastauskäytänteiden mukaisen vastauksen antavan tiedontuottajan URI-palvelun teknisestä toteutuksesta. Toteutuksessa käytetyt tekniset ratkaisut ovat vain esimerkkejä. Vastauskäytänteiden mukaisen vastauksen tuottava palvelu on mahdollista toteuttaa monilla muillakin tavoilla. 1/8

2 2 Tiedontuottajan URI-palvelun toimintaperiaate ja vastauskäytänteet Esimerkki teknisestä toteutuksesta paikkatiedot.fi URI Paikkatietohakemisto FIN6789 Inspire-tiedontuottaja Paikkatiedot.fi -uudelleenohjauspalvelu ohjaa paikkatietokohteen, reaalimaailman kohteen tai paikkatietokäsitteen tunnisteeseen kohdistuvat pyynnöt tiedontuottajan URI-palveluun. Tiedontuottajan URIpalvelu palauttaa /doc/ -polkukomponentin sisältäville tunnisteille tunnisteen yksilöimään paikkatietokohteeseen, reaalimaailman kohteeseen tai paikkatietokäsitteeseen liittyvän dokumentaation RDF/XML-muotoisena. RDF/XML-muotoinen paikkatietokohteen, reaalimaailman kohteen tai paikkatietokäsitteen kuvaus sisältää paikkatietokohteen /so/-linkin tai paikkatietokäsitteen /def/ -linkin paikkatietokohteen tai -käsitteen esitysmuodot (GML, JSON jne.), sekä mahdollisuuksien mukaan - paikkatietokohdetta vastaavan reaalimaailman kohteen /id/-linkin - linkin paikkatietokohdetta kuvaavaan käsitteeseen - linkkejä paikkatietokohteeseen liittyviin muihin /so/-kohteisiin (sama paikkatietokohde voi olla mallinnettu eri tavoin eri tietotuotteissa) - linkkejä muuhun paikkatietokohteeseen liittyvään dokumentaatioon (kuvat, tekstit jne.) Jos tiedontuottajan URI-palvelulle lähetetään pyyntö ilman paikallista tunnistetta, vastauksena annetaan ATOM-syöte po. tiedostopalveluun (JHS 180, liite 3). Tiedontuottajan URI-palvelu uudelleenohjaa paikkatietokohteiden esitysmuotojen tunnistekyselyt Web Feature Service -palvelulle, joka palauttaa kohteen tiedot halutussa koordinaatistossa ja formaatissa. Paikkatietokohteen eri esitysmuodot esitetään tässä esimerkissä muodossa: tunniste}/{koordinaattijärjestelmä}.{formaatti} esim. tunniste}/epsg:3087.gml2 2/8

3 Tiedontuottajan URI-palvelun palauttaman RDF -tiedon tarkempi rakennekuvaus on esitelty luvussa 5. Luvussa 6.3 esitellään esimerkki tämän rakennekuvauksen mukaisesta RDF-tiedosta. 3 Tekniset vaatimukset Tämän esimerkin URI-palvelun toteuttamiseen on käytetty seuraavia teknologioita: Apache HTTP -palvelin Apache Jena Fuseki RDF -palvelin Apache HTTP- ja Apache Jena Fuseki -palvelimien käyttöönottoa ei tässä liitteessä ohjeisteta, vaan nämä on esitetty tuotteiden omilla verkkosivustoilla. 4 Tiedontuottajan URI-palvelun toteutusvaiheet Alla olevassa listassa on esitetty tiedontuottajan URI-palvelun toteutus vaiheittain. Kaikki toteutuksessa käytetyt tiedostot on esitetty luvussa Luodaan paikkatietokohteisiin liittyvän dokumentaation sisältävä, luvussa 5 esitetyn RDF-skeeman mukainen, SPARQL update -lause. Lause voidaan muodostaa WFS:n GetFeature kohdetietokyselyn palauttamasta GML-dokumentista XSLT-muunnoksella. Muunnoksen määrittelyyn ja suorittamiseen on olemassa hyviä valmiita sovelluksia verkossa. Esimerkkitoteutuksessa käytettävä XSLTmuunnostiedosto on esitetty luvussa Ladataan paikkatietokohteisiin liittyvä dokumentaatio kohdassa 1 muodostetulla SPARQL update - lauseella Apache Jena Fusekin RDF-tietokantaan. 3. Tehdään SPARQL-kysely Apache Jena Fuseki tietokantaan luvun 6.2 mukaisesti. Kysely palauttaa luvussa 5 määritellyn RDF -skeeman mukaiset tiedot, joista esimerkki luvussa Luodaan.htaccess -tiedosto Apache HTTP -palvelimelle, joka näkyy verkkoon. Luvussa 6.4 on esitetty esimerkki Apache.htaccess-uudelleenohjaustiedostosta selitettynä. Huom! Tämä on tietyssä ympäristössä tehty esimerkkitoteutus. Näiden vaiheiden lisäksi voidaan joutua tekemään useita teknisiä konfigurointeja riippuen olemassa olevasta palvelinympäristöstä ja verkkoinfrastruktuurista. 5 Tiedontuottajan URI-palvelun palauttaman RDF-tiedon rakennekuvaus Alla olevassa taulukossa on esitetty URI-palvelun palauttaman RDF-muotoisen tiedon rakennekuvaus. Esimerkki kuvauksen mukaisesta RDF-vastauksesta on esitetty luvussa 6.3. Luokka Ominaisuus Ominaisuuden arvoalue Toistuvuus Kuvaus jhs:doc Resurssiin liittyvä dokumentaatio jhs:so Paikkatietokohteen tunniste 0..1 Jos kuvailun kohteena on paikkatietokohde, viittaus paikkatietokohteeseen, jota kuvaus koskee jhs:id Reaalimaailman kohteen tunniste 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 3/8

4 jhs:data jhs:crs Esitysmuodon koordinaattijärjestelmä paikkatietokohteeseen Resurssin esitysmuoto 0..1 Esitysmuodon koordinaattijärjestelmän EPSGkoodi (vain paikkatietokohteille) dc:format Esitysmuodon formaatti 1 Esitysmuodon MIME-tyyppi jhs:so Paikkatietokohteen tunniste 0..1 Viittaus esitettävään paikkatietokohteeseen jhs:def Paikkatietokäsitteen tunniste 0..1 Viittaus esitettävään paikkatietokäsitteeseen Taulukko 1. Tiedontuottajan URI-palvelun palauttaman RDF-tiedon rakennekuvaus. jhs: dc: Tiedontuottaja voi vapaasti lisätä edellä määriteltyyn RDF-rakenteeseen omia elementtejään. Näitä voivat olla esimerkiksi erityyppiset linkitykset muihin tietokohteisiin. 6 Esimerkkitiedostot 6.1 XSLT-muunnostiedosto <?xml version="1.0" encoding="utf-8"?> <xsl:stylesheet version="1.0" xmlns:xsl=" xmlns:fo=" xmlns:tampere_ora=" xmlns:gml=" > <xsl:output method="text" indent="yes"/> <xsl:template match="/"> PREFIX rdf: < PREFIX rdfs: < PREFIX dc: < PREFIX jhs: < <!-- Muodostetaan SPARQL INSERT -lause. INSERT-lauseessa RDF-kolmikot esitetään Turtle-formaatissa. --> INSERT DATA { <xsl:for-each select="//tampere_ora: _wb"> <!-- Paikkatietokohteeseen liittyvä dokumentaatio --> < select="tampere_ora:tunniste"/>> rdf:type jhs:doc; jhs:id < select="tampere_ora:digiroad_id"/>>; rdfs:seealso < 4/8

5 select="tampere_ora:digiroad_id"/>>; dc:hasformat < select="tampere_ora:tunniste"/>/epsg:3067.json>; dc:hasformat < select="tampere_ora:tunniste"/>/epsg:3067.gml2>; dc:hasformat < select="tampere_ora:tunniste"/>/epsg:3878.json>; dc:hasformat < select="tampere_ora:tunniste"/>/epsg:3878.gml2>; dc:subject < <!-- Paikkatietokohteen esitysmuodot --> < select="tampere_ora:tunniste"/>/epsg:3067.json> rdf:type jhs:data; jhs:crs < dc:format "application/json". < select="tampere_ora:tunniste"/>/epsg:3067.gml2> rdf:type jhs:data; jhs:crs < dc:format "application/gml". < select="tampere_ora:tunniste"/>/epsg:3878.json> rdf:type jhs:data; jhs:crs < dc:format "application/json". < select="tampere_ora:tunniste"/>/epsg:3878.gml2> rdf:type jhs:data; jhs:crs < dc:format "application/gml". </xsl:for-each> } </xsl:template> </xsl:stylesheet> 6.2 SPARQL-kysely PREFIX rdf: PREFIX rdfs: PREFIX dc: PREFIX jhs: < CONSTRUCT { 5/8

6 < jhs:so?so; rdf:type?a; jhs:id?h; rdfs:seealso?g; dc:subject?b; dc:hasformat?c.?c jhs:crs?d.?c dc:format?e.?c rdf:type?f } WHERE { < jhs:so?so; rdf:type?a; jhs:id?h; rdfs:seealso?g; dc:subject?b; dc:hasformat?c.?c jhs:crs?d.?c dc:format?e.?c rdf:type?f } 6.3 RDF-esimerkki <rdf:rdf xmlns:jhs=" xmlns:rdf=" xmlns:dc=" xmlns:rdfs=" <jhs:doc rdf:about=" <dc:hasformat> <jhs:data rdf:about=" <dc:format>application/json</dc:format> <jhs:crs rdf:resource=" </jhs:data> </dc:hasformat> <dc:hasformat> <jhs:data rdf:about=" <dc:format>application/gml</dc:format> <jhs:crs rdf:resource=" </jhs:data> </dc:hasformat> <dc:hasformat> <jhs:data rdf:about=" <dc:format>application/json</dc:format> <jhs:crs rdf:resource=" </jhs:data> </dc:hasformat> <dc:hasformat> <jhs:data rdf:about=" <dc:format>application/gml</dc:format> <jhs:crs rdf:resource=" </jhs:data> </dc:hasformat> 6/8

7 <dc:subject rdf:resource=" <rdfs:seealso rdf:resource=" <jhs:id rdf:resource=" <jhs:so rdf:resource=" </jhs:doc> </rdf:rdf> 6.4 Apache.htaccess -tiedosto <IfModule mod_rewrite.c> RewriteEngine On Rewritebase /uri/ # RewriteRule uudelleen ohjaa doc-polkukomponentin muuttujat ([a-za-z0-9]+)/([a-za-z0-9:]+).([a-za-z0-9]+) wfs-kohdekyselyyn $1,$2,$3. Huomaa, että RewriteRule tulee olla yhdellä rivillä, ei niin kuin alla esitetty. RewriteRule ^doc/ /([a-za-z0-9_]+)/([a-za-z0-9:]+).([a-za-z0-9]+)$ GetFeature&typeName=tampere_ora:BUSSIPYSAKIT_WB&outputformat=$3&srsName=$2&Filter=<Filte r><propertyisequalto><propertyname>tunniste</propertyname><literal>$1</literal></propertyiseq ualto></filter> RewriteRule ^doc/ /([a-za-z0-9_]+)/([a-za-z0-9:]+).([a-za-z0-9]+)$ GetFeature&typeName=tampere_ora:BUSSILINJAT&outputformat=$3&srsName=$2&Filter=<Filter><Pro pertyisequalto><propertyname>reitti</propertyname><literal>$1</literal></propertyisequalto></fi lter> RewriteRule ^doc/ /([a-za-z0-9_-]+)/([a-za-z0-9:]+).([a-za-z0-9]+)$ GetFeature&typeName=rakennukset:RAKENN_ST_FA_MVIEW&outputformat=$3&srsName=$2&Filter= <Filter><PropertyIsEqualTo><PropertyName>RAK_TUNNUS_FACTA</PropertyName><Literal>$1</Lit eral></propertyisequalto></filter> RewriteRule ^doc/ /([a-za-z0-9_-]+)/([a-za-z0-9:]+).([a-za-z0-9]+)$ aliikenne_avoin:bussipysakit&srsname=$2&filter=<filter><propertyislike+wildcard="*"+singlechar="," +escapechar="."><propertyname>stop_id</propertyname><literal>$1</literal></propertyislike></fil ter>&outputformat=$3 #RewriteRule uudelleen ohjaa doc-polkukomponentin muuttujan ([a-za-z0-9]+) SPARQL-kyselyyn $1. Huomaa, että RewriteRule tulee olla yhdellä rivillä, ei niin kuin alla esitetty. RewriteRule ^doc/ /([a-za-z0-9_-]+)$ rdfs:seealso+?g;dc:subject+?a;dc:hasformat+?b.?b+jhs:crs+?c.?b+dc:format+?d.?b+rdf:type+?e}+wher E{< ct+?a;dc:hasformat+?b.?b+jhs:crs+?c.?b+dc:format+?d.?b+rdf:type+?e}+&output=xml RewriteRule ^doc/ /([a-za-z0-9_-]+)/$ 7/8

8 rdfs:seealso+?g;dc:subject+?a;dc:hasformat+?b.?b+jhs:crs+?c.?b+dc:format+?d.?b+rdf:type+?e}+wher E{< ct+?a;dc:hasformat+?b.?b+jhs:crs+?c.?b+dc:format+?d.?b+rdf:type+?e}+&output=xml RewriteRule ^doc/ /([a-za-z0-9_-]+)$ rdfs:seealso+?g;dc:subject+?a;dc:hasformat+?b.?b+jhs:crs+?c.?b+dc:format+?d.?b+rdf:type+?e}+wher E{< ct+?a;dc:hasformat+?b.?b+jhs:crs+?c.?b+dc:format+?d.?b+rdf:type+?e}+&output=xml RewriteRule ^doc/ /([a-za-z0-9_-]+)/$ rdfs:seealso+?g;dc:subject+?a;dc:hasformat+?b.?b+jhs:crs+?c.?b+dc:format+?d.?b+rdf:type+?e}+wher E{< ct+?a;dc:hasformat+?b.?b+jhs:crs+?c.?b+dc:format+?d.?b+rdf:type+?e}+&output=xml </IfModule> 8/8