Import geometrie PIAN pomocí CSV souboru

Definice formátu souboru pro import

Cílem níže popsaných postupů je vytvořit tabulku ve formátu CSV (Comma Separated Values, .csv), pomocí které lze importovat geometrie PIAN do AMČR. CSV soubor musí mít následující parametry:

• Základní formát (obvykle jde o výchozí nastavení pro CSV):
  • kódování: UTF-8;
  • oddělovač pole: , (čárka – znak s UTF-8 kódem U+002C);
  • oddělovač řetězců: " (horní uvozovky – znak s UTF-8 kódem U+0022).
• Soubor obsahuje následují pole:
  • label – pole s jedinečným popiskem prvku (např. identifikátor);
  • epsg – pole obsahující kód souřadnicového systému – akceptovány jsou souřadnicové systémy 4326 (WGS 84) a 5514 (S-JTSK / Krovak East North);
  • geometry – pole obsahují souřadnice ve formátu WKT (Well-known Text) podle typu geometrie:
    • POINT (souřadnice WKT);
    • LINESTRING (souřadnice WKT);
    • POLYGON (souřadnice WKT).

Při nahrávání CSV souborů systém akceptuje i složené geometrie (MULTIPOINT, MULTILINESTRING, MULTIPOLYGON), ale je primárně určen pro validní jednoduché geometrie. Při použití multi* prvků dojde při importu k rozdělení na jednotlivé jednoduché geometrie, protože PIAN nikdy nemůže být ve formátu složené geometrie. Doporučujeme proto tyto typy geometrií nepoužívat, mohou však vznikat např. při vytvoření shapefile přes ESRI ArcGIS, přestože obsahem prvku je jednoduchá geometrie. V takovém případě bude obsah do AMČR importován správně.

Poznámka

