Umístění

Abstrakt

Tento dokument je sdílenou specifikací pro umístění pro použití v otevřeých formálních normách ve smyslu § 3a odst. 3 zákona č. 106/1999 Sb., o svobodném přístupu k informacím. Specifikace obsahuje schémata a je ilustrována příklady dat ve formátech JSON-LD [[json-ld11]] a tedy i JSON [[ECMA-404]], XML [[xml]] a CSV [[rfc4180]].

Specifikace

V této sekci jsou definovány jednotlivé položky, které lze použít k určení umístění v poskytovaných datech. Umístění může být specifikováno jako adresa, globálně identifikovaný objekt a nebo jako geometrický útvar. Všechny třídy, které nejsou specifikovány jinou otevřenou formální normou nebo číselníkem, dědí vlastnosti a vazby třídy Věc.

Tato otevřená formální norma strukturuje umístění v souladu s ISA² Core Location Vocabulary.

Umístění

Umístění může být specifikováno jako adresa, globálně identifikovaný objekt a nebo jako geometrický útvar. Příkladem umístění může být louka, na které se koná festival, adresa sídla společnosti, či prodaná parcela na Měsíci. Tato třída odpovídá třídě Location z ISA² Core Location Vocabulary a Dublin Core Metadata Initiative. Kromě níže specifikovaných vlastností a vazeb je možné u této třídy použít také vlastnosti a vazby třídy Věc, která je specifikována otevřenou formální normou Věc.

Geografický identifikátor

Vlastnost: iri
Typ: IRI
Jméno: Geografický identifikátor
Popis: Geografický identifikátor objektu. Použije se tam, kde existuje IRI pro dané místo, například z databáze Geonames, Wikidata, DBpedia nebo z evropských číselníků míst, zemí či kontinentů. Tato vlastnost odpovídá vlastnosti geographic identifier z ISA² Core Location Vocabulary a slovníku RDF Schema [[rdf-schema]].
Příklad: http://publications.europa.eu/resource/authority/continent/ANTARCTICA

Geografický název

Vlastnost: název
Typ: Text
Jméno: Geografický název
Popis: Geografický název objektu. Tato vlastnost odpovídá vlastnosti geographicName z ISA² Core Location Vocabulary.
Příklad: Krušné hory

Popis umístění

Vlastnost: popis
Typ: Text
Jméno: Popis umístění
Popis: Popis umístění objektu. Popis lze použít jako upřesňující text k jiným formám umístění. Pokud nelze k umístění objektu použít identifikátor, adresní místo, geometrii, ani název, lze pomocí popisu umístění popsat slovně.
Příklad: U východu ze stanice metra A Můstek do vestibulu v půli Václavského náměstí

Geometrie

Vlastnost: geometrie
Typ: Geometrický objekt
Jméno: Geometrie
Popis: Geometrický objekt specifikující umístění. Použije se tam, kde umístění nelze specifikovat adresou či identifikátorem.
Příklad: { "type": "Point", "coordinates": [15.9915114, 48.8566829] }

Budova

Vlastnost: budova
Typ: Text
Jméno: Budova
Popis: Označení budovy jejím názvem, číslem apod.
Příklad: HD Gate

Patro

Vlastnost: patro
Typ: Text
Jméno: Patro
Popis: Číslo patra nebo jiné označení patra.
Příklad: 4.patro

Místnost

Vlastnost: místnost
Typ: Text
Jméno: Místnost
Popis: Číslo místnosti nebo jiné označení místnosti.
Příklad: Místnost 4001

Zahraniční adresa - text

Vlastnost: zahraniční_adresa_text
Typ: Text
Jméno: Zahraniční adresa - text
Popis: Zahraniční adresa textem. Adresy v zahraničí se řídí místními pravidly.
Příklad: České centrum Velvyslanectví České republiky v Londýně 30 Kensington Palace Gardens Londýn W8 4QY

Vazba: Adresa

Vlastnost: adresa
Typ: Adresa
Jméno: Adresa
Popis: Použije se tam, kde je dostatečné označit umístění pomocí adresního místa či jiných územních prvků z RÚIAN.

Příklady

