STAC catalogue intro

Author: Johaney-s

docs/related/collgs/landsat.md

@@ -2,8 +2,8 @@
 
 Landsat je program satelitů dálkového průzkumu Země provozovaný NASA a U.S. Geological Survey.
 
-23. července 1972 byl na oběžnou dráhu Země vypouštěn satelit Earth Resources Technology Satellite (ERTS-1), který byl později přejmenován na Landsat 1. V následujícíh letechy byly vypuštěny další satelity Landsat, díky kterým bylo možné vytvořit archiv dat vzdáleného průzkumu Země. Aktuálně se na oběžné dráze Země nachází dva aktivní satelity - Landast 8 a Landsat 9.
-24. 
+23\. července 1972 byl na oběžnou dráhu Země vypouštěn satelit Earth Resources Technology Satellite (ERTS-1), který byl později přejmenován na Landsat 1. V následujícíh letechy byly vypuštěny další satelity Landsat, díky kterým bylo možné vytvořit archiv dat vzdáleného průzkumu Země. Aktuálně se na oběžné dráze Země nachází dva aktivní satelity - Landast 8 a Landsat 9.
+
 NASA a USGS již nyní spolupracují na vývoji následných misí SLI (udržitelného snímkování Země), které budou zahrnovat Landsat Next, následníka Landsat 9.
 
 Satelity misí Landsat mají optimální rozilišení a spektrální pásma, které umožňuji efektivně sledovat změny na Zemi způsobené změnami klimatu, urbanizací, suchem, požáry, změnami biomasy a mnoha dalšími přírodními i lidskými aktivitami.
@@ -52,7 +52,7 @@ Veřejnosti jsou veškerá data zpřístupněna bez potřeby registrace prostře
 
 Dle specifikací formátu [STAC](https://stacspec.org/en) jsou data rozdělena do jednotlivých kolekcí, viz část [Získávání a redistribuce dat](#získávání-a-redistribuce-dat).
 
-Detailní popis API je dostupný [zde](https://stac.cesnet.cz/api.html).
+Detailní popis API v angličtině je dostupný [zde](https://stac.cesnet.cz/api.html). Shrnutí těchto informací je také dostupné v části o [STAC katalogu](./stac.md).
 
 Itemy dostupné v jednotlivých kolekcích jsou dostupné přes endpoint [`/items`](https://stac.cesnet.cz/api.html#featuresapi--getfeaturesincollection), tedy například pro kolekci [Landsat 8-9 OLI/TIRS C2 L1](https://stac.vm.cesnet.cz/collections/landsat_ot_c2_l1) jsou jednotlivé items dostupné přes endpoint `https://stac.vm.cesnet.cz/collections/landsat_ot_c2_l1/items`. Endpoint `items` defaultně vrací 20 položek, pro procházení celého katalogu je nutné stránkovat pomocí URL parametru `?page=cislo_stranky`, případně změnit počet zobrazených itemů pomocí URL parametru `?limit=pocet_polozek`.
 

docs/related/collgs/stac.md

@@ -1 +1,65 @@
 # STAC katalog
+Tato dokumentace popisuje STAC katalog (SpatioTemporal Asset Catalog) vytvořený pro organizaci a správu metadat produktů
+dálkového průzkumu Země. Katalog zahrnuje data z programů [Sentinel](./sentinel.md), [Landsat](./landsat.md) a [ERA5](./era5.md),
+která jsou rozřazena do kolekcí.
+Relevantní popisy použití STAC katalogu naleznete také na stránkách těchto programů v této dokumentaci.
+Katalog je přístupný na adrese [https://stac.cesnet.cz/](https://stac.cesnet.cz/).
+
+## Struktura katalogu
+Podrobná specifikace STAC katalogu je dostupná v angličtině na [https://stacspec.org/en/about/stac-spec/](https://stacspec.org/en/about/stac-spec/). 
+
+**Katalog** - STAC katalog je způsob, jak uspořádat a propojit data, aby se dala snadno procházet a vyhledávat. 
+Funguje jako seznam, který obsahuje data a odkazy na další (pod)katalogy.
+
+**Kolekce** - STAC kolekce poskytuje dodatečné informace o souboru dat (např. část dat Sentinelu 1 - kolekce sentinel-1-slc).
+Rozšiřuje funkčnost katalogu přidáním dalších polí, která umožňují popis prostorového a časového rozsahu dat,
+licence, klíčových slov, poskytovatelů, apod. Seznam kolekcí je přístupný na endpointu [/collections](https://stac.vm.cesnet.cz/collections).
+
+**Item** - STAC item je ucelený záznam obsahující data a metadata, jehož specifikace může obsahovat časovou značku, náhledový obrázek,
+odkazy k datům, odkazy k relevantním itemům a asset linky.
+
+**Asset** - soubor přidružený ke konkrétnímu itemu. Asset je možné stáhnout, např.
+náhledový obrázek, GeoTIFF nebo NetCDF soubor. Součástí metadat assetu jsou informace jako název, popis, typ a odkaz na soubor (_href_).
+
+## API
+Pro volání API použijte identickou adresu [https://stac.cesnet.cz/](https://stac.cesnet.cz/).
+Podrobná dokumentace metod je k dispozici v angličtině zde: [https://stac.cesnet.cz/api.html](https://stac.cesnet.cz/api.html).
+Pro prohledávání není potřeba autentizace.
+
+K vyhledání produktů slouží endpoint [/search](https://stac.cesnet.cz/search).
+Na tento endpoint v těle requestu zasíláte JSON obsahující ohraničující body (_bbox_) a časové rozmezí.
+
+```
+{
+  "bbox": [5.5, 46, 8, 47.4], 
+  "time": "2024-02-12T00:00:00Z/2024-03-12T100:00:00Z"
+}
+```
+
+Odpověď získáte v následujícím formátu:
+
+```
+{
+    "type": "FeatureCollection",
+    "numberMatched": 330000,
+    "numberReturned": 20,
+    "features": [...],
+    "links": [
+        {
+            "rel": "next",
+            "type": "application/geo+json",
+            "href": "https://stac.vm.cesnet.cz/search?&next=227165117419782344"
+        },
+        ...
+    ]
+}
+```
+kde **features** obsahuje itemy splňující vyhledávací parametry, **numberMatched** obsahuje celkový počet itemů splňujících
+vyhledávací parametry, **numberReturned** počet aktuálně vrácených itemů a **href** zanořený v **links** je URL odkazující na další
+stránku výsledků tohoto vyhledávání.
+
+
+## Prohlížeč
+Rovněž je k dispozici prohlížeč produktů v grafickém rozhraní: [https://stac.cesnet.cz/browser/](https://stac.cesnet.cz/browser/).
+![stac_browser.png](stac_browser.png)
+I zde jsou data rozřazena do kolekcí a je možné sáhnout jednotlivé assety.

docs/related/collgs/stac_browser.png

@@ -153,5 +153,6 @@ nav:
       - 'Sentinel':
         - related/collgs/sentinel.md
         - related/collgs/gss_login.md
+      - related/collgs/stac.md
       - related/collgs/landsat.md
       - 'C-scale data discovery': related/notebooks/c-scale-notebooks/1-C-SCALE_Data_Discovery.ipynb