Všechna textová pole v CSV vč. geometrií by měla být obalena oddělovačem textu ("), a to zejména kvůli správnému čtení čárky jako oddělovače údajů v rámci geometrií.

Vytvoření CSV souboru

Pomocí online převodníku SHP na CSV

Předpoklady

• Soubor ve formátu SHP obsahující geometrii/geometrie jako podklad pro vytvoření PIAN.
• Souřadnicové systémy jsou WGS 84 (EPSG: 4326) a S-JTSK / Krovak East North (EPSG: 5514).

1. Otevřete online převodník https://www.km4city.org/wkt/.
2. Tlačítkem Procházet/Browse vyberte soubor s koncovkou .shp z připraveného shapefilu (SHP).
3. Do pole Label zvolte název výstupu.
4. Stiskněte tlačítko Upload pro nahrání souboru do převodníku.

5. Na následující obrazovce uvidíte převedené geometrie:
   1. v poli name jsou uvedené názvy jednotlivých geometrií (PIAN) podle toho, jak byly pojmenované ve zdrojovém SHP;
   2. v poli WKT je pak geometrie PIAN ve formátu WKT;
   3. po výběru geometrie zaškrtávacím políčkem je možné konkrétní geometrii/PIAN zobrazit na mapě pro ověření výběru (funguje pouze pro data v souřadnicovém systému WGS-84).

6. Přípravu cílového CSV souboru lze provést např. v tabulkovém editoru Libre Office Calc:
   1. otevřít nový soubor;
   2. do prvního řádku vložit názvy polí podle definice na začátku tohoto návodu (label, epsg, geometry);
      • do pole label zkopírujeme či přepíšeme název zvolené geometrie/geometrií (např. plocha 1, sonda 1 atp.), případně je možné zkopírovat celou tabulku z převodníku a následně upravit názvy polí a přidat sloupec epsg;
      • do pole epsg zapíšeme kód souřadnicového systému (4326 nebo 5514);
      • do pole geometry zkopírujeme souřadnice WKT z totožného pole v převodníku.

7. Připravený soubor uložte ve formátu CSV:
   1. Soubor – Uložit jako – Text CSV (.csv);
   2. pokud vyskočí upozornění na kontrolu správného formátu, které nabízí možnost uložit jako ODF potvrdíme, že správně je CSV (Použít formát Text CSV);
      
   3. v následujícím dialogovém okně pro export nastavíme tyto parametry:
      • Znaková sada: Unicode (UTF-8);
      • Oddělovač pole: , (čárka);
      • Oddělovač řetězců: " (horní uvozovky);
   4. volbu potvrdíme tlačítkem OK.
      

Vytvoření CSV v textovém editoru

Alternativním postupem vytvoření CSV souboru je jeho vytvoření v textovém editoru (např. Poznámkový blok, WordPad, Notepad++ atp.). Viz vzorový CSV soubor.

1. Otevřete textový editor (ukázka je v Poznámkovém bloku, ale stejně funguje i v ostatních zmíněných programech).
2. Na první řádek vložte názvy polí oddělené čárkou podle definice výše:
   • "label","epsg","geometry".
3. Na druhý řádek (případně na další řádky podle počtu geometrií k importu) vložte hodnoty pro tato pole opět oddělená čárkou.

Výsledný soubor může vypadat např. takto:

PIAN_1.csv

"label","epsg","geometry"
"plocha_1","4326","POLYGON ((14.076704183062645 50.11115525776103, 14.076893350212458 50.111165965335545, 14.076900488595527 50.11129088703842, 14.077332360768025 50.111273041080835, 14.077318084002115 50.11114455018662, 14.077478697619995 50.11113384261205, 14.07746799004542 50.1109054143555, 14.07756078902463 50.110901845163994, 14.07754651225872 50.1108268921422, 14.077471559236983 50.11070910882239, 14.077350206725612 50.11061274065173, 14.077260976937964 50.11060560226866, 14.076507877529536 50.110623448226306, 14.076515015912605 50.11106245878182, 14.076704183062645 50.111069597164885, 14.076704183062645 50.11115525776103))"

4. Připravený soubor uložte ve formátu CSV.
   • Při ukládání textového dokumentu v operačním systému Windows je třeba ručně dopsat k názvu souboru jako jeho koncovku .csv.

Export CSV z QGIS

1. V QGIS si otevřeme vektorovou vrstvu, která obsahuje jednu či více geometrií jako podklad pro PIAN (souřadnicový systém WGS 84 – EPSG:4326 nebo S-JTSK / Krovak East North – EPSG: 5514).

2. Vrstvu exportujeme jako WKT:
   1. kliknout pravým tlačítkem na vrstvu v seznamu vrstev – Export – Uložit prvky jako...;
      
   2. v nastavení exportu zvolíme:
      • typ geometrie (GEOMETRY): AS_WKT;
      • oddělovač (SEPARATOR): COMMA;
      • kódování/encoding: UTF-8;
      • souřadnicový systém (SRS): WGS 84 - EPSG:4326 nebo S-JTSK / Krovak East North - EPSG: 5514.

3. QGIS nám nabídne přidat vrstvy do mapy – lze přijmout (vrstva se přidá do seznamu vrstev) nebo ne (vrstva se nepřidá).

4. Výsledný soubor otevřeme např. v Libre Office, v úvodním nastavení importu textu nastavíme/zkontrolujeme následující hodnoty:
   1. Znaková sada: Unicode (UTF-8);
   2. Možnosti oddělovače – Odděleno pomocí: Čárka;
   3. Oddělovač řetězců: ";
   4. ve spodní části okna pak vidíme náhled importovaných dat.

5. Z původních dat nás zajímá především pole s geometrií WKT a případně pole s názvem jednotlivých geometrií/PIAN, data je třeba upravit do požadovaného formátu (viz výše):
   1. vytvořit pole label jako první sloupec (vložením nebo úpravou a přesunem stávajícího pole na první místo);
   2. vytvořit pole epsg pro kód souřadnicového systému ve druhém sloupci;
   3. pole WKT přejmenovat na geometry (třetí sloupec).
6. Výsledek uložíme jako soubor CSV

Import souboru CSV do AMČR

1. V AMČR u vybrané dokumentační jednotky (DJ) zvolíme tlačítkem Další volby (+) možnost PIAN – importovat.

2. Otevře se dialogové okno Importovat PIAN, sem přetáhneme/nebo zvolíme připravený CSV soubor.

3. Systém automaticky provede validaci nahrávaného souboru i geometrií, které obsahuje. Zvolíme vybranou geometrii kliknutím ve sloupci ID pro vytvoření PIAN.

4. V mapě se nám zobrazí importovaná geometrie – můžeme ji potvrdit, nebo ji případně dále editovat pomocí standardních nástrojů pro editaci PIAN dostupných v mapovém rozhraní AMČR.

Upozornění

Úprava CSV v MS Excel není vhodná. Pokud CSV soubor ukládáme v Excelu (stačí i otevření a uložení původně validního souboru), tak program automaticky doplní další uvozovky k polím s textovými řetězci (např. ““POLYGON““) což způsobí nečitelnost souboru – lze ověřit např. při zobrazení v Notepad++ (nebo jiném textovém editoru – např. i v poznámkovém bloku) a zde i nadbytečné uvozovky odmazat.