# DatováMapa

> Otevřené rozhraní pro vizualizaci dat v mapě. Kdokoli, kdo má data s polohou, zveřejní manifest a GeoJSON data podle protokolu 0.1; portál DatováMapa je načte, ověří, uloží do cache a zobrazí v mapě spolu s daty ostatních zdrojů, s uvedením zdroje.

Portál provozuje vrealmatic.com (https://vrealmatic.com/webove-sluzby). Data u poskytovatelů typicky připravují AI agenti. Postup je v návodu pro AI agenty; hotovou práci ověří validátor (`POST https://datovamapa.cz/api/validovat`, živý test `GET https://datovamapa.cz/api/validovat?manifestUrl=…`). Totéž nabízí MCP server https://datovamapa.cz/mcp (Streamable HTTP, bez autentizace). Dokumentace je česky; každá stránka má markdown verzi s příponou `.md`.

## Dokumentace

- [Návod pro AI agenty](https://datovamapa.cz/dokumentace/pro-ai-agenty.md): Postup krok za krokem, pravidla, šablony kódu a kritéria hotové práce pro agenta, který připravuje data poskytovatele.
- [Pro poskytovatele dat](https://datovamapa.cz/dokumentace/pro-poskytovatele.md): Jak připojit data: statické soubory, vlastní endpoint nebo WMS; manifest, data, vizualizace, ověření, podmínky.
- [Protokol 0.1](https://datovamapa.cz/dokumentace/protokol.md): Normativní specifikace manifestu, datového dotazu, odpovědi a cache.
- [API portálu a MCP server](https://datovamapa.cz/dokumentace/api.md): Katalog, data, validátor, MCP nástroje, odkazy na mapu a kódy nálezů.
- [O projektu](https://datovamapa.cz/dokumentace/o-projektu.md): Vize DatovéMapy, principy a plán rozvoje.

## Schémata a kontrakty

- [JSON Schema manifestu](https://datovamapa.cz/schema/0.1/manifest.json): co poskytovatel zveřejní o sobě a svých datových sadách
- [JSON Schema dat](https://datovamapa.cz/schema/0.1/data.json): GeoJSON odpověď datového endpointu
- [OpenAPI poskytovatele](https://datovamapa.cz/schema/0.1/poskytovatel-openapi.json): kontrakt endpointů, které implementuje poskytovatel (lze z něj generovat server)
- [OpenAPI portálu](https://datovamapa.cz/openapi.json): katalog, data, validátor

## Příklady

- [manifest-minimalni.json](https://datovamapa.cz/priklady/manifest-minimalni.json): Nejmenší rozumný manifest: statický GeoJSON soubor, režim full.
- [manifest-kompletni.json](https://datovamapa.cz/priklady/manifest-kompletni.json): Manifest se všemi hlavními možnostmi: bbox, filtry, barvy podle hodnot, seskupování, kartogram, WMS.
- [data-body.json](https://datovamapa.cz/priklady/data-body.json): Odpověď s body včetně rozšíření dm.
- [data-plochy.json](https://datovamapa.cz/priklady/data-plochy.json): Odpověď s plochou (polygon) a číselnou hodnotou pro kartogram.
- [Ukázkový poskytovatel](https://datovamapa.cz/api/ukazka/manifest): referenční implementace protokolu přes HTTP (smyšlená data, v katalogu není)

## Data v portálu

- [Katalog v markdownu](https://datovamapa.cz/zdroje.md): 68 sad od 22 poskytovatelů, s vlastnostmi a parametry
- [Katalog v JSON](https://datovamapa.cz/api/katalog)

## Optional

- [Celá dokumentace v jednom souboru](https://datovamapa.cz/llms-full.txt)