Tento dokument je sdílenou specifikací pro adresy 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 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í adresy v poskytovaných datech.
Příkladem může být adresa místa konání akce či adresa sídla organizace.
Adresa v této OFN je z definice adresou dle zákona č. 111/2009 Sb., o základních registrech.
Pro každou vlastnost je uveden její identifikátor ve formě IRI, který je pro její reprezentaci použit ve všech datových formátech, její název, datový typ, popis a příklad.
Adresou v této OFN označujeme určení místa v poskytovaných datech za použití identifikátorů z RÚIAN.
Příkladem může být místo konání akce či sídlo organizace.
Tato třída odpovídá třídě Address z ISA2 Core Location Vocabulary.
Způsob identifikace adresy je pro účely této OFN rozdělen do 4 kategorií:
V této sekci je definováno vyjádření adresy identifikátorem adresního místa z RÚIAN.
Pokud identifikátor adresního místa existuje, měl by být k vyjádření adresy použit pouze on.
Kód adresního místa je možné dohledat v aplikaci Veřejný dálkový přístup (podle návodu v sekci Získání IRI adresního místa).
V této sekci je definována reprezentace adresy pomocí identifikátorů nebo názvů územních prvků definovaných jako součást adresy dle zákona č. 111/2009 Sb., o základních registrech.
Vyjádření adresy pomocí těchto prvků je možné, pokud pro danou adresu není identifikátor adresního místa ve formě IRI dostupný.
Není-li možné rozlišit, zda se jedná o obec nebo vojenský újezd, pak je možné vlastnost obec v sémantickém slovníku pojmů definovat jako území obce nebo vojenského újezdu následovně:
Název katastrálního území, který je vyplněn pouze v Praze v kombinaci s názvem městského obvodu Prahy místo části obce.
Tato vlastnost odpovídá vlastnosti addressArea z ISA2 Core Location Vocabulary.
Význam
Vlastnost název_katastrálního_území je definována v sémantickém slovníku pojmů jako má název katastrálního území následovně:
Název městského obvodu v hlavním městě Praze, který je vyplněn pouze v Praze v kombinaci s názvem katastrálního území místo části obce.
Tato vlastnost odpovídá vlastnosti addressArea z ISA2 Core Location Vocabulary.
Název ulice, na kterou je navázáno adresní místo.
Může být vyplněn pouze u obcí, které mají zavedenou uliční síť.
Tato vlastnost odpovídá vlastnosti thoroughfare z ISA2 Core Location Vocabulary.
Význam
Vlastnost název_ulice je definována v sémantickém slovníku pojmů jako má název ulice následovně:
Číslo popisné nebo číslo evidenční, podle typu čísla domovního.
V případě uvedení čísla domovního musí být vyplněn i jeho typ.
Hodnota této vlastnosti odpovídá vlastnosti locatorDesignator z ISA2 Core Location Vocabulary.
Význam
Vlastnost číslo_domovní je definována v sémantickém slovníku pojmů jako má číslo domovní následovně:
Typ čísla domovního, může nabývat hodnot: č.p. - číslo popisné stavebního objektu č.ev. - číslo evidenční stavebního objektu.
V případě uvedení domovního čísla je vyplnění jeho typu nutností k jednoznačné identifikaci adresy.
Hodnota této vlastnosti odpovídá vlastnosti locatorDesignator z ISA2 Core Location Vocabulary.
Význam
Vlastnost typ_čísla_domovního je definována v sémantickém slovníku pojmů jako typ čísla domovního následovně:
Tato sekce obsahuje atributy vyjádření adresy, které nejsou součástí adresy podle zákona č. 111/2009 Sb., o základních registrech.
Zde uvedené prvky slouží k upřesnění adresy, která nemá dostupný kód adresního místa.
Plzeňská 285, 33101 Plasy Sibeliova 368/51, Střešovice, 16200 Praha 6
Příklady použití
V této sekci jsou uvedeny příklady reprezentace adresy v různých formátech a v různých úrovních detailu pro konkrétní příklady použití.
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 adresa použita 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 adresa_sídla, a z názvu atributu adresy jejich spojením pomocí znaku podtržítka _, například adresa_sídla_psč.
Přímé určení adresy
Jedná se o nejčastější způsob určení adresy v České republice pomocí příslušného adresního místa v RÚIAN ve formě IRI.
Tento zápis je vhodný pro výraznou většinu všech adresních míst v České republice.
Identifikátor adresního místa je možné získat v aplikaci Veřejný dálkový přístup podle návodu v sekci Získání IRI adrsního místa.
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ý soubor0.csv-metadata.json:
Jednoduchá adresa s přidanými vlastními atributy
Pokud publikovaná data ještě nejsou propojena s registrem RÚIAN, než se tak stane, lze data publikovat po položkách, které ale duplikují autoritativní informace dostupné v RÚIAN a mohou být zdrojem chyb.
Do schématu si lze v případě potřeby přidávat další atributy.
V následujících příkladech je přidán atribut poznámka.
V XML se vlastní atributy přidávají na závěr adresy, do vlastního XML jmenného prostoru (XML namespace [[!xml-names]]).
V tomto příkladu jsou nové atributy přidány do XML jmenného prostoru x.
Alternativně je možné si nadefinovat celé nové XML schéma, které by vycházelo ze zde uvedeného základního XML schématu.
Pokud je cílem datové sady uvést údaje k doručování, je ideálním způsobem uvést IRI adresního místa.
Po otevření IRI adresního místa ve webovém prohlížeči se zobrazí detaily adresního místa.
V této sekci je návod, jak získat identifikátory ve formě IRI pro adresní místo i další územní prvky z RÚIAN pomocí aplikace Veřejný dálkový přístup (VDP).
Na adrese http://vdp.cuzk.cz/ vyberte v nabídce položku "Vyhledání prvků".
V levém sloupci vyberte "Adresní místo" (nebo jiný územní prvek, jehož identifkátor hledáte).
Vyhledejte adresní místo na základě kombinace obce, ulice, části obce, městské části/městského obvodu, volebního okrsku, stavebního objektu, orientačního čísla a/nebo PSČ.
Kód adresního místa je v prvním sloupci v tabulce výsledků. Validní zápis IRI adresního místa z příkladu je https://linked.cuzk.cz/resource/ruian/adresni-misto/21728208.
Ostatní územní prvky mají identifikátor zapsaný také v prvním sloupci tabulky výsledků.