V této sekci jsou uvedeny příklady reprezentace umístění v různých formátech a v různých úrovních detailu. Datová schémata, která jsou použita v příkladech, lze přímo použít a zahrnout do publikačních plánů, případně rozšířit dle vlastních potřeb. Pro formáty JSON [[!ECMA-404]] a XML [[!xml]] jsou k dispozici příslušná schémata, tedy Schéma pro formát JSON v jazyce JSON Schema [[json-schema]] a Schéma pro formát XML v jazyce XML Schema [[xmlschema11-1]]. Pro formát JSON-LD [[!json-ld11]] je k dispozici kontext. Lze také použít zápis v CSV. Soubor v CSV [[!rfc4180]] je nutné doplnit schématem dle specifikace CSV on the Web [[tabular-data-primer]].

Pokud je umístění použito v rámci jiného datového standardu, tak se jména sloupců v CSV tabulce tvoří názvy atributů. Zanořování je řešeno spojením názvu entity z jiného standardu, například lokace, a z názvu atributu adresy jejich spojením pomocí znaku podtržítka _, například lokace_geometrie.

Specifikace umístění identifikátorem

Jedná se o nejčistší způsob určení umístění pomocí IRI příslušného geografického objektu.

JSON-LD soubor, JSON schéma, JSON-LD kontext

{
    "@context": "https://ofn.gov.cz/umístění/2020-07-01/kontexty/umístění.jsonld",
    "typ": "Umístění",
    "iri": "http://publications.europa.eu/resource/authority/continent/ANTARCTICA"
}

XML soubor, XML soubor schéma

<?xml version="1.0" encoding="UTF-8" ?>
<umístění
    xmlns="https://ofn.gov.cz/umístění/2020-07-01"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:věc="https://ofn.gov.cz/věc/2020-07-01"
    xsi:schemaLocation="https://ofn.gov.cz/umístění/2020-07-01 
                        https://ofn.gov.cz/umístění/2020-07-01/schémata/umístění.xsd">
    <věc:iri>http://publications.europa.eu/resource/authority/continent/ANTARCTICA</věc:iri>
</umístění>

CSV soubor

iri
http://publications.europa.eu/resource/authority/continent/ANTARCTICA

K souboru CSV je třeba připojit metadata dle standardu CSV on the Web [[tabular-data-primer]]. Například pokud se CSV soubor jmenuje 0.csv, je s ním publikován i metadatový soubor 0.csv-metadata.json:

Deskriptor

{
    "@id": "https://ofn.gov.cz/umístění/2020-07-01/příklady/0.csv-metadata.json",
    "@context": [
        "http://www.w3.org/ns/csvw",
        {"@language": "cs"}
    ],
    "@type": "Table",
    "url": "0.csv",
    "tableSchema": {
        "@type": "Schema",
        "aboutUrl": "{+iri}",
        "columns": [
            {
                "@type": "Column",
                "titles": "iri",
                "propertyUrl": "rdf:type",
                "valueUrl": "http://purl.org/dc/terms/Location",
                "dc:description": "Geografický identifikátor",
                "datatype": "anyURI",
                "required": true
            }
        ]
    }
}

Specifikace umístění názvem či geometrií

Pokud je třeba specifikovat umístění názvem nebo geometrií, lze to provést tak jako v následujících příkladech.

JSON-LD soubor, JSON schéma, JSON-LD kontext

{
    "@context": "https://ofn.gov.cz/umístění/2020-07-01/kontexty/umístění.jsonld",
    "typ": "Umístění",
    "název": {
        "cs": "Národní park Šumava"
    },
    "geometrie": {
        "type": "Point",
        "coordinates": [13.6309462, 48.9720309]
    }
}

XML soubor, XML soubor schéma

<?xml version="1.0" encoding="UTF-8" ?>
<umístění
    xmlns="https://ofn.gov.cz/umístění/2020-07-01"
    xmlns:xml="http://www.w3.org/XML/1998/namespace"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:věc="https://ofn.gov.cz/věc/2020-07-01"
    xsi:schemaLocation="https://ofn.gov.cz/umístění/2020-07-01 
                        https://ofn.gov.cz/um%C3%ADst%C4%9Bn%C3%AD/2020-07-01/sch%C3%A9mata/um%C3%ADst%C4%9Bn%C3%AD.xsd">
    <věc:název xml:lang="cs">Národní park Šumava</věc:název>
    <geometrie>POINT(48.9720274 13.6309462)</geometrie>
</umístění>

CSV soubor

název_cs,geometrie
Národní park Šumava,POINT(48.9720274 13.6309462)

