Výměnný formát JSD UAP¶

Jednotný výměnný formát JSD UAP je navržen s ohledem na charakter dat UAP, jednoduchost použití a možnosti práce s ním bez nutnosti specializovaných nástrojů.

Technologie¶

Výměnný formát je založen na otevřeném formátu OGC GeoPackage. Jedná se o moderní formát pro ukládání geografických dat — umožňuje ukládat jak vektorová, tak rastrová data, je platformově nezávislý a je podporován řadou nástrojů a aplikací.

GeoPackage je založen na technologii SQLite — relační databázové knihovně, která umožňuje ukládat data v samostatném souboru s příponou .gpkg.

Datové typy GeoPackage¶

GeoPackage disponuje omezenou sadou datových typů, které pokrývají potřeby pro práci s daty UAP:

Geometrické datové typy¶

Pro vektorovou geometrii jsou podporovány typy: GEOMETRY, POINT, LINESTRING, POLYGON, MULTIPOINT, MULTILINESTRING, MULTIPOLYGON.

Základní struktura GeoPackage¶

Základní struktura GeoPackage je tvořena tabulkami s předponou gpkg_. V těchto tabulkách jsou evidovány informace o datových sadách, geometrických sloupcích, rastrových datech apod.

Struktura dat JSD UAP¶

Struktura dat odpovídá datovému modelu. Pro jednotlivé třídy prvků datového modelu jsou vytvořeny tabulky se shodným názvem, např. J012_USES_UP_p, J062_Teplovod_Objekt_b apod. Názvy sloupců odpovídají názvům atributů tříd prvků, a to včetně velikosti písmen.

GeoPackage obsahuje i datové domény definované datovým modelem a jsou provázány s příslušnými sloupci tabulek. Pokud to aplikace použitá pro práci s GeoPackage umožňuje (např. QGIS od verze 3.26), jsou při prohlížení a editaci dat zobrazovány hodnoty z číselníků, nikoli jen jejich klíče.

Systémové tabulky JSD UAP¶

Rozšíření GeoPackage¶

V rámci výměnného formátu JSD UAP jsou používána tato rozšíření:

Schema Extension¶

Umožňuje evidovat popisné atributy datových sad, definovat datové domény a provázat je na konkrétní atributy. Používá tabulky gpkg_data_columns a gpkg_data_column_constraints.

RTree Spatial Indexes Extension¶

Umožňuje vytvářet prostorové indexy pro datové sady. Prostorové indexy jsou uloženy v tabulkách rtree_*.

Rozšíření jsd_uap_enumset¶

Rozšiřuje standard OGC GeoPackage o podporu tzv. množinových domén (enumset), které umožňují ukládat více hodnot z jedné výčtové domény do jednoho textového pole (např. kombinaci barev turistické značky).

Hodnoty množiny jsou zapisovány bez oddělovačů, prostým zřetězením znakových kódů jednotlivých prvků domény, přičemž každá hodnota se může v řetězci vyskytovat nejvýše jednou a pořadí nemá význam.

Rozšíření definuje vlastní tabulku jsd_uap_enumset:

Primárním klíčem tabulky je dvojice (table_name, column_name). Rozšíření nezasahuje do standardních tabulek gpkg_data_columns ani gpkg_data_column_constraints a je plně slučitelné se základní strukturou GeoPackage — klienti, kteří rozšíření neznají, mohou tato pole číst jako běžné textové atributy.

V tabulce gpkg_extensions je zaregistrován pouze jeden záznam s odkazem na tabulku jsd_uap_enumset, aby byla zachována kompatibilita s nástroji ESRI, které nepracují s neznámými sloupcovými rozšířeními.

Souřadnicový systém¶

Souřadnicový systém je S-JTSK (EPSG:5514). V tabulce gpkg_spatial_ref_sys je uložen v ESRI WKT (v rozporu se standardem OGC WKT), z důvodů kompatibility s ESRI nástroji, které neumí OGC WKT správně interpretovat. Opensource nástroje bez problému přečtou oba formáty.

Složková struktura předávky¶

Hlavní datový soubor GeoPackage je uložen ve složce, která je následně zazipována. Datový soubor ÚAP může být doplněn souborem metadat nebo textovým průvodním souborem.

XXXXXX_UAP_vYYYY-MM-DD.zip/           ← zazipovaná dokumentace ÚAP (povinný)
└── XXXXXX_UAP_vYYYY-MM-DD/           ← složka obsahující dokumentaci (povinný)
    ├── XXXXXX_UAP_vYYYY-MM-DD.gpkg   ← hlavní datový soubor (povinný)
    ├── XXXXXX_UAP_metadata.xml       ← metadata dle ISO 19115 (volitelné)
    └── README.txt                    ← průvodní informace (volitelné)

Pozn.: Navrhované názvy souborů a složek jsou pouze doporučující a není nutné je dodržovat.

Šablona datového modelu¶

Prázdná GeoPackage šablona se všemi vrstvami a správně definovanými schématy je dostupná v repozitáři:

uap-model-v1.0.7.c.gpkg

Šablona obsahuje všechny tabulky jevů J001–J113 bez dat (prázdné), se správnými datovými typy a souřadnicovým systémem S-JTSK (EPSG:5514).