Datageo

Datový standard DATAGEO

Abychom mohli data od partnerů rychle integrovat, zobrazovat a sdílet, používáme jednotný Datový standard DATAGEO. Ten popisuje strukturu složek, formáty datových souborů, povinná metadata a další dokumenty nutné pro publikaci na našem portále. V případě, že nebudete schopni data do požadovaného formátu převést, rádi to s vámi probereme a pomůžeme s transformací nebo třeba jen s výrobou souboru s metadaty.

Struktura složky datového balíčku projektu

Každý projekt je publikován jako jedna samostatná složka. Součástí projektu je nájezd dat z jednoho nebo více dnů za použití stejné technologie a metodiky, dále zpracované společně k jednomu účelu. Datový balíček může obsahovat i jen jeden typ dat - pouze mračno bodů nebo pouze panoramatické fotografie. Složka musí dodržovat následující strukturu a požadavky:

[Kořenová složka projektu]/
  ├─ LAZ/
      ├─ _-639600_-11932000.copc.laz
      ├─ _-639600_-11931900.copc.laz
      └─ ...
  ├─ Sphere/
      ├─ EO.csv
      ├─ 1_000001_000004.jpg
      ├─ 1_000001_000005.jpg
      ├─ 1_000001_000006.jpg
      └─ ...
  ├─ TZ.pdf
  └─ metadata.json

Název kořenové složky: doporučený vzor
[ROK]_[DODAVATEL]_[POPIS]_[POŘADOVÉ_ČÍSLO]
(např. 2023_GEOFIRMA_DTMStredokraj_01). Pořadové číslo je užitečné pro případy, kdy chce dodavatel rozdělit jeden větší projekt do menších logických celků.
Více jízd / trajektorií: ve složce Sphere/ je možné mít fotografie rozděleny do podsložek, např. Track1/, Track2/, …, TrackN/, nebo všechny fotografie v jedné hlavní složce.
Metadata a technická zpráva: součástí každého projektu musí být technická zpráva dle našeho vzoru (který vám dodáme) a ověření AZI, je-li relevantní. Vedle toho je povinný soubor metadata.geojson s klíčovými informacemi o projektu (viz níže), které se dále strojově zpracovávají, je tedy nezbytné, aby byl správně vyplněný.

Požadavky na mračna bodů (LAZ)

Formát LAZ COPC: naše platforma vyžaduje pro datové soubory mračen bodů formát LAZ verze 1.4 s akcelerační strukturou COPC. Převedení z LAZ do COPC LAZ můžeme zajistit v rámci postprocesingu dat před samotnou publikací.
Rozřezání na čtverce 100 x 100 metrů: data se publikují nařezaná do gridu 100 × 100 m zarovnaného na souřadnou síť. Název souboru je odvozen od souřadnic severovýchodního rohu pro jednodušší dohledatelnost. Toto formátování můžeme zajistit v rámci postprocesingu dat před samotnou publikací.
Souřadnicový systém: vyžadujeme souřadnicový systém S-JTSK (EPSG:5514).

Požadavky na sférické fotografie

Formát JPG: naše platforma vyžaduje pro datové soubory sférických fotografií formát JPG v poměru 2:1 (ostatní poměry zatím nejsou podporovány, ale budeme je doplňovat).
Informace o externích orientacích: součástí složky Sphere/ musí být soubor EO.csv s externími orientacemi fotografií ve formátu CSV. Tento soubor musí obsahovat minimálně sloupce:
- gps_time (čas snímání fotografie)
- filename (název souboru fotografie)
- X (souřadnice snímacího místa v S-JTSK)
- Y (souřadnice snímacího místa v S-JTSK)
- Z (souřadnice snímacího místa v S-JTSK)
- roll (orientace kamery)
- pitch (orientace kamery)
- heading (orientace kamery)

Příklad struktury souboru EO.csv:

gps_time	file_name	X	Y	Z	roll	pitch	heading
123456.789	1_000001_000004.jpg	-639523.45	-11931987.32	250.12	-3.415495	0.604002	45.0
123459.123	1_000001_000005.jpg	-639520.78	-11931985.67	250.15	-2.906489	0.353086	46.0
123461.456	1_000001_000006.jpg	-639518.12	-11931984.01	250.20	-2.786268	0.06088	47.0

gps_time123456.789
file_name1_000001_000004.jpg
X-639523.45
Y-11931987.32
Z250.12
roll-3.415495
pitch0.604002
heading45.0
gps_time123459.123
gps_time123461.456

Soubor s metadaty (metadata.geojson)

V kořenovém adresáři projektu musí být soubor metadata.json s klíčovými poli. Příklad struktury:

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "firma": "string",
        "zakazka": "string",
        "zakazka_nazev": "string",
        "datum": "string (YYYY-MM-DD)",
        "slozka": "string",
        "zarizeni_vyrobce": "string",
        "zarizeni_typ": "string",
        "zarizeni_vyrobni_cislo": "string",
        "pridavna_antena": "boolean",
        "odometr": "boolean",
        "pridavne_kamery": "boolean",
        "vyska_kamery": "number",
        "pomer_panorama": "string",
        "zavlicovano": "boolean",
        "trida_presnosti": "number",
        "AZI": "string",
        "cislo_AZI": "string",
        "cislo_overeni": "string",
        "datum_overeni": "string (YYYY-MM-DD)",
        "laser_teren": "boolean",
        "mracno_RGB": "boolean"
      }
    }
  ]
}

Povinná pole v souboru metadata.json:

Základní informace: firma, zakazka, zakazka_nazev, datum, slozka
Zařízení: zarizeni_vyrobce, zarizeni_typ, zarizeni_vyrobni_cislo
Konfigurace MMS: odometr, pridavna_antena, pridavne_kamery
Parametry snímání: vyska_kamery, pomer_panorama
Zpracování: zavlicovano, trida_presnosti
Údaje o AZI: AZI, cislo_AZI, cislo_overeni, datum_overeni
Datové produkty: laser_teren, mracno_RGB

Validita souboru metadata.json je ověřována během postprocesingu před publikací.