# DátováMapa

> Otvorené rozhranie na vizualizáciu dát v mape. Ktokoľvek, kto má dáta s polohou, zverejní manifest a GeoJSON dáta podľa protokolu 0.1; portál DátováMapa ich načíta, overí, uloží do cache a zobrazí v mape spolu s dátami ostatných zdrojov, s uvedením zdroja.

Portál prevádzkuje vrealmatic.com (https://vrealmatic.com/webove-sluzby).

Agenti, ktorí odpovedajú na otázky o mieste („je adresa v záplavovom území?“, „aký je vzduch v Ostrave?“), použijú MCP server https://datovamapa.sk/mcp (nástroje `find_place`, `nearby`, `summary`, `catalog`) alebo HTTP API: `GET https://datovamapa.sk/api/places?query=…`, `GET https://datovamapa.sk/api/nearby?point=lon,lat&datasets=…`, `GET https://datovamapa.sk/api/summary/{provider}/{dataset}?municipality=…`. Návod: https://datovamapa.sk/dokumentacia/ai-asistenti.md

Dáta u poskytovateľov typicky pripravujú AI agenti. Postup je v návode pre AI agentov; hotovú prácu overí validátor (`POST https://datovamapa.sk/api/validate`, živý test `GET https://datovamapa.sk/api/validate?manifestUrl=…`). To isté ponúka MCP server https://datovamapa.sk/mcp (Streamable HTTP, bez autentifikácie). Dokumentácia je zatiaľ po česky; každá stránka má markdown verziu s príponou `.md`.

## Dokumentácia

- [Návod pre AI agentov](https://datovamapa.sk/dokumentacia/pre-ai-agentov.md): Postup krok za krokom, pravidlá, šablóny kódu a kritériá hotovej práce pre agenta, ktorý pripravuje dáta poskytovateľa.
- [Dáta pre AI asistentov](https://datovamapa.sk/dokumentacia/ai-asistenti.md): Ako pripojiť DátovúMapu k AI asistentovi (MCP, HTTP API) a pýtať sa na miesta a dáta.
- [Pre poskytovateľov dát](https://datovamapa.sk/dokumentacia/pre-poskytovatelov.md): Ako pripojiť dáta: statické súbory, vlastný endpoint alebo WMS; manifest, dáta, vizualizácie, overenie, podmienky.
- [Protokol 0.1](https://datovamapa.sk/dokumentacia/protokol.md): Normatívna špecifikácia manifestu, dátového dotazu, odpovede a cache.
- [API portálu a MCP server](https://datovamapa.sk/dokumentacia/api.md): Katalóg, dáta, validátor, MCP nástroje, odkazy na mapu a kódy nálezov.
- [O projekte](https://datovamapa.sk/dokumentacia/o-projekte.md): Vízia DátovejMapy, princípy a plán rozvoja.

## Schémy a kontrakty

- [JSON Schema manifestu](https://datovamapa.sk/schema/0.1/manifest.json): čo poskytovateľ zverejní o sebe a svojich dátových sadách
- [JSON Schema dát](https://datovamapa.sk/schema/0.1/data.json): GeoJSON odpoveď dátového endpointu
- [OpenAPI poskytovateľa](https://datovamapa.sk/schema/0.1/provider-openapi.json): kontrakt endpointov, ktoré implementuje poskytovateľ (dá sa z neho generovať server)
- [OpenAPI portálu](https://datovamapa.sk/openapi.json): katalóg, dáta, miesto a okolie, súhrny, validátor

## Príklady

- [manifest-minimal.json](https://datovamapa.sk/priklady/manifest-minimal.json): Najmenší rozumný manifest: statický GeoJSON súbor, režim full.
- [manifest-complete.json](https://datovamapa.sk/priklady/manifest-complete.json): Manifest so všetkými hlavnými možnosťami: bbox, filtre, farby podľa hodnôt, zoskupovanie, kartogram, WMS.
- [data-points.json](https://datovamapa.sk/priklady/data-points.json): Odpoveď s bodmi vrátane rozšírenia dm.
- [data-polygons.json](https://datovamapa.sk/priklady/data-polygons.json): Odpoveď s plochou (polygón) a číselnou hodnotou pre kartogram.
- [Ukážkový poskytovateľ](https://datovamapa.sk/api/sample/manifest): referenčná implementácia protokolu cez HTTP (vymyslené dáta, v katalógu nie je)

## Dáta v portáli

- [Katalóg v markdowne](https://datovamapa.sk/zdroje.md): 43 sád od 15 poskytovateľov, s vlastnosťami a parametrami
- [Katalóg v JSON](https://datovamapa.sk/api/catalog)

## Optional

- [Celá dokumentácia v jednom súbore](https://datovamapa.sk/llms-full.txt)