K souboru CSV je opět potřeba připojit metadatový popsiek dle standardu CSV on the Web [[!tabular-data-primer]]:

Deskriptor

{
    "@id": "https://ofn.gov.cz/umístění/2020-07-01/příklady/1.csv-metadata.json",
    "@context": [
        "http://www.w3.org/ns/csvw",
        {"@language": "cs"}
    ],
    "@type": "Table",
    "url": "1.csv",
    "tableSchema": {
        "@type": "Schema",
        "columns": [
            {
                "@type": "Column",
                "name": "nazev_cs",
                "titles": "název_cs",
                "propertyUrl": "http://www.w3.org/ns/locn#geographicName",
                "dc:description": "Geografický název",
                "datatype": "string",
                "lang": "cs"
            }, {
                "@type": "Column",
                "titles": "geometrie",
                "propertyUrl": "http://www.w3.org/ns/locn#geometry",
                "dc:description": "Geometrie",
                "datatype": "string"
            }, {
                "virtual": true,
                "propertyUrl": "rdf:type",
                "valueUrl": "http://purl.org/dc/terms/Location"
            }
        ]
    }
}

Umístění formou adresy

Umístění může být specifikováno adresou. Oproti přímému použití adresy bez mezikroku v podobě Umístění lze specifikovat dodatečná data týkající se umístění, například název.

JSON-LD soubor, JSON schéma, JSON-LD kontext

{
    "@context": "https://ofn.gov.cz/umístění/2020-07-01/kontexty/umístění.jsonld",
    "typ": "Umístění",
    "název": {
        "cs": "Samota u lesa"
    },
    "adresa": {
        "typ": "Adresa",
        "adresní_místo": "https://linked.cuzk.cz/resource/ruian/adresni-misto/16135661"
    }
}

XML soubor, XML soubor schéma

<?xml version="1.0" encoding="UTF-8" ?>
<umístění
    xmlns="https://ofn.gov.cz/umístění/2020-07-01"
    xmlns:adresa="https://ofn.gov.cz/adresy/2020-07-01"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:věc="https://ofn.gov.cz/věc/2020-07-01"
    xsi:schemaLocation="https://ofn.gov.cz/umístění/2020-07-01 
                        https://ofn.gov.cz/um%C3%ADst%C4%9Bn%C3%AD/2020-07-01/sch%C3%A9mata/um%C3%ADst%C4%9Bn%C3%AD.xsd">
    <věc:název xml:lang="cs">Samota u lesa</věc:název>
    <adresa>
        <adresa:adresní_místo>https://linked.cuzk.cz/resource/ruian/adresni-misto/16135661</adresa:adresní_místo>
    </adresa>
</umístění>

CSV soubor

název_cs,adresa_adresní_místo
Samota u lesa,https://linked.cuzk.cz/resource/ruian/adresni-misto/16135661

A opět je k souboru CSV potřeba připojit metadatový popisek dle standardu CSV on the Web [[!tabular-data-primer]]:

Deskriptor

{
    "@id": "https://ofn.gov.cz/umístění/2020-07-01/příklady/2.csv-metadata.json",
    "@context": [
        "http://www.w3.org/ns/csvw",
        {"@language": "cs"}
    ],
    "@type": "Table",
    "url": "2.csv",
    "tableSchema": {
        "@type": "Schema",
        "columns": [
            {
                "@type": "Column",
                "name": "nazev_cs",
                "titles": "název_cs",
                "propertyUrl": "http://www.w3.org/ns/locn#geographicName",
                "dc:description": "Geografický název",
                "datatype": "string",
                "lang": "cs"
            }, {
                "@type": "Column",
                "name": "adresa_adresni_misto",
                "titles": "adresa_adresní_místo",
                "propertyUrl": "http://www.w3.org/ns/locn#addressId",
                "dc:description": "Adresní místo",
                "datatype": "anyURI"
            }, {
                "virtual": true,
                "propertyUrl": "rdf:type",
                "valueUrl": "http://purl.org/dc/terms/Location"
            }
        ]
    }
}

Abstrakt

Přehled

Specifikace

Umístění

Geografický identifikátor

Geografický název

Popis umístění

Geometrie

Budova

Patro

Místnost

Zahraniční adresa - text

Vazba: Adresa

Příklady

Specifikace umístění identifikátorem

Specifikace umístění názvem či geometrií

Umístění formou adresy