# 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)

---

<!-- https://datovamapa.sk/dokumentacia/pre-ai-agentov.md -->

# Návod pre AI agentov: pripojenie dát do DátovejMapy {#navod-pro-ai-agenty-pripojeni-dat-do-datovemapy}

Tento dokument je určený AI agentom, ktorí pripravujú dáta pre portál DátováMapa. Poskytovateľom môže byť ktokoľvek, kto má dáta s polohou. Popisuje cieľ, postup, pravidlá a kritériá hotovej práce. Človek, ktorý agenta riadi, nájde zrozumiteľnejšiu verziu v [sprievodcovi pre poskytovateľov](https://datovamapa.sk/dokumentacia/pre-poskytovatelov.md).

## Cieľ {#cil}

Zverejniť na HTTPS:

1. **manifest** – JSON podľa [schémy manifestu](https://datovamapa.sk/schema/0.1/manifest.json),
2. pre každú dátovú sadu **zdroj dát** – GeoJSON súbor alebo endpoint podľa [schémy dát](https://datovamapa.sk/schema/0.1/data.json) a [OpenAPI kontraktu poskytovateľa](https://datovamapa.sk/schema/0.1/provider-openapi.json), prípadne existujúce rastrové dlaždice / WMS,

tak, aby [validátor](https://datovamapa.sk/dokumentacia/api.md#validator) vrátil `"valid": true` a čo najmenej varovaní.

## Čo si načítať {#co-si-nacist}

| Zdroj | Prečo |
|---|---|
| [llms.txt](https://datovamapa.sk/llms.txt) | rozcestník celej dokumentácie |
| [Protokol 0.1](https://datovamapa.sk/dokumentacia/protokol.md) | normatívna špecifikácia – pri nejasnosti platí tá |
| [JSON Schema manifestu](https://datovamapa.sk/schema/0.1/manifest.json), [dát](https://datovamapa.sk/schema/0.1/data.json) | presné typy, limity a popisy polí |
| [OpenAPI poskytovateľa](https://datovamapa.sk/schema/0.1/provider-openapi.json) | kontrakt endpointu, dá sa z neho generovať server |
| [manifest-complete.json](https://datovamapa.sk/priklady/manifest-complete.json), [manifest-minimal.json](https://datovamapa.sk/priklady/manifest-minimal.json) | platné vzory |
| [data-points.json](https://datovamapa.sk/priklady/data-points.json), [data-polygons.json](https://datovamapa.sk/priklady/data-polygons.json) | platné vzory odpovedí |
| [Katalóg](https://datovamapa.sk/zdroje.md) | čo už v portáli je – nevytvárajte duplicity, inšpirujte sa kľúčovými slovami |

Ak viete používať MCP, pripojte sa k serveru `https://datovamapa.sk/mcp` (Streamable HTTP, bez autentifikácie). Nástroje `documentation`, `schema`, `example`, `validate_manifest`, `validate_data` a `catalog` pokrývajú všetko v tomto návode. Pozri [MCP server](https://datovamapa.sk/dokumentacia/api.md#mcp-server).

## Postup {#postup}

### 1. Inventúra dát {#1-inventura-dat}

Zistite, aké priestorové dáta poskytovateľ má: databázy (PostGIS, MS SQL), GIS súbory (SHP, GPKG, KML, CSV so súradnicami), existujúce API, služby WMS/WMTS. Pri každom zdroji zistite:

- typ geometrie (body / línie / plochy),
- súradnicový systém (na Slovensku často **S-JTSK, EPSG:5514** – treba previesť),
- počet objektov a ako často sa menia,
- licenciu a kto ju môže schváliť,
- či obsahuje **osobné údaje** (mená, rodné čísla, adresy fyzických osôb, EČV…).

### 2. Návrh dátových sád {#2-navrh-datovych-sad}

- Jedna sada = jeden druh objektov s jedným spôsobom zobrazenia. Kontajnery a hlukovú mapu dajte do dvoch sád.
- `id` sady aj poskytovateľa: malé písmená bez diakritiky, číslice, spojovníky (`kontejnery-na-odpad`). Po zverejnení ho nemeňte – je súčasťou odkazov.
- Voľba zdroja:

| Situácia | `source` |
|---|---|
| do ~2 000 objektov, menia sa najviac denne | statický súbor, `"type": "geojson", "mode": "full"` |
| viac objektov alebo živé dáta | endpoint, `"mode": "bbox"`, nastavte `coverage.bbox` a pri veľkých sadách `coverage.minZoom` |
| už existuje WMS / XYZ dlaždice | `"type": "raster"` so šablónou `{bbox-epsg-3857}` alebo `{z}/{x}/{y}`; doplňte `presentation.legend` (farby a popisky z legendy služby, napr. ArcGIS `…/MapServer/legend?f=json` alebo WMS `GetLegendGraphic`) |

### 3. Prevod dát {#3-prevod-dat}

- Súradnice **WGS84 (EPSG:4326), poradie `[lon, lat]`**. Pre Slovensko je to zhruba `[19, 48]`, nie `[48, 19]`.
- Zaokrúhlite na 6 desatinných miest (≈ 10 cm), zvyšok len zväčšuje odpoveď.
- Polygóny musia mať uzavreté prstence (prvý bod = posledný).
- Každý objekt by mal mať stabilné `id`.
- Vlastnosti (`properties`) ako jednoduché hodnoty – reťazce, čísla, booleany, dátumy v ISO 8601. Žiadne HTML.
- Čísla ako čísla (`1100`), nie reťazce (`"1100 l"`); jednotku dajte do `fields[].unit`.

Prevod GIS súboru do GeoJSON:

```bash
ogr2ogr -f GeoJSON -t_srs EPSG:4326 -lco RFC7946=YES -lco COORDINATE_PRECISION=6 lavicky.geojson vstup.shp
```

Prevod súradníc v Pythone:

```python
from pyproj import Transformer

to_wgs84 = Transformer.from_crs("EPSG:5514", "EPSG:4326", always_xy=True)
lon, lat = to_wgs84.transform(x_sjtsk, y_sjtsk)  # always_xy=True vracia [lon, lat]
```

### 4. Manifest {#4-manifest}

Vyplňte nielen povinné polia, ale aj tie, ktoré rozhodujú o tom, či dáta niekto nájde:

- `description` – 1–2 vety: čo dáta obsahujú, odkiaľ sú, ako sú aktuálne.
- `keywords` – 5–15 slov a synoným v slovenčine, vrátane hovorových tvarov (`smetnica` popri `kontajner`).
- `useCases` – na čo dáta pomáhajú: `construction`, `housing`, `land-purchase`, `agriculture`, `investment`, `transport`, `tourism`, `business`, `public-administration`. Podľa nich asistent portálu vyberá dáta k zadaniu typu „chcem stavať v obci X“.
- `category` – jedna z: `territory`, `nature`, `water`, `risks`, `energy`, `transport`, `society`, `economy`, `infrastructure`.
- `fields` – každá vlastnosť, ktorú má používateľ vidieť: `label`, `type`, `unit`. Jednu označte `primary` (nadpis v detaile).
- `license` – názov a text atribúcie. **Licenciu si nevymýšľajte**; ak ju neviete, opýtajte sa človeka.
- `temporal.updated`, `temporal.frequency` – aktuálnosť dát.
- `temporal.param` – pri dátach v čase (nehody, merania, udalosti): kľúč parametra typu `range` s rokmi (`min`/`max` = prvý a posledný rok), ktorým používateľ volí obdobie. Odpoveď k tomu má posielať `dm.timeline` s počtami po rokoch (pri hodnotách v čase, ako je počet obyvateľov, namiesto toho súhrnný `dm.chart`), pozri [časový filter](https://datovamapa.sk/dokumentacia/protokol.md#casovy-filtr).
- **Vývoj v čase** – zistite, či majú objekty hodnotu za viac období (stavy po rokoch, merania, ceny). Ak áno, posielajte ju vždy pri každom objekte v `dm.chart`; ak je zmyslom sady zmena, farbite podľa trendu. Pozri [vývoj v čase a trend](https://datovamapa.sk/dokumentacia/protokol.md#vyvoj-v-case-a-trend).

### 5. Vizualizácia {#5-vizualizace}

| Geometria | Vhodný typ | Poznámka |
|---|---|---|
| body, desiatky až stovky | `circle` | farba podľa kategórie (`categorical`), popisok cez `label` |
| body, tisíce | `circle` s `cluster` alebo `heatmap` | heatmapa len pre hustotu, neukazuje jednotlivé objekty |
| línie | `line` | šírka môže závisieť od hodnoty |
| plochy s hodnotou | `fill` + `interpolate` alebo `step` | kartogram; `opacity` 0.4–0.6, aby bol vidieť podklad |
| body alebo plochy, ktorých hodnota sa mení v čase | `circle` / `fill` + `color: { "type": "trend" }` | ak ide o zmenu (rastie / klesá); rad hodnôt v `dm.chart` pri každom objekte, trend dopočíta portál |
| plochy bez hodnoty | `fill` s jednou farbou | |

Pravidlá: farby hex; kategórie max. ~8 farieb; pre hodnoty použite postupnú škálu od svetlej po tmavú; `field` v prezentácii musí zodpovedať vlastnosti v dátach (a vo `fields`, s číselným typom pri `interpolate`/`step`). Ak má hodnota objektu históriu, pošlite ju v `dm.chart` pri akejkoľvek prezentácii – aj pri kartograme s výberom roka (zvolený rok v `highlight`).

### 6. Endpoint (len pri `mode: "bbox"` alebo živých dátach) {#6-endpoint-jen-u-mode-bbox-nebo-zivych-dat}

Implementujte `GET` podľa [OpenAPI kontraktu](https://datovamapa.sk/schema/0.1/provider-openapi.json):

- query `bbox=minLon,minLat,maxLon,maxLat` – vráťte objekty, ktoré výrez pretínajú,
- `zoom` – celé číslo; pri malom priblížení môžete vracať agregácie,
- `limit` – nevracajte viac objektov; ak ich orežete, nastavte `dm.truncated: true` a `dm.total`,
- vlastné parametre z `params` (rozsah `od,do`, viac hodnôt `a,b,c`),
- `Content-Type: application/geo+json` alebo `application/json`, HTTPS, odpoveď do 1 s,
- neznáme query parametre ignorujte (`lang`, `protocol`, `cursor` môžete obísť).

CORS nie je potrebný – portál sa pýta zo servera.

Python (FastAPI + PostGIS):

```python
from fastapi import FastAPI

app = FastAPI()

@app.get("/datovamapa/kontejnery")
def kontejnery(bbox: str | None = None, zoom: int | None = None, limit: int = 5000, druh: str | None = None):
    west, south, east, north = map(float, bbox.split(",")) if bbox else (-180, -90, 180, 90)
    druhy = druh.split(",") if druh else None
    rows = db.fetch_all(
        """
        SELECT id, druh, objem, vyvoz::text, ST_AsGeoJSON(geom, 6)::json AS geometry
        FROM kontejnery
        WHERE geom && ST_MakeEnvelope(%s, %s, %s, %s, 4326)
          AND (%s::text[] IS NULL OR druh = ANY(%s))
        LIMIT %s
        """,
        (west, south, east, north, druhy, druhy, limit + 1),
    )
    features = [
        {"type": "Feature", "id": r["id"], "geometry": r["geometry"],
         "properties": {"druh": r["druh"], "objem": r["objem"], "vyvoz": r["vyvoz"]}}
        for r in rows[:limit]
    ]
    return {"type": "FeatureCollection", "features": features, "dm": {"truncated": len(rows) > limit, "ttl": 3600}}
```

TypeScript (Cloudflare Worker / Node, dáta v pamäti):

```ts
// KONTEJNERY: pole GeoJSON Feature s bodmi, načítané pri štarte (z databázy alebo súboru).
declare const KONTEJNERY: { type: "Feature"; id: number; geometry: { type: "Point"; coordinates: [number, number] }; properties: Record<string, unknown> }[];

export default {
  async fetch(request: Request): Promise<Response> {
    const url = new URL(request.url);
    const [west, south, east, north] = (url.searchParams.get("bbox") ?? "-180,-90,180,90").split(",").map(Number);
    const limit = Math.min(Number(url.searchParams.get("limit")) || 5000, 5000);
    const inside = KONTEJNERY.filter(({ geometry: { coordinates: [lon, lat] } }) =>
      lon >= west && lon <= east && lat >= south && lat <= north);
    return Response.json(
      { type: "FeatureCollection", features: inside.slice(0, limit), dm: { total: inside.length, truncated: inside.length > limit } },
      { headers: { "Content-Type": "application/geo+json", "Cache-Control": "public, max-age=300" } },
    );
  },
};
```

### 7. Validácia {#7-validace}

Opakujte, kým nie sú chyby, a prejdite každé varovanie (opravte, alebo vedome ponechajte a zdôvodnite):

```bash
# manifest (bez zverejnenia)
curl -sX POST https://datovamapa.sk/api/validate -H 'Content-Type: application/json' --data @manifest.json
# dáta proti konkrétnej sade
curl -sX POST https://datovamapa.sk/api/validate -H 'Content-Type: application/json' \
  --data "{\"data\": $(cat lavicky.geojson), \"dataset\": $(jq '.datasets[0]' manifest.json)}"
# živý test zverejneného manifestu a všetkých zdrojov
curl -s 'https://datovamapa.sk/api/validate?manifestUrl=https://www.obec-priklad.sk/datovamapa/manifest.json'
```

Odpoveď: `{ valid, summary, errors: [{ path, code, message, hint? }], warnings: [...] }`, pri živom teste navyše `datasets[]` s dopytom, dobou odozvy a počtom objektov. Význam kódov je v [API portálu](https://datovamapa.sk/dokumentacia/api.md#kody-nalezu).

### 8. Odovzdanie človeku {#8-predani-cloveku}

Na záver zhrňte:

- URL manifestu a zoznam sád (id, názov, typ zdroja, počet objektov),
- výsledok živého testu (`summary`, zvyšné varovania a prečo zostali),
- čo musí človek potvrdiť: **licenciu a atribúciu**, že dáta neobsahujú osobné údaje, kontakt pre portál,
- ako dáta aktualizovať (skript, cron, zdroj pravdy).

Keď človek potvrdí licenciu a obsah, zaregistrujte manifest: `POST https://datovamapa.sk/api/registration` s `{ "manifestUrl": "…" }` alebo MCP nástroj `register_provider`. Dáta budú dostupné ako neschválené (s varovaním, mimo katalógu), kým ich prevádzkovateľ neschváli. Po každej zmene manifestu čakajú na nové schválenie. Podrobnosti: [registrácia](https://datovamapa.sk/dokumentacia/pre-poskytovatelov.md#5-registrace).

## Pravidlá {#pravidla}

- **Nezverejňujte osobné údaje** (GDPR). Pri pochybnosti dáta agregujte alebo vynechajte a opýtajte sa.
- Nevymýšľajte licenciu, zdroj ani aktuálnosť dát.
- Do `properties` ani `dm` nevkladajte HTML; portál všetko zobrazuje ako text.
- Do URL nedávajte tajné kľúče – manifest je verejný.
- Nemeňte `provider.id` ani `dataset.id` po zverejnení.
- Kľúče `bbox`, `zoom`, `limit`, `cursor`, `lang`, `protocol` nepoužívajte pre vlastné parametre.
- Max. 5 000 objektov a 15 MB na odpoveď, odpoveď do 10 s (cieľom je do 1 s).

## Kritériá hotovej práce {#kriteria-hotove-prace}

- [ ] Manifest je dostupný na HTTPS a živý test validátora vracia `"valid": true`.
- [ ] Každá sada má `description`, `keywords`, `useCases`, `category` a (pri GeoJSON) `fields`.
- [ ] Licencia a atribúcia sú potvrdené človekom.
- [ ] Súradnice sú WGS84 `[lon, lat]`, žiadne varovanie `swapped_coordinates` ani `outside_coverage`.
- [ ] Žiadna sada nevracia v teste 0 objektov (`empty_response`), ak to nie je zámer.
- [ ] Objekty, ktoré majú hodnotu za viac období, posielajú `dm.chart` (žiadne `missing_trend_chart` ani `trend_without_chart`).
- [ ] Odozva endpointov je pod 3 s (`slow_response`).
- [ ] Dáta neobsahujú osobné údaje.
- [ ] Je opísané, ako sa dáta aktualizujú.

## Zadanie pre agenta (na skopírovanie) {#zadani-pro-agenta-ke-zkopirovani}

Človek môže svojmu agentovi dať tento text:

```text
Priprav naše priestorové dáta pre portál DátováMapa (https://datovamapa.sk).
Postupuj podľa návodu https://datovamapa.sk/dokumentacia/pre-ai-agentov.md
(rozcestník dokumentácie: https://datovamapa.sk/llms.txt, MCP server: https://datovamapa.sk/mcp).
Zdroje dát: <popíš databázy, súbory, služby>.
Kam zverejniť: <web / server / repozitár>.
Licencia: <napr. CC BY 4.0, atribúcia „© Obec Príklad“> – inú si nevymýšľaj.
Hotovo je, keď živý test validátora vracia valid: true a prejdeš kritériá hotovej práce.
Na konci mi odovzdaj zhrnutie podľa kroku 8.
```

---

<!-- https://datovamapa.sk/dokumentacia/ai-asistenti.md -->

# Dáta DátovejMapy vo vašom AI asistentovi {#data-datovemapy-ve-vasem-ai-asistentovi}

DátováMapa spája verejné dáta s polohou z desiatok zdrojov: záplavové územia, radón, hluk, chránené územia, kvalitu ovzdušia, pamiatky, štatistiky obcí, výsledky volieb a ďalšie. Pripojte ju k svojmu AI asistentovi a pýtajte sa bežnou rečou. Asistent si dáta načíta sám, vyloží ich a uvedie zdroj.

Je to zadarmo, bez registrácie a bez kľúča. Stačí asistent, ktorý vie MCP (Model Context Protocol), alebo aplikácia, ktorá volá HTTP API.

## Na čo sa môžete opýtať {#na-co-se-muzete-zeptat}

- *„Je adresa Hlavná 1 v Košiciach v záplavovom území? A aký je tam radónový index?“*
- *„Kupujem pozemok v obci Nová Ves pri Trenčíne. Čo by som mal vedieť – riziká, ochrana prírody, hluk?“*
- *„Aký je teraz vzduch v Žiline a kde je najbližšia meracia stanica k Hlavnej 5 v Bratislave?“*
- *„Aká bola volebná účasť v Prešove a ako dopadli strany?“*
- *„Ktoré kultúrne pamiatky sú do 500 m od Hlavnej 2 v Bratislave?“*

Asistent nájde miesto v registri adries, vyberie vhodné dátové sady a opýta sa ich na bod alebo okolie. Odpovie s číslami, zdrojom a odkazom na mapu, kde si výsledok overíte.

## Pripojenie {#pripojeni}

Adresa MCP servera: `https://datovamapa.sk/mcp` (Streamable HTTP, bez prihlásenia).

| Asistent | Ako pripojiť |
|---|---|
| Claude (web, desktop) | v nastaveniach konektorov pridajte vlastný konektor s adresou MCP servera |
| Claude Code | `claude mcp add --transport http datovamapa https://datovamapa.sk/mcp` |
| ChatGPT | v režime pre vývojárov (developer mode) pridajte vlastný konektor / aplikáciu s adresou MCP servera |
| iný klient MCP | konfigurácia nižšie |

```json
{ "mcpServers": { "datovamapa": { "type": "http", "url": "https://datovamapa.sk/mcp" } } }
```

Názvy položiek v nastaveniach sa pri jednotlivých asistentoch menia; hľadajte „konektory“, „MCP“ alebo „vlastné nástroje“.

Asistent bez MCP môže použiť [HTTP API](https://datovamapa.sk/dokumentacia/api.md#misto-a-okoli) popísané v [OpenAPI](https://datovamapa.sk/openapi.json), napr. ako akcie vlastného GPT.

## Nástroje {#nastroje}

| Nástroj | Na čo |
|---|---|
| `find_place` | adresa, ulica alebo obec → súradnice |
| `nearby` | čo je v bode a okolí: objekty podľa vzdialenosti, v rastrových sadách (záplavy, radón, hluk…) hodnota priamo v bode |
| `summary` | prehľad sady za ktorúkoľvek obec alebo celé Slovensko: počty, kategórie, najvyššie a najnižšie hodnoty |
| `catalog` | aké dáta portál má, s vyhľadávaním podľa textu a miesta |
| `fetch_data` | surové dáta GeoJSON vrátane geometrií (na vlastnú analýzu) |

Vstupy a výstupy podrobne: [API portálu a MCP server](https://datovamapa.sk/dokumentacia/api.md#mcp-server).

## Pre firmy a vývojárov {#pro-firmy-a-vyvojare}

- HTTP API (`/api/places`, `/api/nearby`, `/api/summary/…`, `/api/data/…`) je verejné, bez kľúča, s CORS `*` (výnimkou sú [sady len na zobrazenie](https://datovamapa.sk/dokumentacia/api#data)). Odpovede sú v JSON a portál ich drží v cache.
- Vlastný agent dostane rovnaké dáta ako mapa: GeoJSON sady načítava portál cez svoju proxy s cache, rastrové sady sa pýta na bod priamo u zdroja (WMS GetFeatureInfo, ArcGIS identify).
- Každá sada má vlastnú licenciu a atribúciu (`attribution`, `license` vo výsledku aj v [katalógu](https://datovamapa.sk/zdroje.md)). Pri ďalšom použití dát ich dodržiavajte.
- Ak chcete do portálu pridať vlastné dáta, začnite [návodom pre poskytovateľov](https://datovamapa.sk/dokumentacia/pre-poskytovatelov.md).

## Čo je dobré vedieť {#co-je-dobre-vedet}

- **Dáta sú informatívne.** Portál preberá dáta od poskytovateľov a za ich správnosť neručí. Právne záväzné informácie (záplavové územia, územný plán, kataster) overte na úrade alebo u poskytovateľa. Asistent má v odpovedi uviesť zdroj a dátum dát.
- **Prázdny výsledok nie je vždy „nič tu nie je“.** Pri rastrových sadách stav `ok` bez nálezov znamená, že v bode nič nie je (napr. mimo záplavového územia). Stav `unavailable` znamená, že zdroj je len obraz a hodnotu v bode neposkytuje. Vtedy pomôže odkaz na mapu.
- **Súhrn za obec** funguje pre každú obec Slovenska. Pri rovnomenných obciach (Nová Ves) sa asistent opýta na okres. Konkrétne adresy zvládne `nearby`.
- **Rozsah dopytu:** okolie najviac 20 km, najviac 12 sád v jednom dopyte. Sady, ktoré sa načítavajú len pri veľkom priblížení (stromy, kontajnery), okolie zmenšia a povedia o tom.
- **Súkromie:** portál nepotrebuje účet ani nič o vás. Adresu, na ktorú sa asistent pýta, posiela len do vyhľadávania v registri adries a súradnice zdrojom dát.

---

<!-- https://datovamapa.sk/dokumentacia/pre-poskytovatelov.md -->

# Pripojte svoje dáta do DátovejMapy {#pripojte-sva-data-do-datovemapy}

DátováMapa je otvorený portál, ktorý zobrazuje dáta z mnohých zdrojov v jednej mape. Nemusíte riešiť mapu, štýly ani mapový server. Stačí zverejniť **manifest** (popis vašich dát) a **dáta ako GeoJSON**. Portál sa na dáta spýta v okamihu, keď ich používateľ zapne, vykreslí ich podľa vášho popisu a uvedie vás ako zdroj.

> **Pripravuje dáta AI agent?** Dajte mu odkaz na [návod pre AI agentov](https://datovamapa.sk/dokumentacia/pre-ai-agentov.md). Obsahuje postup krok za krokom, šablóny kódu a kritériá hotovej práce. Celá dokumentácia je strojovo čitateľná: [llms.txt](https://datovamapa.sk/llms.txt), [MCP server](https://datovamapa.sk/dokumentacia/api.md#mcp-server), [validátor](https://datovamapa.sk/dokumentacia/api.md#validator).

## Tri spôsoby pripojenia {#tri-zpusoby-pripojeni}

| Spôsob | Kedy | Čo potrebujete |
|---|---|---|
| **Statické súbory** | do zhruba 2 000 objektov, dáta sa menia občas | `manifest.json` + `data.geojson` na ľubovoľnom webe (aj GitHub Pages) |
| **Vlastný endpoint** | veľké alebo živé sady | HTTP GET endpoint, ktorý filtruje podľa výrezu mapy (`bbox`) |
| **Existujúce WMS / dlaždice** | máte mapový server | iba manifest so zdrojom typu `raster` |

## 1. Manifest {#1-manifest}

Jeden JSON, ktorý popisuje vás a vaše dátové sady. Povinné je len minimum: `protocol`, `provider.id`, `provider.name` a pri každej sade `id`, `title`, `source` a `presentation`. Všetko ostatné je voliteľné, ale pomáha ľuďom aj AI asistentovi portálu dáta nájsť a pochopiť (`description`, `keywords`, `useCases`, `fields`).

Najmenší rozumný manifest (statické súbory, relatívna URL sa počíta od adresy manifestu):

```json manifest
{
  "protocol": "0.1",
  "provider": { "id": "obec-priklad", "name": "Obec Príklad", "homepage": "https://www.obec-priklad.sk/" },
  "license": { "name": "CC BY 4.0", "attribution": "© Obec Príklad" },
  "datasets": [
    {
      "id": "lavicky",
      "title": "Lavičky v obci",
      "description": "Verejné lavičky udržiavané obcou.",
      "category": "society",
      "keywords": ["lavička", "posedenie", "odpočinok", "park"],
      "useCases": ["tourism"],
      "source": { "type": "geojson", "url": "lavicky.geojson", "mode": "full" },
      "presentation": { "type": "circle", "color": "#0d9488" },
      "fields": [{ "key": "umisteni", "label": "Umiestnenie", "primary": true }]
    }
  ]
}
```

Úplný príklad so všetkými možnosťami (filtre, farby podľa hodnôt, zoskupovanie, kartogram, WMS): [manifest-complete.json](https://datovamapa.sk/priklady/manifest-complete.json).

## 2. Dáta {#2-data}

Odpoveďou je GeoJSON `FeatureCollection` so súradnicami vo WGS84 v poradí `[lon, lat]`. Člen `dm` je voliteľný: nadpis a odkaz pri objekte, celkový počet objektov, platnosť odpovede.

```json data
{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "id": 1842,
      "geometry": { "type": "Point", "coordinates": [21.2611, 48.7164] },
      "properties": { "druh": "papier", "vyvoz": "2026-10-01" },
      "dm": { "title": "Kontajner Hlavná ulica", "url": "https://www.mesto-priklad.sk/odpady/1842" }
    }
  ],
  "dm": { "total": 1, "ttl": 3600 }
}
```

### Ako sa portál pýta {#jak-se-portal-pta}

Režim `full` – celá sada jedným dopytom. Režim `bbox` – portál pošle výrez mapy zarovnaný na dlaždice a úroveň priblíženia, plus filtre nastavené používateľom:

```http
GET https://data.mesto-priklad.sk/datovamapa/kontejnery?bbox=21.093750,48.690960,21.269531,48.806863&zoom=11&limit=5000&lang=sk&protocol=0.1&druh=papier,plast
Accept: application/geo+json, application/json
User-Agent: DatovaMapa/0.1 (+https://datovamapa.sk/dokumentacia/pre-poskytovatelov)
```

Vráťte najviac `limit` objektov (max. 5 000). Pri veľkých sadách nastavte `coverage.minZoom`, alebo pri malom priblížení vracajte agregované dáta.

## 3. Vizualizácia {#3-vizualizace}

| `presentation.type` | Geometria | Typické použitie |
|---|---|---|
| `circle` | body | miesta, farba podľa kategórie, veľkosť podľa hodnoty, zoskupovanie |
| `heatmap` | body | hustota výskytu, voliteľne vážená hodnotou |
| `line` | línie | trasy, siete, toky |
| `fill` | plochy | územia, kartogram podľa hodnoty |
| `raster` | dlaždice | hotové mapové vrstvy (WMS, XYZ); legendu uveďte v `legend` |
| `auto` | čokoľvek | predvolené vykreslenie |

Farby sú vždy v hex zápise. Farba môže závisieť od vlastnosti objektu – podľa kategórie (`categorical`), plynulo (`interpolate`) alebo po intervaloch (`step`). Podrobnosti v [protokole](https://datovamapa.sk/dokumentacia/protokol.md#presentation). Ďalšie typy budeme pridávať; typ, ktorý portál nepozná, vykreslí ako `auto`.

Dáta, ktorých hodnota sa mení v čase (počet obyvateľov, ceny, merania), majú v štandarde vlastné zobrazenie: pri každom objekte pošlite rad hodnôt v `dm.chart` a portál ho ukáže ako graf v detaile. Ak ide hlavne o to, či hodnota rastie, alebo klesá, nastavte `color: { "type": "trend" }` – portál z grafu sám zafarbí objekty na zeleno, sivo a červeno a doplní legendu. Podrobnosti v [protokole](https://datovamapa.sk/dokumentacia/protokol.md#vyvoj-v-case-a-trend).

## 4. Overenie {#4-overeni}

Skôr než manifest pošlete, nechajte ho skontrolovať validátorom. Vracia chyby aj odporúčania so stabilnými kódmi a radami, ako ich opraviť:

```bash
curl -X POST https://datovamapa.sk/api/validate -H 'Content-Type: application/json' --data @manifest.json
curl 'https://datovamapa.sk/api/validate?manifestUrl=https://data.mesto-priklad.sk/datovamapa/manifest.json'
```

Druhý príkaz urobí živý test: stiahne manifest a na každú sadu pošle rovnaký dopyt, aký by poslal portál.

## 5. Registrácia {#5-registrace}

Keď validátor hlási `"valid": true`, zaregistrujte URL manifestu na [datovamapa.sk/registracia](https://datovamapa.sk/registracia), cez API alebo MCP nástroj `register_provider`:

```bash
curl -X POST https://datovamapa.sk/api/registration -H 'Content-Type: application/json' --data '{"manifestUrl": "https://data.mesto-priklad.sk/datovamapa/manifest.json"}'
```

Portál manifest znova skontroluje živým testom. Potom platí:

- **Dáta sú hneď dostupné, ale neschválené.** Každá sada má svoju stránku `/mapa/{provider}/{dataset}`. Pred zobrazením dát sa tam ukáže varovanie, že dáta nahrala tretia strana a prevádzkovateľ ich zatiaľ nepreveril. Dáta sa načítajú až po potvrdení používateľom. Stránka je mimo vyhľadávačov. Prehľad je na [neschválených dátach](https://datovamapa.sk/neschvalene-data).
- **Po schválení prevádzkovateľom** sa dáta objavia v [katalógu](https://datovamapa.sk/zdroje.md), vo vyhľadávaní a na stránkach za obce.
- **Schválenie platí pre konkrétny obsah manifestu.** Ak manifest zmeníte, dáta sa do nového schválenia zobrazujú opäť len s varovaním. Dáta samotné (GeoJSON) môžete meniť priebežne.
- `provider.id` je prvou registráciou obsadené. Nemeňte ho, ani URL manifestu.

Registráciou potvrdzujete, že dáta smiete zverejniť pod uvedenou licenciou a že neobsahujú osobné údaje. Prevádzkovateľ môže registráciu kedykoľvek zamietnuť; dáta potom z portálu zmiznú.

## Cache a podmienky {#cache-a-podminky}

- Odpovede držíme v cache po dobu `cache.ttl` (predvolene 5 minút), aby sa váš server nezaťažoval opakovanými dopytmi. Pri výpadku môžeme krátko zobraziť posledné známe dáta s upozornením.
- V záujme rýchlosti, úspory vašich zdrojov, udržateľnosti, prepájania súvislostí medzi zdrojmi a práce s veľkými dátami si dáta môžeme ukladať aj do vlastnej dátovej vrstvy. Ak to nechcete, nastavte pri sade `cache.store: false`.
- Vždy vás uvádzame ako zdroj podľa údajov v licencii manifestu.
- Na dáta sa pýtame len pri registrovaných poskytovateľoch, s časovým limitom 10 s a limitom veľkosti odpovede 15 MB.
- Nezverejňujte osobné údaje. Za obsah dát zodpovedá poskytovateľ.

## Odkazy {#odkazy}

- [Protokol 0.1 – úplná špecifikácia](https://datovamapa.sk/dokumentacia/protokol.md)
- [Návod pre AI agentov](https://datovamapa.sk/dokumentacia/pre-ai-agentov.md)
- [API portálu, validátor a MCP server](https://datovamapa.sk/dokumentacia/api.md)
- [JSON Schema manifestu](https://datovamapa.sk/schema/0.1/manifest.json) · [JSON Schema dát](https://datovamapa.sk/schema/0.1/data.json) · [OpenAPI kontrakt poskytovateľa](https://datovamapa.sk/schema/0.1/provider-openapi.json)
- Referenčná implementácia (vymyslené dáta, v katalógu portálu nie je): [manifest](https://datovamapa.sk/api/sample/manifest), [dáta](https://datovamapa.sk/api/sample/krajska-mesta)

---

<!-- https://datovamapa.sk/dokumentacia/protokol.md -->

# Protokol DátovejMapy 0.1 {#protokol-datovamapa-0-1}

Normatívny popis rozhrania medzi poskytovateľom dát a portálom. Pri rozpore s inou dokumentáciou platí tento dokument a strojové schémy:

- [JSON Schema manifestu](https://datovamapa.sk/schema/0.1/manifest.json) a [JSON Schema dát](https://datovamapa.sk/schema/0.1/data.json) – generované zo zod schém v `src/lib/protocol/`,
- [OpenAPI kontrakt poskytovateľa](https://datovamapa.sk/schema/0.1/provider-openapi.json).

Postup prípravy dát krok za krokom (najmä pre AI agentov) je v [návode pre AI agentov](https://datovamapa.sk/dokumentacia/pre-ai-agentov.md), zrozumiteľný úvod v [sprievodcovi pre poskytovateľov](https://datovamapa.sk/dokumentacia/pre-poskytovatelov.md). Platné vzory: [manifest-complete.json](https://datovamapa.sk/priklady/manifest-complete.json), [data-points.json](https://datovamapa.sk/priklady/data-points.json).

## Prehľad {#prehled}

```
Poskytovateľ                         Portál DátovaMapa                 Prehliadač
─────────────                        ─────────────────                 ─────────
manifest.json  ◄── GET (cache 10 min) ── register → katalóg ─────────► /api/catalog
data endpoint  ◄── GET ?bbox&zoom&… ──── proxy + validácia + cache ───► /api/data/{provider}/{dataset}
rastrové dlaždice ◄───────────────────────────────────────────────────── priamo z prehliadača
```

## Všeobecné pravidlá {#obecna-pravidla}

- Formát JSON, kódovanie UTF-8, súradnice WGS84 (EPSG:4326) v poradí `[lon, lat]`.
- Komunikácia cez HTTPS (http len pre `localhost` pri vývoji).
- **Neznáme polia sa ignorujú.** Neznámy typ `presentation` sa vykreslí ako `auto`.
- Verzia `protocol` v tvare `major.minor`. Portál prijme manifest s rovnakou hlavnou verziou.
- Identifikátory (`provider.id`, `dataset.id`): malé písmená bez diakritiky, číslice, pomlčky, max. 64 znakov. Globálny kľúč sady je `provider/dataset`.
- Farby len v hex zápise (`#rgb`, `#rrggbb`, `#rrggbbaa`).

## Manifest {#manifest}

| Pole | Povinné | Popis |
|---|---|---|
| `protocol` | áno | Verzia protokolu, napr. `"0.1"` |
| `provider.id` | áno | Identifikátor; musí zodpovedať id v registri portálu |
| `provider.name` | áno | Názov zobrazovaný ako zdroj |
| `provider.description`, `homepage`, `logo`, `contact` | nie | |
| `provider.managedBy` | nie | `provider` (predvolené) / `portal` – manifest pre verejnú službu udržiava DátovaMapa |
| `license` | nie | `{ name, url?, attribution }` – predvolená licencia všetkých sád |
| `datasets[]` | áno | 1–200 dátových sád s unikátnym `id` |

### Dátová sada {#datova-sada}

| Pole | Povinné | Popis |
|---|---|---|
| `id`, `title` | áno | |
| `description` | nie | |
| `category` | nie | `territory`, `nature`, `water`, `risks`, `energy`, `transport`, `society`, `economy`, `infrastructure`, `sample`, `other`; iná hodnota → Ostatné |
| `tags`, `keywords` | nie | Na vyhľadávanie a budúceho asistenta |
| `useCases` | nie | Účely, pre ktoré sa sada hodí: `construction`, `housing`, `land-purchase`, `agriculture`, `investment`… |
| `coverage` | nie | `{ bbox?, area?, minZoom?, maxZoom? }` – pod `minZoom` portál dáta nenačítava |
| `temporal` | nie | `{ updated?, frequency?, param? }` – `param` = kľúč parametra, ktorým sa volí obdobie (pozri [časový filter](https://datovamapa.sk/dokumentacia/protokol.md#casovy-filtr)) |
| `license` | nie | Prepisuje licenciu poskytovateľa |
| `source` | áno | Odkiaľ brať dáta (pozri nižšie) |
| `presentation` | áno | Ako dáta vykresliť (pozri nižšie) |
| `fields[]` | nie | Popis vlastností objektov: `key`, `label`, `type`, `unit`, `decimals`, `description`, `primary` |
| `params[]` | nie | Filtre pre používateľa (pozri nižšie) |
| `cache` | nie | `{ ttl?: sekundy, store?: boolean }` |

### `source` {#source}

**`geojson`** – natívny formát.

```json
{ "type": "geojson", "url": "/data/kontajnery", "mode": "bbox", "maxFeatures": 5000 }
```

- `url` môže byť relatívna voči URL manifestu. Zdrojom môže byť aj **statický súbor** (`lavicky.geojson` vedľa `manifest.json` na ľubovoľnom webhostingu) – v režime `full` portál žiadne query parametre nevyžaduje a súbor je platný endpoint.
- `mode: "full"` – celá sada jedným dopytom (malé sady). `mode: "bbox"` – portál sa pýta na výrez mapy.
- `maxFeatures` ≤ 5000.

**`raster`** – hotové dlaždice, prehliadač ich načítava priamo zo zdroja.

```json
{ "type": "raster", "tiles": ["https://…/{z}/{x}/{y}.png"], "tileSize": 256, "minZoom": 0, "maxZoom": 19 }
```

Šablóny podporujú `{z}/{x}/{y}` aj `{bbox-epsg-3857}` (WMS GetMap). Len https.

### `presentation` {#presentation}

| `type` | Geometria | Voľby |
|---|---|---|
| `circle` | body | `color`, `radius`, `opacity`, `strokeColor`, `strokeWidth`, `label`, `cluster` |
| `heatmap` | body | `weight`, `radius`, `intensity`, `colors[]`, `opacity` |
| `line` | línie | `color`, `width`, `opacity`, `dash[]`, `label` |
| `fill` | plochy | `color`, `opacity`, `outlineColor`, `outlineWidth`, `label` |
| `raster` | dlaždice | `opacity` |
| `auto` | čokoľvek | `color` |

Všetky typy majú voliteľnú `legend: [{ label, color }]` (max. 20 položiek). Portál ju ukazuje v legende priamo v mape a vo výbere vrstiev. Pri vektorových typoch ju vie odvodiť z farieb, pri `raster` nie – farby sú zapečené v obrázkoch dlaždíc, takže legendu rastra uveďte ručne (napr. prevzatím z legendy WMS / ArcGIS služby).

**Farba** (`color`) je buď hex reťazec, alebo pravidlo podľa vlastnosti objektu:

```json
{ "field": "druh", "type": "categorical", "values": { "papier": "#2563eb" }, "default": "#64748b" }
{ "field": "hodnota", "type": "interpolate", "stops": [[0, "#f7fcb9"], [100, "#004529"]] }
{ "field": "hodnota", "type": "step", "default": "#eee", "stops": [[10, "#fc8"], [50, "#e34"]] }
{ "type": "trend" }
```

`trend` farbí objekty podľa toho, či ich hodnota v čase rastie, stagnuje, alebo klesá. Počíta ho portál z grafu vývoja `dm.chart` – pozri [vývoj v čase a trend](https://datovamapa.sk/dokumentacia/protokol.md#vyvoj-v-case-a-trend).

**Číslo** (`radius`, `width`, `weight`) je číslo alebo `{ "field", "type": "interpolate", "stops": [[hodnota, číslo], …] }`.

**Popisok** (`label`): `{ field, minZoom?, color?, size? }`.

### `params` {#params}

Filter, ktorý používateľ nastaví v portáli; portál ho pošle ako query parameter `key=value`.

| `type` | Hodnota v dopyte |
|---|---|
| `enum` | `key=a` (z `options`) |
| `multi-enum` | `key=a,b,c` |
| `number` | `key=42` (v rozsahu `min`–`max`) |
| `range` | `key=od,do` |
| `boolean` | `key=true` / `false` |
| `date` | `key=2026-10-06` |
| `date-range` | `key=2026-01-01,2026-12-31` |
| `text` | `key=…` (max. 200 znakov) |

Kľúče `bbox`, `zoom`, `limit`, `cursor`, `lang`, `protocol` sú rezervované. Portál posiela len deklarované parametre a hodnoty vopred overí; nevyplnený parameter nahradí `default`.

### Časový filter {#casovy-filtr}

Dáta v čase (nehody, merania, udalosti) majú jeden parameter pre obdobie a odkazujú naň z `temporal.param`. Portál ho potom neukazuje medzi ostatnými filtrami, ale ako časovú os v okne pod legendou: posuvník obdobia a stĺpcový graf po rokoch, v ktorom sa dá obdobie vybrať kliknutím alebo ťahaním. Zvolené obdobie je vidieť aj pri vrstve v legende.

- Typ `range` s rokmi – `min` a `max` sú prvý a posledný rok dát, hodnota `od,do` (napr. `2019,2023`, jeden rok `2023,2023`). Objekty za celé obdobie vracajte dohromady (súhrnne), nie po jednotlivých rokoch.
- Typ `date-range` – obdobie po dňoch, `2026-01-01,2026-06-30`.

```json manifest
{
  "protocol": "0.1",
  "provider": { "id": "mesto-priklad", "name": "Mesto Príklad" },
  "license": { "name": "CC BY 4.0", "attribution": "© Mesto Príklad" },
  "datasets": [{
    "id": "nehody",
    "title": "Dopravné nehody",
    "description": "Nehody evidované políciou podľa následkov.",
    "category": "transport",
    "keywords": ["nehoda", "dopravná nehoda", "bezpečnosť", "zranenie", "križovatka"],
    "useCases": ["transport", "housing"],
    "coverage": { "bbox": [21.15, 48.65, 21.35, 48.78], "minZoom": 12 },
    "temporal": { "frequency": "ročne", "param": "obdobi" },
    "source": { "type": "geojson", "url": "https://data.mesto-priklad.sk/datovamapa/nehody", "mode": "bbox", "maxFeatures": 5000 },
    "presentation": {
      "type": "circle",
      "color": { "field": "nasledky", "type": "categorical", "values": { "zranenie": "#dc2626", "hmotná škoda": "#facc15" }, "default": "#facc15" }
    },
    "fields": [
      { "key": "nasledky", "label": "Následky", "type": "string", "primary": true },
      { "key": "datum", "label": "Dátum", "type": "date" }
    ],
    "params": [{ "key": "obdobi", "label": "Obdobie", "type": "range", "min": 2015, "max": 2025, "step": 1, "default": "2025,2025" }]
  }]
}
```

Graf kreslí portál z `dm.timeline` v odpovedi (pozri [dátová odpoveď](https://datovamapa.sk/dokumentacia/protokol.md#datova-odpoved)). Pri hodnotách v čase, kde počty objektov nedávajú zmysel (počet obyvateľov, cena), pošlite namiesto neho súhrnný vývoj v `dm.chart` – portál ho pri posuvníku ukáže ako čiarový graf, pozri [vývoj v čase a trend](https://datovamapa.sk/dokumentacia/protokol.md#vyvoj-v-case-a-trend). Bez oboch ostane len posuvník obdobia.

### Vývoj v čase a trend {#vyvoj-v-case-a-trend}

Štandardné zobrazenie dát, ktorých hodnota sa pri objekte mení v čase – počet obyvateľov obce, cena, nameraná koncentrácia, návštevnosť. Kedykoľvek majú dáta takýto rad, posielajte ho; portál z neho sám kreslí graf a vie podľa neho farbiť.

- **Graf vývoja.** Ak má objekt hodnotu za viac období, pošlite ju v `feature.dm.chart` (pozri [dátová odpoveď](https://datovamapa.sk/dokumentacia/protokol.md#datova-odpoved)). Portál ju ukáže v detaile objektu ako čiarový graf s hodnotou za zvolené obdobie a zmenou oproti jeho začiatku. Platí to aj pre kartogramy, kde sa rok volí parametrom: pošlite rad za všetky roky a zvolený rok ako `highlight` s rovnakým `from` a `to`. Keď sada farbí podľa číselnej hodnoty, obdobie sa volí parametrom a graf chýba, validátor to hlási ako `missing_trend_chart`.
- **Súhrnný graf pri legende.** Vývoj za celé územie sady alebo za výrez (napr. počet obyvateľov Slovenska) pošlite v `dm.chart` odpovede – rovnaký tvar ako graf objektu. Portál ho ukáže pri časovom filtri, kým používateľ žiadny objekt nerozklikne, a zvolené obdobie vyznačí podľa `highlight`. Ak sada farbí podľa trendu, dostane čiara farbu trendu celku – je potom vidieť, či zelené bodky len nekopírujú celoštátny vývoj.
- **Farba podľa trendu.** Ak je zmyslom sady zmena („rastie, alebo ubúda?“), nastavte `color: { "type": "trend" }`. Portál z grafu každého objektu vypočíta priemernú zmenu za jedno obdobie v % počiatočnej hodnoty – vo zvýraznenom období (`highlight`), inak za celý rad. Od `threshold` (predvolene 0,5 %) vyššie hodnota **rastie** (zelená), od −`threshold` nižšie **klesá** (červená), medzi tým **stagnuje** (sivá). Farby možno prepísať cez `colors: { up, flat, down }`, napríklad keď je rast nežiaduci. Legendu portál odvodí sám a graf v detaile zafarbí rovnako ako objekt v mape. Objekt bez grafu ostane svetlosivý (`trend_without_chart`).

Trend vychádza z relatívnej zmeny, hodí sa preto pre kladné veličiny (počty, ceny, koncentrácie). Hodnoty okolo nuly, ako saldo sťahovania, farbite cez `interpolate` a vývoj ukážte len grafom.

```json manifest
{
  "protocol": "0.1",
  "provider": { "id": "kraj-priklad", "name": "Kraj Príklad" },
  "license": { "name": "CC BY 4.0", "attribution": "© Kraj Príklad" },
  "datasets": [{
    "id": "vyvoj-obyvatel",
    "title": "Vývoj počtu obyvateľov obcí",
    "description": "Kde obyvateľov pribúda a kde ubúda. Farba podľa trendu vo zvolenom období, v detaile obce graf po rokoch.",
    "category": "society",
    "keywords": ["obyvatelia", "vývoj", "trend", "rast", "vyľudňovanie"],
    "useCases": ["housing", "public-administration"],
    "temporal": { "frequency": "ročne", "param": "obdobi" },
    "source": { "type": "geojson", "url": "https://data.kraj-priklad.sk/datovamapa/obyvatele" },
    "presentation": { "type": "circle", "color": { "type": "trend", "threshold": 0.5 }, "radius": 7 },
    "fields": [
      { "key": "nazev", "label": "Obec", "type": "string", "primary": true },
      { "key": "obyvatel", "label": "Obyvateľov na konci obdobia", "type": "integer" }
    ],
    "params": [{ "key": "obdobi", "label": "Obdobie", "type": "range", "min": 2015, "max": 2025, "step": 1, "default": "2015,2025" }]
  }]
}
```

Odpoveď potom pri každej obci posiela rad za všetky roky a zvolené obdobie v `highlight`, napríklad `{ "from": "2015", "to": "2025" }`.

## Dátový dopyt {#datovy-dotaz}

```
GET {source.url}?bbox=minLon,minLat,maxLon,maxLat&zoom=10&limit=5000&lang=sk&protocol=0.1[&cursor=…][&{params}]
Accept: application/geo+json, application/json
User-Agent: DatovaMapa/0.1 (+https://datovamapa.sk/dokumentacia/pre-poskytovatelov)
```

- `bbox` a `zoom` len v režime `bbox`. Výrez je **zarovnaný na dlaždice** úrovne `zoom` (celé číslo), takže blízke pohľady vedú na rovnaký dopyt – poskytovateľ aj portál môžu odpovede cachovať.
- `limit` = koľko objektov portál najviac spracuje.
- Časový limit odpovede 10 s, veľkosť max. 15 MB.

## Dátová odpoveď {#datova-odpoved}

GeoJSON `FeatureCollection` (RFC 7946). Podporované geometrie: `Point`, `MultiPoint`, `LineString`, `MultiLineString`, `Polygon`, `MultiPolygon`. Objekty s `geometry: null` sa preskočia.

Voliteľné rozšírenia:

```json
{
  "type": "FeatureCollection",
  "features": [{
    "type": "Feature", "id": 1, "geometry": {…}, "properties": {…},
    "dm": { "title": "…", "description": "…", "url": "https://…", "color": "#e11d48", "chart": {…} }
  }],
  "dm": { "generated": "2026-10-06T08:00:00Z", "ttl": 3600, "total": 1, "truncated": false, "next": "…", "notice": "…", "timeline": […] }
}
```

- `feature.dm` – nadpis a popis v detaile, odkaz na detail pri zdroji, prepísanie farby, graf vývoja.
- `feature.dm.chart` – vývoj jednej hodnoty objektu v čase, ktorý portál nakreslí v detaile objektu ako čiarový graf s hodnotou za posledné obdobie (napr. počet obyvateľov obce po rokoch) a z ktorého počíta farbu podľa trendu. `label` hovorí, čo graf ukazuje, nepovinné `unit`, `decimals`, `note` (poznámka pod grafom, napr. o zmene metodiky) a `highlight: { from, to }` – zvýraznené obdobie, typicky zvolené v časovom filtri; portál ho podfarbí, ukáže hodnotu na jeho konci a zmenu aj trend počíta od jeho začiatku. Rovnaké `from` a `to` označí jedno obdobie, napr. rok zvolený pri kartograme – graf sa na ňom zastaví. `points` sú dvojice `{ period, value }` zoradené od najstaršieho obdobia – `period` je rok, mesiac alebo deň ako pri `dm.timeline`. 2–100 bodov. Posielajte ho vždy, keď má objekt hodnotu za viac období (pozri [vývoj v čase a trend](https://datovamapa.sk/dokumentacia/protokol.md#vyvoj-v-case-a-trend)).
- `dm.ttl` – platnosť odpovede (portál použije menšie z `cache.ttl` a `dm.ttl`).
- `dm.total`, `dm.truncated` – koľko objektov celkom / či je odpoveď skrátená.
- `dm.notice` – krátke oznámenie pre používateľa (zobrazí sa pri vrstve).
- `dm.next` – kurzor na ďalšiu stránku (portál ho zatiaľ nevyužíva, rezervované).
- `dm.timeline` – počty objektov **vo výreze** po obdobiach za celý čas, ktorý sada pokrýva, nezávisle od zvoleného obdobia a od `limit` (spočítajte ich agregačným dopytom, nie z vrátených objektov). Portál z nich kreslí graf pri legende. `period` je rok (`2023`), mesiac (`2023-05`) alebo deň; nepovinné `values` rozdelí počet podľa hodnôt vlastnosti z `color.field` a graf ich zafarbí ako legendu. Max. 400 období.
- `dm.chart` – súhrnný vývoj hodnoty za celé územie sady alebo výrez (napr. počet obyvateľov Slovenska), rovnaký tvar ako `feature.dm.chart`. Portál ho ukáže pri časovom filtri ako čiarový graf, keď odpoveď neposiela `dm.timeline`.

```json data
{
  "type": "FeatureCollection",
  "features": [],
  "dm": {
    "timeline": [
      { "period": "2024", "count": 2366, "values": { "zranenie": 701, "hmotná škoda": 1665 } },
      { "period": "2025", "count": 1894, "values": { "zranenie": 652, "hmotná škoda": 1242 } }
    ]
  }
}
```

Súhrnný vývoj za celé územie namiesto počtov objektov (zvolené obdobie 2023–2025):

```json data
{
  "type": "FeatureCollection",
  "features": [],
  "dm": {
    "chart": {
      "label": "Počet obyvateľov Slovenska k 31. 12.",
      "highlight": { "from": "2022", "to": "2025" },
      "points": [
        { "period": "2021", "value": 5459781 },
        { "period": "2022", "value": 5434712 },
        { "period": "2023", "value": 5424687 },
        { "period": "2024", "value": 5415949 },
        { "period": "2025", "value": 5410836 }
      ]
    }
  }
}
```

Objekt s grafom vývoja v detaile:

```json data
{
  "type": "FeatureCollection",
  "features": [{
    "type": "Feature",
    "id": "500496",
    "geometry": { "type": "Point", "coordinates": [18.7408, 49.2231] },
    "properties": { "nazev": "Žilina", "obyvatel": 80500 },
    "dm": {
      "chart": {
        "label": "Počet obyvateľov k 31. 12.",
        "points": [
          { "period": "2023", "value": 81200 },
          { "period": "2024", "value": 80900 },
          { "period": "2025", "value": 80500 }
        ]
      }
    }
  }]
}
```
- Vlastnosti s prefixom `__dm_` sú rezervované pre portál a z odpovede sa odstránia.

## Cache {#cache}

- Portál drží odpovede po dobu `min(cache.ttl, dm.ttl)`, predvolene 300 s. Manifesty 10 min.
- Po uplynutí drží záznam ešte 24 h ako zálohu: keď zdroj neodpovedá, ukáže posledné dáta s upozornením.
- `cache.store: false` – poskytovateľ nesúhlasí s trvalým uložením dát do dátovej vrstvy portálu (krátkodobé cachovanie odpovedí podľa `ttl` platí ďalej).

## Validácia {#validace}

Zhodu s protokolom overuje [validátor](https://datovamapa.sk/dokumentacia/api.md#validator) (`POST /api/validate`, živý test `GET /api/validate?manifestUrl=…`, alebo MCP nástroje `validate_manifest` a `validate_data`). Rozlišuje:

- **chyby** (`errors`) – porušenie tohto dokumentu; manifest s chybou portál neprijme, dáta s chybou nezobrazí,
- **odporúčania** (`warnings`) – dáta fungujú, ale horšie sa hľadajú, zobrazujú alebo kombinujú.

Každý nález má stabilný `code` ([prehľad kódov](https://datovamapa.sk/dokumentacia/api.md#kody-nalezu)), cestu `path` a pri odporúčaniach radu `hint`. Kódy sa medzi minor verziami nemenia, nové môžu pribúdať.

## Vývoj protokolu {#vyvoj-protokolu}

- Nové voliteľné polia a nové typy `presentation` / `source` = nová minor verzia (0.2…).
- Zmena významu existujúcich polí = nová major verzia; portál po prechodný čas podporuje obe.
- Kandidáti na ďalšie verzie: `symbol` (ikony), `extrusion` (3D), časová dimenzia (`time` pri objektoch + parameter), `vector-tiles` / `pmtiles` / `ogc-features` ako zdroje, stránkovanie cez `next`, agregácia pre malé priblíženia.

---

<!-- https://datovamapa.sk/dokumentacia/api.md -->

# API portálu DátováMapa {#api-portalu-datovamapa}

Strojové rozhranie portálu pre aplikácie a AI agentov: katalóg dát, dáta zo všetkých zdrojov v zjednotenom tvare, dotazy na miesto (čo je v bode a okolí, súhrn za obec), validátor a registrácia pre poskytovateľov a MCP server. Všetko je verejné, bez autentifikácie, s CORS `*`. Formálny popis je v [OpenAPI](https://datovamapa.sk/openapi.json).

## Prehľad {#prehled}

| Metóda a cesta | Účel |
|---|---|
| `GET /api/catalog` | všetci poskytovatelia a dátové sady (JSON) |
| `GET /api/data/{provider}/{dataset}` | dáta sady ako GeoJSON, cez cache portálu |
| `GET /api/places?query=…` | hľadanie adresy, ulice alebo obce → súradnice |
| `GET /api/nearby?point=…` | čo je v bode a okolí, z vybraných sád |
| `GET /api/summary/{provider}/{dataset}` | súhrn sady za celé územie alebo za obec |
| `GET /api/validate?manifestUrl=…` | živý test poskytovateľa |
| `POST /api/validate` | kontrola manifestu alebo dát bez zverejnenia |
| `POST /api/registration` | registrácia poskytovateľa (dáta čakajú na schválenie) |
| `POST /mcp` | MCP server (Streamable HTTP) |
| `GET /llms.txt`, `/llms-full.txt` | rozcestník a celá dokumentácia pre jazykové modely |
| `GET /index.md`, `/zdroje.md`, `/dokumentacia/{slug}.md` | stránky portálu v markdowne |
| `GET /schema/0.1/manifest.json`, `/schema/0.1/data.json` | JSON Schema protokolu |
| `GET /schema/0.1/provider-openapi.json` | OpenAPI kontrakt, ktorý implementuje poskytovateľ |
| `GET /priklady/{soubor}.json` | platné ukážkové manifesty a odpovede |

## Katalóg {#katalog}

`GET /api/catalog`

```json
{
  "protocol": "0.1",
  "generated": "2026-10-06T08:00:00.000Z",
  "providers": [{ "id": "cgs", "name": "Česká geologická služba", "status": "ok", "datasetCount": 2, "managedBy": "portal" }],
  "datasets": [
    {
      "key": "cgs/radon",
      "providerId": "cgs",
      "providerName": "Česká geologická služba",
      "title": "Radonový index",
      "category": "risks",
      "categoryLabel": "Rizika a omezení",
      "keywords": ["radon"],
      "useCases": ["construction", "housing"],
      "source": { "type": "raster", "tiles": ["https://…"] },
      "presentation": { "type": "raster", "opacity": 0.45 },
      "attribution": "© Česká geologická služba",
      "links": { "data": null, "map": "/?d=cgs/radon" }
    }
  ]
}
```

Katalóg obsahuje iba schválené dáta. Sady poskytovateľov, ktorí sa zaregistrovali sami a zatiaľ nie sú schválení, v ňom nie sú (pozri [Registrácia](#registrace)).

Dátové sady nesú všetky polia z manifestu poskytovateľa (`description`, `fields`, `params`, `coverage`…) okrem URL zdroja – GeoJSON dáta sa čítajú cez portál (`links.data`), rastrové dlaždice priamo zo zdroja (`source.tiles`). Rovnaký obsah čitateľný pre ľudí aj modely: [zdroje.md](https://datovamapa.sk/zdroje.md).

## Dáta {#data}

`GET /api/data/{provider}/{dataset}`

| Parameter | Kedy | Popis |
|---|---|---|
| `bbox` | sady so `source.mode = "bbox"` (povinný) | `minLon,minLat,maxLon,maxLat` vo WGS84; portál ho zarovná na dlaždice |
| `zoom` | sady so `source.mode = "bbox"` (povinný) | úroveň priblíženia 0–24 |
| `cursor` | voliteľne | kurzor z `dm.next` |
| `{param}` | podľa `params` sady | hodnoty vo formáte protokolu (`a,b`, `od,do`); nevyplnené dostanú `default` |

Odpoveď je GeoJSON `FeatureCollection`. Údaje z `feature.dm` poskytovateľa sú presunuté do `properties` s prefixom `__dm_` (`__dm_title`, `__dm_description`, `__dm_url`, `__dm_color`, `__dm_chart`). Pri sadách s `color.type = "trend"` pridá portál `__dm_trend` (`roste`, `stagnuje`, `klesá`) vypočítaný z `dm.chart`. Metadáta odpovede:

```json
{ "dm": { "protocol": "0.1", "dataset": "aopk/pamatne-stromy", "generated": "…", "ttl": 86400, "total": 13, "truncated": false, "notice": null } }
```

Hlavička `X-DM-Cache`: `hit` (z cache), `miss` (čerstvo zo zdroja), `stale` (zdroj nedostupný, posledné známe dáta – pozri `dm.notice`).

Chyby majú tvar `{ "error": "správa", "code": "kod" }`: `400` neplatný dotaz, `404` neznáma sada, `502` chyba zdroja.

**Sady len na zobrazenie.** Pri niekoľkých sadách spravovaných portálom nemá zdroj doloženú licenciu na ďalšie šírenie. Portál ich kreslí vo vlastnej mape, ale dáta ďalej nevydáva: v katalógu majú `links.data` prázdne a v `links.source` adresu pôvodnej služby poskytovateľa. Dotaz mimo mapu portálu dostane `303` s hlavičkou `Location` na túto službu a telom `{ "error": "…", "code": "display_only", "source": "…" }`. Rovnako odpovie nástroj MCP `fetch_data`.

## Miesto a okolie {#misto-a-okoli}

Dotazy pre AI asistentov a aplikácie, ktoré odpovedajú na otázky o konkrétnom mieste. Vracajú ľudsky popísané hodnoty (popisky a jednotky podľa `fields` sady) bez geometrií, s atribúciou a odkazom na mapu. Návod pre používateľov asistentov: [Dáta pre AI asistentov](https://datovamapa.sk/dokumentacia/ai-asistenti.md).

### Hľadanie miesta {#hledani-mista}

`GET /api/places?query=Hlavná 1, Košice` (voliteľne `max`, predvolene 5, najviac 10)

Hľadá v registri adries adresy, ulice, obce, časti obcí a ďalšie územné prvky. Zadajte len adresu alebo názov; upresnenia ako okres alebo „pri Zlatých Moravciach“ služba nepozná. `municipality` je obec, v ktorej miesto leží (`name`, `district`, `region` a kód obce `code`) – pre ňu vie [súhrn](#souhrn) dáta za celú obec. Pri miestach mimo miest nad 10 000 obyvateľov je navyše `near` najbližšie takéto mesto a vzdialenosť v km; podľa oboch sa rozlíšia rovnomenné miesta.

```json
{
  "query": "Hlavná 1, Košice",
  "count": 1,
  "places": [{ "name": "Hlavná 1, 04001 Košice", "type": "adresa", "point": [21.258, 48.7209], "municipality": { "slug": "kosice", "code": "598186", "name": "Košice", "district": "Košice I", "region": "Košický kraj" } }],
  "attribution": "© zdroj registra adries"
}
```

### Čo je v bode a okolí {#co-je-v-bode-a-okoli}

`GET /api/nearby`

| Parameter | Popis |
|---|---|
| `point` | `lon,lat` vo WGS84 |
| `place` | miesto `point`: adresa alebo názov, použije sa prvý nález hľadania miesta |
| `radius` | polomer okolia v metroch, predvolene 500, najviac 20 000 |
| `datasets` | kľúče `provider/dataset` oddelené čiarkou, najviac 12 |
| `purpose` | namiesto `datasets`: sady s týmto účelom (`useCases`), ktoré bod pokrývajú |
| `search` | namiesto `datasets`: sady podľa zhody s textom, napr. `rizika pre stavbu` |
| `max` | najviac objektov na sadu, predvolene 5, najviac 50 |
| `{provider}/{dataset}.{param}` | parameter sady, rovnako ako v [odkaze na mapu](#odkaz-na-mapu) |

Jedno z `datasets`, `purpose`, `search` je povinné. Automatický výber berie len sady, ktoré vedia na bod odpovedať: najprv riziká a obmedzenia, podkladové mapy nakoniec. Sady nad limit vráti v `skipped`.

- **GeoJSON sady:** objekty do vzdialenosti `radius` zoradené od najbližšieho. `distance` je v metroch, 0 = bod leží vo vnútri plochy (napr. obec pri kartograme). `count` je počet objektov v okolí. Sady, ktoré sa načítavajú len pri veľkom priblížení, okolie zmenšia (`radius`, `notice`). Pri celých sadách (`mode: full`), ktoré v okolí nič nemajú, vráti aspoň najbližší objekt (napr. meraciu stanicu).
- **Rastrové sady:** portál sa opýta zdroja priamo na bod. Dotaz odvodí zo šablóny dlaždíc: WMS `GetMap` → `GetFeatureInfo`, ArcGIS `MapServer/export` → `identify`, `ImageServer/exportImage` → `identify` s tabuľkou tried rastra. Hodnoty sú atribúty zdroja (názvy polí, ako ich zdroj vracia). Pri výklade kódov pomôže `description` a `legend`.

| `status` | Význam |
|---|---|
| `ok` | dotaz prebehol; prázdne `hits` = v okolí / v bode nič nie je (napr. mimo záplavového územia) |
| `unavailable` | sada hodnotu v bode neposkytuje (dlaždice sú len obraz) alebo bod leží mimo pokrytia |
| `error` | zdroj zlyhal (`error`, `code`) |

```json
{
  "place": { "name": "Hlavná 1, 04001 Košice", "type": "adresa", "point": [21.258, 48.7209] },
  "point": [21.258, 48.7209],
  "radius": 500,
  "generated": "2026-10-06T16:00:00.000Z",
  "results": [
    {
      "dataset": "cgs/radon",
      "title": "Radonový index",
      "provider": "Česká geologická služba",
      "attribution": "© Česká geologická služba",
      "status": "ok",
      "hits": [{ "title": "Radonový index", "distance": 0, "values": [{ "label": "radonovériziko", "value": "přechodný" }, { "label": "stupeňradonovéhoindexu", "value": "2" }] }]
    },
    {
      "dataset": "npu/kulturni-pamatky",
      "title": "Kulturní památky",
      "provider": "Národní památkový ústav",
      "attribution": "Národní památkový ústav",
      "license": "CC BY-SA 4.0",
      "status": "ok",
      "count": 27,
      "radius": 500,
      "hits": [
        {
          "title": "továrna Breitfeld-Daněk",
          "distance": 91,
          "values": [{ "label": "Rejstříkové číslo ÚSKP", "value": "105958" }, { "label": "Stav ochrany", "value": "památkově chráněno" }],
          "url": "https://pamatkovykatalog.cz/x-14624751"
        }
      ]
    }
  ],
  "map": "https://datovamapa.sk/?d=cgs/radon&d=npu/kulturni-pamatky#15/48.7209/21.258"
}
```

### Súhrn {#souhrn}

`GET /api/summary/{provider}/{dataset}?municipality=Žilina` (ostatné query parametre sú parametre sady)

Súhrn GeoJSON sady za celé územie, alebo s `municipality` len za obec – ktorúkoľvek obec Slovenska: `count`, `categories` (počty podľa kategórie farby), `rankings` (najvyššie a najnižšie hodnoty) a pri kartograme `own` – hodnoty plochy, v ktorej obec leží. Sú to rovnaké čísla, aké ukazuje stránka sady. Sady načítavané len pri veľkom priblížení majú súhrn len za obec. Rastrové sady súhrn nemajú.

`municipality` je názov („Žilina“), názov s okresom alebo krajom („Nová Ves (okres Trenčín)“), kód obce („598186“, vracia ho [hľadanie miesta](#hledani-mista) v `municipality.code`) alebo adresa jej prehľadu („trenciansky-kraj/nova-ves-trencin“). Samotný názov, ktorý nesie viac obcí, skončí chybou `ambiguous_place` so zoznamom týchto obcí, ich okresov a kódov.

## Validátor {#validator}

Nástroj pre poskytovateľov a ich AI agentov. Vracia vždy HTTP 200 a report:

```json
{
  "valid": false,
  "summary": "Manifest není platný: 1 chyb, 2 doporučení.",
  "errors": [{ "path": "datasets[0].source.tiles[0]", "code": "raster_without_template", "message": "Šablona dlaždic neobsahuje {z}/{x}/{y} ani {bbox-epsg-3857}." }],
  "warnings": [{ "path": "datasets[0].keywords", "code": "missing_keywords", "message": "Sada nemá klíčová slova.", "hint": "Doplňte 5–15 slov…" }]
}
```

- `POST /api/validate` s telom:
  - manifest (objekt s `datasets`) alebo `{ "manifest": … }` – statická kontrola,
  - GeoJSON `FeatureCollection` alebo `{ "data": …, "dataset": … }` – kontrola dát; s `dataset` (objekt sady z manifestu) aj súlad s manifestom,
  - `{ "manifestUrl": "https://…" }` – živý test.
- `GET /api/validate?manifestUrl=https://…` – živý test: stiahne manifest, skontroluje ho a na každú sadu pošle testovací dotaz ako portál (pri `bbox` na stred `coverage.bbox`, zoom 12 alebo `coverage.minZoom`; pri rastri jednu dlaždicu). Report má navyše `provider` a `datasets[]` s `request`, `durationMs`, `featureCount`, `errors`, `warnings`.

## Registrácia {#registrace}

`POST /api/registration` s telom `{ "manifestUrl": "https://…" }`. Portál manifest skontroluje živým testom (ako validátor). Keď prejde, zaregistruje poskytovateľa medzi neschválené dáta:

- Dáta sú dostupné cez `/api/data/…` aj na stránkach sád `/mapa/{provider}/{dataset}`. Stránka najprv ukáže varovanie, že dáta nahrala tretia strana a prevádzkovateľ ich neschválil. Dáta do mapy načíta až po potvrdení. Stránka má `noindex`.
- Do katalógu, vyhľadávania, `llms.txt`, MCP nástroja `catalog` a na stránky za obce sa dáta dostanú až po schválení prevádzkovateľom.
- Schválenie platí pre odtlačok (SHA-256) obsahu manifestu. Po zmene manifestu je poskytovateľ opäť neschválený, kým ho prevádzkovateľ neschváli znova.
- Prehľad neschválených poskytovateľov: [/neschvalene-data](https://datovamapa.sk/neschvalene-data).

```json
{
  "registered": true,
  "status": "pending_review",
  "message": "Registrováno. …",
  "provider": { "id": "obec-priklad", "name": "Obec Příklad" },
  "links": { "review": "/neschvalene-data#obec-priklad", "datasets": ["/mapa/obec-priklad/lavicky"] },
  "check": { "summary": "Poskytovatel je platný bez výhrad.", "warnings": [] }
}
```

| HTTP | `code` | Význam |
|---|---|---|
| 201 | – | zaregistrované, čaká na schválenie |
| 200 | – | už zaregistrované; `status` je `pending_review` alebo `approved` |
| 400 | `invalid_input`, `invalid_url` | chýba alebo je neplatná `manifestUrl` |
| 403 | `rejected` | registráciu prevádzkovateľ zamietol |
| 409 | `id_taken`, `url_registered` | `provider.id` už v portáli je / URL je registrovaná pod iným id |
| 422 | `manifest_rejected` | živý test neprešiel; report je v `check` |
| 429 | `too_many_requests`, `queue_full` | viac než 5 pokusov za minútu z jednej adresy / na schválenie čaká vyše 100 poskytovateľov |
| 503 | `registration_unavailable` | registrácia teraz nefunguje |

## MCP server {#mcp-server}

Endpoint `https://datovamapa.sk/mcp`, transport Streamable HTTP (bezstavový, odpovede JSON), bez autentifikácie.

| Nástroj | Vstup | Výstup |
|---|---|---|
| `documentation` | `topic`: `ai-agents`, `ai-assistants`, `protocol`, `providers`, `api`, `about` | markdown dokumentu |
| `schema` | `type`: `manifest`, `data`, `provider-openapi` | JSON Schema / OpenAPI |
| `example` | `name`: `manifest-minimal`, `manifest-complete`, `data-points`, `data-polygons` | platný ukážkový JSON |
| `validate_manifest` | `manifest` (objekt) alebo `manifestUrl` (živý test) | report validátora |
| `validate_data` | `data`, voliteľne `dataset` | report validátora |
| `register_provider` | `manifestUrl` | výsledok [registrácie](#registrace) |
| `catalog` | voliteľne `search` (voľný text), `point` (`[lon, lat]`) | dátové sady v portáli, zoradené podľa zhody; `pointQuery` = sada odpovie na `nearby` |
| `find_place` | `query`, `maxResults` | ako [hľadanie miesta](#hledani-mista) |
| `nearby` | `point` alebo `place`; `datasets`, `purpose` alebo `search`; `radius`, `maxFeatures`, `params` (`{ "provider/dataset": { "param": "hodnota" } }`) | ako [čo je v bode a okolí](#co-je-v-bode-a-okoli) |
| `summary` | `dataset`, voliteľne `municipality`, `params` | ako [súhrn](#souhrn) |
| `fetch_data` | `dataset` (`provider/dataset`), `bbox` alebo `municipality`, `zoom`, `params`, `maxFeatures` | GeoJSON (skrátený na `maxFeatures`) |

Pripojenie:

```bash
claude mcp add --transport http datovamapa https://datovamapa.sk/mcp
```

```json
{ "mcpServers": { "datovamapa": { "type": "http", "url": "https://datovamapa.sk/mcp" } } }
```

## Odkaz na mapu {#odkaz-na-mapu}

`https://datovamapa.sk/?d={provider}/{dataset}&d=…&{provider}/{dataset}.{param}={hodnota}#{zoom}/{lat}/{lon}`

Každá sada má aj vlastnú stránku s mapou a popisom: `https://datovamapa.sk/mapa/{provider}/{dataset}`, celoštátne GeoJSON sady aj za obce nad 10 000 obyvateľov: `https://datovamapa.sk/mapa/{provider}/{dataset}/{obec}` (napr. [/mapa/chmu/kvalita-ovzdusi/ostrava](https://datovamapa.sk/mapa/chmu/kvalita-ovzdusi/ostrava)). Odkaz na stránku sady je v katalógu v `links.map`. Na stránke sady (aj zostavenej mapy `/mapy/{slug}`) sa do `?d=…` zapisuje len rozdiel oproti predvolenému výberu: bez `d` platia sady stránky, `d` vymenuje celý výber (`?d=` = nič nie je zapnuté) a parameter sa uvádza, len keď sa líši od predvoleného.

Príklad – dopravné nehody v Brne súhrnne za roky 2019–2023: [/?d=brno/dopravni-nehody&brno/dopravni-nehody.obdobi=2019,2023#13/49.195/16.608](https://datovamapa.sk/?d=brno/dopravni-nehody&brno/dopravni-nehody.obdobi=2019,2023#13/49.195/16.608)

## Kódy nálezov {#kody-nalezu}

Stabilné kódy chýb (`errors`) a odporúčaní (`warnings`) validátora a proxy.

### Manifest {#manifest}

| Kód | Úroveň | Význam |
|---|---|---|
| `schema_*` | chyba | porušenie JSON Schema (`schema_invalid_type`, `schema_too_small`, `schema_invalid_format`, `schema_invalid_value`, `schema_custom`…), `path` ukazuje miesto |
| `unsupported_version` | chyba | iná hlavná verzia protokolu |
| `raster_without_template` | chyba | URL dlaždíc bez `{z}/{x}/{y}` aj `{bbox-epsg-3857}` |
| `geojson_with_raster_presentation` | chyba | GeoJSON zdroj s `presentation.type: "raster"` |
| `param_without_options` | chyba | `enum` / `multi-enum` bez `options` |
| `invalid_default` | chyba | `default` parametra nezodpovedá typu alebo možnostiam |
| `time_param_missing` | chyba | `temporal.param` odkazuje na parameter, ktorý nie je v `params` |
| `time_param_type` | chyba | časový parameter nie je typu `range` ani `date-range` |
| `time_param_no_range` | odporúčanie | časový parameter typu `range` nemá `min` a `max` |
| `unknown_presentation_type` | odporúčanie | portál typ nepozná, kreslí `auto` |
| `raster_without_raster_presentation` | odporúčanie | raster sa vždy kreslí ako `raster` |
| `missing_description`, `missing_keywords`, `missing_use_cases` | odporúčanie | sadu horšie nájdu ľudia aj asistent |
| `missing_category`, `unknown_category` | odporúčanie | sada skončí v „Ostatné“ |
| `missing_field` | odporúčanie | detail objektu ukáže surové názvy vlastností |
| `field_not_described`, `field_not_number` | odporúčanie | prezentácia odkazuje na vlastnosť mimo `fields` / s nečíselným typom |
| `bbox_unbounded` | odporúčanie | sada `bbox` bez `coverage.minZoom` a `maxFeatures` |
| `missing_coverage` | odporúčanie | sada `bbox` bez `coverage.bbox` |
| `missing_license`, `missing_website` | odporúčanie | chýba licencia / web poskytovateľa |

### Dáta {#data}

| Kód | Úroveň | Význam |
|---|---|---|
| `coordinates_out_of_range` | chyba | súradnice mimo WGS84 (typicky neprevedený S-JTSK) |
| `unclosed_polygon` | chyba | prstenec polygónu nie je uzavretý |
| `too_many_features` | odporúčanie | viac objektov než `limit` / 5 000 |
| `missing_time_series` | odporúčanie | sada má `temporal.param`, odpoveď neposiela `dm.timeline` ani `dm.chart` |
| `missing_trend_chart` | odporúčanie | sada farbí podľa číselnej hodnoty a obdobie volí parametrom, objekty však neposielajú `dm.chart` |
| `trend_without_chart` | odporúčanie | sada sa farbí podľa trendu, niektoré objekty nemajú `dm.chart` (zostanú sivé) |
| `swapped_coordinates` | odporúčanie | súradnice zrejme v poradí `[lat, lon]` |
| `outside_coverage` | odporúčanie | väčšina objektov mimo `coverage.bbox` |
| `geometry_presentation_mismatch` | odporúčanie | napr. plochy pri `circle` |
| `field_missing_in_data`, `missing_presentation_property` | odporúčanie | vlastnosť z manifestu v dátach chýba |
| `missing_id` | odporúčanie | objekty bez `id` |
| `empty_geometry` | odporúčanie | objekty s `geometry: null` sa preskočia |

### Živý test a proxy {#zivy-test-a-proxy}

| Kód | Význam |
|---|---|
| `invalid_url`, `https_required` | neplatná URL / zdroj nie je na HTTPS |
| `source_unreachable`, `timeout`, `http_error` | zdroj neodpovedá, nestihol 10 s, vrátil HTTP chybu |
| `invalid_json`, `empty_body`, `response_too_large` | odpoveď nie je JSON / je prázdna / má viac než 15 MB |
| `invalid_manifest`, `id_mismatch` | manifest registrovaného poskytovateľa neprešiel / má iné `provider.id` |
| `registration_unavailable`, `too_many_requests`, `queue_full`, `manifest_rejected`, `id_taken`, `url_registered`, `rejected` | chyby [registrácie](#registrace) |
| `data_schema_mismatch` | dáta od zdroja nezodpovedajú schéme |
| `empty_response`, `slow_response` | testovací dotaz vrátil 0 objektov / trval vyše 3 s |
| `tile_http_error`, `tile_not_image`, `tile_unreachable` | testovacia rastrová dlaždica zlyhala |
| `source_error` | iná chyba pri komunikácii so zdrojom (podrobnosti v `message`) |
| `invalid_query`, `unknown_dataset`, `raster_dataset`, `invalid_input`, `internal_error` | chyby dotazu na portál |
| `display_only` | sadu portál iba zobrazuje, dáta poskytuje pôvodná služba (`source`) |
| `missing_place`, `unknown_place` | dotaz na miesto bez bodu aj miesta / miesto (adresu, obec) sa nepodarilo nájsť |
| `geocoding_unavailable` | hľadanie adries a miest v danej krajine portál zatiaľ nemá (HTTP 501) |
| `ambiguous_place` | názov obce nesie viac obcí – správa ich vymenuje s okresom a kódom |
| `missing_dataset_selection` | dotaz na okolie bez `datasets`, `purpose` aj `search` |
| `summary_requires_place` | sada sa dá načítať len po priblížení, súhrn za celé územie nemá – zadajte obec |
| `unknown_schema`, `unknown_example` | neexistujúca schéma / príklad (odpoveď obsahuje zoznam `available`) |

---

<!-- https://datovamapa.sk/dokumentacia/o-projekte.md -->

# DátováMapa – vízia {#datovamapa-vize}

Dátum: 2026-10-06 (nahrádza pôvodný kontext z 2026-08, ten je v `docs/archiv/`)

## Čo je DátováMapa {#co-je-datovamapa}

DátováMapa je **otvorené rozhranie na vizualizáciu dát v mape**. Definuje otvorenú schému (protokol), cez ktorú môže ktokoľvek zobraziť v mape ľubovoľné dáta – body, línie, plochy, hustoty, rastrové vrstvy.

Princíp:

1. Poskytovateľ dát zverejní **manifest** (popis seba a svojich dátových sád) a **dátový endpoint** podľa protokolu DátováMapa.
2. Poskytovateľ manifest zaregistruje; po schválení prevádzkovateľom sa sady objavia v katalógu.
3. Keď používateľ sadu zapne, portál sa dopytuje zdroja (pre aktuálny výrez mapy a nastavené filtre), odpoveď overí, uloží do cache a vykreslí podľa popisu z manifestu.

Portál dáta nevlastní; sprostredkúva ich a vždy uvádza zdroj. Prevádzkovateľom portálu je [vrealmatic.com](https://vrealmatic.com/webove-sluzby).

## Prínos {#prinos}

**Pre používateľov:** na jednej mape si skombinujú dáta z ľubovoľných zdrojov – bez prepínania medzi desiatkami mapových portálov.

**Pre poskytovateľov:**

- nemusia riešiť mapu, štýly ani mapový server – stačí JSON endpoint,
- sú súčasťou otvoreného dátového portálu, ich dáta sa stretávajú s dátami ostatných,
- sú viditeľne uvedení ako zdroj (pri dátach v mape, v detaile objektu, v prehľade zdrojov).

## Dáta pripravujú AI agenti {#data-pripravuji-ai-agenti}

Očakávame, že dáta u poskytovateľov budú pripravovať hlavne AI agenti (na pokyn človeka, ktorý dáta vlastní). Preto je celý portál postavený ako „AI friendly“:

- **Všetko je v markdowne.** Každá stránka dokumentácie má markdown verziu (`/dokumentacia/{slug}.md`), hlavná stránka `/index.md`, katalóg `/zdroje.md`; rozcestník `/llms.txt` a celá dokumentácia v jednom súbore `/llms-full.txt`. Zdrojom pravdy sú súbory v `docs/`, HTML sa z nich generuje.
- **Návod pre agentov** s postupom, rozhodovacími tabuľkami, šablónami kódu, pravidlami (osobné údaje, licencie) a kritériami hotovej práce.
- **Strojové schémy** generované z jedného zdroja: JSON Schema manifestu a dát, OpenAPI kontrakt poskytovateľa (agent z neho vygeneruje server) a OpenAPI portálu.
- **Validátor so spätnou väzbou**: stabilné kódy nálezov, presné cesty a rady, ako chybu opraviť; živý test celého poskytovateľa. Agent iteruje, kým nie je `valid: true`.
- **MCP server** `/mcp`: dokumentácia, schémy, príklady, validácia, katalóg a dáta ako nástroje.
- **Overené príklady**: každá ukážka v dokumentácii prechádza validátorom (`npm run check:docs`), aby agent nekopíroval chybu.
- **Polia na dohľadateľnosť**: `keywords`, `useCases`, `description`, `fields` – podľa nich dáta nájdu ľudia aj asistent portálu.

Dáta v portáli čítajú aj AI asistenti bežných ľudí a firiem. Cez MCP server alebo HTTP API nájdu miesto (register adries), opýtajú sa vybraných sád, čo je v bode a okolí (aj rastrových máp ako záplavy, radón alebo hluk), a dostanú súhrn za obec. Dáta si vyložia sami a uvedú zdroj. Návod: [Dáta pre AI asistentov](https://datovamapa.sk/dokumentacia/ai-asistenti.md).

## Princípy {#principy}

- **Otvorený protokol.** Schéma je verejná (`/schema/0.1/manifest.json`, `/schema/0.1/data.json`), založená na GeoJSON (RFC 7946). Takmer všetko je voliteľné, povinné je len malé minimum.
- **Zámer, nie knižnica.** Poskytovateľ popisuje, *čo* chce ukázať (body podľa kategórie, kartogram podľa hodnoty…), nie konkrétne nastavenie mapovej knižnice. Portál môže vykresľovanie meniť bez dopadu na poskytovateľa.
- **Dopredná kompatibilita.** Neznáme polia sa ignorujú, neznámy typ vizualizácie sa vykreslí predvoleným štýlom. Protokol tak môže rásť bez rozbíjania existujúcich zdrojov.
- **Jednoduchá hlavná stránka.** Len mapa a logo. Na prejdenie myšou / klik sa otvorí výber dát. Žiadne ďalšie panely.
- **Vstupné stránky pre konkrétne dáta.** Kto hľadá konkrétnu metriku, príde z vyhľadávača na stránku sady (`/mapa/{provider}/{dataset}`), sady za obec alebo zostavenej mapy (`/mapy/{slug}`): rovnaká mapa s predvolenými dátami a popisom so súhrnom dát. Do mapy si pridá ďalšie vrstvy ako na hlavnej stránke.
- **Bezpečnosť.** Dáta poskytovateľov sa nikdy nevkladajú ako HTML, proxy sa pýta len registrovaných zdrojov, s limitmi na čas a veľkosť.

## Hlavná stránka {#hlavni-stranka}

- Celoplošná mapa a logo vľavo hore. Mapa sa otvorí nad celým Slovenskom.
- **Úvod.** Kto príde bez výberu a bez odkazu na miesto, toho sa mapa pri načítaní opýta na polohu v prehliadači, prenesie ho do jeho okolia a vedľa mapy sa otvorí úvodné okno „Vaše okolie v dátach“ – rýchly štart: asistent (pripravujeme) s rýchlymi voľbami, teda zostavenými mapami na jedno kliknutie, a odkazmi na práve aktuálne dáta. Jednotlivé vrstvy sa zapínajú v katalógu („Celý katalóg“). Kto polohu nepovolí alebo je mimo Slovenska, dostane úvod pre celé Slovensko. Odkaz s výberom úvod preskočí; úvod sa však vráti, kedykoľvek v mape nič nie je.
- Presnú polohu si používateľ zobrazí tlačidlom „Moje okolie“ vpravo hore vedľa ovládania mapy – prehliadač sa pýta až po kliknutí; kto polohu povolil skôr, toho mapa rovno ukáže v jeho okolí (a úvod použije túto polohu).
- Prejdenie myšou na logo (alebo klik / tap) otvorí veľké okno výberu (cez 80 % šírky): vľavo **katalóg** ako karty podľa kategórií s vyhľadávaním, vpravo **Na mape** – zapnuté vrstvy so stavom, legendou a filtrami. Hore je ukážka budúceho asistenta – zatiaľ neaktívna. Klik alebo práca v okne ho pripne, zatvorí sa krížikom, klávesom Esc alebo klikom mimo.
- Výber sa ukladá do URL, odkaz sa dá zdieľať.

### Zadanie v prirodzenom jazyku (budúcnosť) {#zadani-v-prirozenem-jazyce-budoucnost}

Cieľ: používateľ napíše napr. *„Chcem stavať v obci Lipany, zobraz mi všetky relevantné dáta, čo máš pre môj účel“* a portál:

1. pochopí miesto (geokódovanie obce / adresy / parcely) a presunie mapu,
2. pochopí účel (stavba) a vyberie relevantné sady podľa `useCases`, `keywords` a popisov v manifestoch,
3. prípadne nastaví filtre a zhrnie, čo v dátach vidí.

V okne je zatiaľ len neaktívna ukážka. Kroky 1–3 však už vie cudzí AI asistent cez MCP: `find_place` (geokódovanie registra adries), `nearby` (výber sád podľa účelu alebo textu a dopyt na bod) a `summary`. Výber sád podľa kľúčových slov a účelov (`src/lib/search.ts`) používa aj vyhľadávanie v katalógu a MCP nástroj `catalog`. Preto majú manifesty polia `keywords` a `useCases` – pripravujú dáta pre asistenta.

## Cache a vlastná dátová vrstva {#cache-a-vlastni-datova-vrstva}

Na začiatku sú zdrojom dát externé API poskytovateľov. Portál odpovede drží v cache (podľa `cache.ttl`), aby sa zdroje nezaťažovali a mapa bola rýchla; pri výpadku zdroja môže krátko ukázať posledné známe dáta.

V podmienkach pre poskytovateľov si vyhradzujeme, že dáta môžeme v záujme **zrýchlenia, odľahčenia zdrojov, udržateľnosti, lepšej kombinatoriky, spájania súvislostí a práce s veľkými dátami** držať vo vlastnej cache / dátovej vrstve. Poskytovateľ to môže pri sade vypnúť (`cache.store: false`).

## Autorské hodnotenia (ďalšia verzia) {#autorska-hodnoceni-dalsi-verze}

Návrh, zatiaľ neimplementované. Vrstva pre ľudí s vlastným názorom a publikom – blogerov, recenzentov, kluby –, ktorí chcú ukázať hodnotenia miest: „Kaviarne podľa …“, „Cyklotrasy podľa …“, „Detské ihriská podľa …“. Každé miesto má hodnotenie, krátky verdikt a odkaz na článok.

Dnes to ide len všeobecne: autor si vystaví vlastný manifest a GeoJSON s číselným poľom a zafarbí body podľa hodnoty. Portál však nevie, že ide o hodnotenie, a autor musí dáta hostovať sám.

Návrh:

- **Hostujeme my.** Autor nahrá CSV alebo GeoJSON, prípadne body naklikne v mape. Dáta ukladá portál (D1 / R2), autor nepotrebuje vlastný web.
- **Hodnotenie ako pojem protokolu.** Typ vizualizácie `rating` a polia objektu `rating`, `ratingMax` (predvolene 5), `review` (krátky verdikt), `url` (článok) a `visited` (dátum návštevy). Portál ukáže hviezdičky v detaile, ponúkne filter „od N hviezdičiek“ a legendu odvodí sám. Typ môže použiť aj poskytovateľ s vlastným manifestom.
- **Autor je viditeľný.** Hodnotenie je názor konkrétneho človeka, nie údaj portálu. Meno a odkaz na autora sú pri vrstve aj v detaile každého miesta.
- **Schvaľovanie.** Vrstva je mimo katalógu, kým ju prevádzkovateľ neschváli, rovnako ako pri [samoregistrácii](https://datovamapa.sk/dokumentacia/pre-poskytovatelov.md#5-registrace).

Otvorené otázky:

- **Účty.** Portál dnes používateľské účty nemá. Nahrávanie potrebuje prihlásenie (napr. odkaz e-mailom) a ochranu proti zneužitiu.
- **Schvaľovanie zmien.** Autor bude dáta priebežne dopĺňať. Schvaľovať raz autora, alebo každú zmenu?
- **Voľné body, alebo existujúce miesta?** Naviazanie na existujúce miesto (napr. podnik z OpenStreetMap) umožní porovnať viac autorov pri jednom mieste, ale je výrazne zložitejšie.
- **Súhrny.** Priemer z viacerých autorov sa blíži recenzným serverom a otvára riziko manipulácie (vymyslení autori). Na začiatok len vrstvy vedľa seba.
- **Právo.** Negatívne hodnotenie pomenovaného podniku môže naraziť na ochranu dobrej povesti právnickej osoby (§ 135 Občianskeho zákonníka). Potrebné sú podmienky „autor zodpovedá za svoj obsah“, nahlásenie miesta a rýchle odstránenie. Hodnotia sa miesta, nie súkromné osoby.

## Plán {#plan}

1. **v0.1 (hotovo):** protokol (manifest + GeoJSON odpoveď), katalóg, proxy s cache, vizualizácie circle / heatmap / line / fill / raster / auto, filtre, detail objektu, prehľad zdrojov, ukážkový poskytovateľ; dokumentácia v markdowne, llms.txt, validátor, MCP server, OpenAPI.
2. **Registrácia poskytovateľov:** samoobslužná registrácia so schvaľovaním je hotová (formulár, API, MCP); zostáva monitoring dostupnosti zdrojov.
3. **Asistent:** pre cudzích AI asistentov hotové (MCP a API: geokódovanie registra adries, dopyt na bod a okolie vrátane rastrových sád, súhrn za obec); zostáva vlastný asistent v okne výberu (LLM nad katalógom).
4. **Ďalšie vizualizácie a zdroje:** ikony/symboly, 3D vytiahnutie plôch, časová os, toky, vektorové dlaždice (MVT/PMTiles), OGC API Features a WFS ako typ zdroja.
5. **Vlastná dátová vrstva:** trvalé uloženie dát (Cloudflare D1/R2, prípadne PostGIS), priestorové dopyty cez viac zdrojov, predpočítané agregácie pre veľké dáta.
6. **Autorské hodnotenia:** hodnotiace vrstvy blogerov a recenzentov hostované portálom, typ vizualizácie `rating` (pozri [návrh](https://datovamapa.sk/dokumentacia/o-projekte.md#autorska-hodnoceni-dalsi-verze)).

---

# Príklady

## manifest-minimal.json

Najmenší rozumný manifest: statický GeoJSON súbor, režim full.

```json
{
  "$schema": "https://datovamapa.sk/schema/0.1/manifest.json",
  "protocol": "0.1",
  "provider": {
    "id": "obec-priklad",
    "name": "Obec Příklad",
    "homepage": "https://www.obec-priklad.cz/"
  },
  "license": {
    "name": "CC BY 4.0",
    "url": "https://creativecommons.org/licenses/by/4.0/",
    "attribution": "© Obec Příklad"
  },
  "datasets": [
    {
      "id": "lavicky",
      "title": "Lavičky v obci",
      "description": "Veřejné lavičky udržované obcí.",
      "category": "society",
      "keywords": [
        "lavička",
        "posezení",
        "odpočinek",
        "park",
        "mobiliář"
      ],
      "useCases": [
        "tourism",
        "public-administration"
      ],
      "source": {
        "type": "geojson",
        "url": "lavicky.geojson",
        "mode": "full"
      },
      "presentation": {
        "type": "circle",
        "color": "#0d9488"
      },
      "fields": [
        {
          "key": "umisteni",
          "label": "Umístění",
          "primary": true
        }
      ]
    }
  ]
}
```

## manifest-complete.json

Manifest so všetkými hlavnými možnosťami: bbox, filtre, farby podľa hodnôt, zoskupovanie, kartogram, WMS.

```json
{
  "$schema": "https://datovamapa.sk/schema/0.1/manifest.json",
  "protocol": "0.1",
  "provider": {
    "id": "mesto-priklad",
    "name": "Město Příklad",
    "description": "Otevřená data statutárního města Příklad.",
    "homepage": "https://www.mesto-priklad.cz/",
    "contact": {
      "email": "opendata@mesto-priklad.cz"
    }
  },
  "license": {
    "name": "CC BY 4.0",
    "url": "https://creativecommons.org/licenses/by/4.0/",
    "attribution": "© Město Příklad"
  },
  "datasets": [
    {
      "id": "kontejnery",
      "title": "Kontejnery na tříděný odpad",
      "description": "Stanoviště kontejnerů na papír, plast a sklo včetně data posledního vývozu.",
      "category": "infrastructure",
      "tags": [
        "odpady"
      ],
      "keywords": [
        "odpad",
        "kontejner",
        "třídění",
        "tříděný odpad",
        "popelnice",
        "papír",
        "plast",
        "sklo",
        "recyklace"
      ],
      "useCases": [
        "housing",
        "public-administration"
      ],
      "coverage": {
        "bbox": [
          16.43,
          49.1,
          16.73,
          49.3
        ],
        "area": "Město Příklad",
        "minZoom": 11
      },
      "temporal": {
        "updated": "2026-10-06",
        "frequency": "denně"
      },
      "source": {
        "type": "geojson",
        "url": "https://data.mesto-priklad.cz/datovamapa/kontejnery",
        "mode": "bbox",
        "maxFeatures": 5000
      },
      "presentation": {
        "type": "circle",
        "color": {
          "field": "druh",
          "type": "categorical",
          "values": {
            "papír": "#2563eb",
            "plast": "#eab308",
            "sklo": "#16a34a"
          },
          "default": "#64748b"
        },
        "radius": {
          "field": "objem",
          "type": "interpolate",
          "stops": [
            [
              500,
              4
            ],
            [
              3000,
              9
            ]
          ]
        },
        "strokeColor": "#ffffff",
        "strokeWidth": 1.5,
        "cluster": {
          "radius": 40,
          "maxZoom": 15
        },
        "legend": [
          {
            "label": "Papír",
            "color": "#2563eb"
          },
          {
            "label": "Plast",
            "color": "#eab308"
          },
          {
            "label": "Sklo",
            "color": "#16a34a"
          }
        ]
      },
      "fields": [
        {
          "key": "druh",
          "label": "Druh odpadu",
          "type": "string",
          "primary": true
        },
        {
          "key": "objem",
          "label": "Objem",
          "type": "integer",
          "unit": "l"
        },
        {
          "key": "vyvoz",
          "label": "Poslední vývoz",
          "type": "date"
        }
      ],
      "params": [
        {
          "key": "druh",
          "label": "Druh odpadu",
          "type": "multi-enum",
          "options": [
            {
              "value": "papír",
              "label": "Papír"
            },
            {
              "value": "plast",
              "label": "Plast"
            },
            {
              "value": "sklo",
              "label": "Sklo"
            }
          ]
        }
      ],
      "cache": {
        "ttl": 3600,
        "store": true
      }
    },
    {
      "id": "hluk",
      "title": "Hluková mapa",
      "description": "Strategická hluková mapa – denní hladina hluku ze silniční dopravy.",
      "category": "risks",
      "keywords": [
        "hluk",
        "hlučnost",
        "doprava",
        "decibely",
        "Ldvn"
      ],
      "useCases": [
        "housing",
        "construction",
        "land-purchase"
      ],
      "coverage": {
        "bbox": [
          16.43,
          49.1,
          16.73,
          49.3
        ],
        "area": "Město Příklad",
        "minZoom": 10
      },
      "source": {
        "type": "geojson",
        "url": "https://data.mesto-priklad.cz/datovamapa/hluk",
        "mode": "bbox"
      },
      "presentation": {
        "type": "fill",
        "color": {
          "field": "db",
          "type": "step",
          "default": "#fef9c3",
          "stops": [
            [
              55,
              "#fde047"
            ],
            [
              60,
              "#fb923c"
            ],
            [
              65,
              "#ef4444"
            ],
            [
              70,
              "#7f1d1d"
            ]
          ]
        },
        "opacity": 0.55,
        "outlineWidth": 0
      },
      "fields": [
        {
          "key": "db",
          "label": "Hladina hluku",
          "type": "number",
          "unit": "dB",
          "decimals": 0
        }
      ],
      "cache": {
        "ttl": 86400
      }
    },
    {
      "id": "uzemni-plan",
      "title": "Územní plán",
      "description": "Hlavní výkres územního plánu jako rastrová vrstva z WMS.",
      "category": "territory",
      "keywords": [
        "územní plán",
        "ÚP",
        "funkční využití",
        "zastavitelné plochy"
      ],
      "useCases": [
        "construction",
        "land-purchase",
        "investment"
      ],
      "coverage": {
        "bbox": [
          16.43,
          49.1,
          16.73,
          49.3
        ],
        "area": "Město Příklad"
      },
      "source": {
        "type": "raster",
        "tiles": [
          "https://gis.mesto-priklad.cz/wms?service=WMS&version=1.1.1&request=GetMap&layers=up_hlavni&styles=&format=image/png&transparent=true&srs=EPSG:3857&width=256&height=256&bbox={bbox-epsg-3857}"
        ]
      },
      "presentation": {
        "type": "raster",
        "opacity": 0.7
      }
    }
  ]
}
```

## data-points.json

Odpoveď s bodmi vrátane rozšírenia dm.

```json
{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "id": 1842,
      "geometry": {
        "type": "Point",
        "coordinates": [
          16.6081,
          49.1951
        ]
      },
      "properties": {
        "druh": "papír",
        "objem": 1100,
        "vyvoz": "2026-10-01"
      },
      "dm": {
        "title": "Kontejner Náměstí Svobody",
        "url": "https://www.mesto-priklad.cz/odpady/1842"
      }
    },
    {
      "type": "Feature",
      "id": 1843,
      "geometry": {
        "type": "Point",
        "coordinates": [
          16.6102,
          49.1938
        ]
      },
      "properties": {
        "druh": "sklo",
        "objem": 1500,
        "vyvoz": "2026-09-28"
      }
    }
  ],
  "dm": {
    "generated": "2026-10-06T08:00:00Z",
    "ttl": 3600,
    "total": 2,
    "truncated": false
  }
}
```

## data-polygons.json

Odpoveď s plochou (polygón) a číselnou hodnotou pre kartogram.

```json
{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "id": "h-001",
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              16.6,
              49.19
            ],
            [
              16.61,
              49.19
            ],
            [
              16.61,
              49.2
            ],
            [
              16.6,
              49.2
            ],
            [
              16.6,
              49.19
            ]
          ]
        ]
      },
      "properties": {
        "db": 62
      }
    }
  ],
  "dm": {
    "ttl": 86400
  }
}
```

---

# Zdroje dát DátovejMapy

Katalóg všetkých pripojených poskytovateľov a dátových sád (protokol 0.1, vygenerované 2026-10-20T14:47:30.636Z). Strojovo: https://datovamapa.sk/api/catalog. Dáta GeoJSON sád: `GET https://datovamapa.sk/api/data/{provider}/{dataset}` (pozri https://datovamapa.sk/dokumentacia/api.md).

## Úrad geodézie, kartografie a katastra SR

- Id: `ugkk`
- Popis: Štátne mapové dáta Slovenska: ortofotomozaika, katastrálna mapa, administratívne hranice, výškopis a vodstvo zo ZBGIS.
- Web: https://www.skgeodesy.sk/
- Licencia: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/), atribúcia „© ÚGKK SR“
- Manifest spravuje DátováMapa (verejná služba, vlastník dát sa zatiaľ nepripojil sám).

### Ortofoto

- Kľúč: `ugkk/ortofoto`
- Popis: Farebná letecká snímka celého Slovenska od ÚGKK SR – domy, pozemky, polia aj lesy.
- Kategória: Územie a kataster
- Kľúčové slová: letecká snímka, ortofoto, ortofotomozaika, satelit, foto
- Účely: construction, land-purchase, housing
- Zdroj: rastrové dlaždice (načítavajú sa priamo zo zdroja)
- Vizualizácia: `raster`
- Pokrytie: Slovensko; bbox 16.83, 47.73, 22.57, 49.62
- Atribúcia: © ÚGKK SR (CC BY 4.0)
- Mapa: https://datovamapa.sk/mapa/ugkk/ortofoto

### Katastrálna mapa

- Kľúč: `ugkk/katastralna-mapa`
- Popis: Hranice a čísla parciel registra C z katastra nehnuteľností. Zobrazuje sa až pri veľkom priblížení.
- Kategória: Územie a kataster
- Kľúčové slová: kataster, parcela, pozemok, hranice, parcelné číslo, KN, register C
- Účely: construction, land-purchase, housing
- Zdroj: rastrové dlaždice (načítavajú sa priamo zo zdroja)
- Vizualizácia: `raster`
- Pokrytie: Slovensko; bbox 16.83, 47.73, 22.57, 49.62; od priblíženia 16
- Aktuálnosť: denne
- Atribúcia: © ÚGKK SR (CC BY 4.0)
- Mapa: https://datovamapa.sk/mapa/ugkk/katastralna-mapa

### Administratívne hranice

- Kľúč: `ugkk/administrativne-hranice`
- Popis: Hranice štátu, krajov, okresov a obcí zo ZBGIS. Podrobnejšie úrovne pribúdajú s priblížením.
- Kategória: Územie a kataster
- Kľúčové slová: hranice, obec, kraj, okres, katastrálne územie, ZBGIS
- Účely: public-administration, land-purchase
- Zdroj: rastrové dlaždice (načítavajú sa priamo zo zdroja)
- Vizualizácia: `raster`
- Pokrytie: Slovensko; bbox 16.83, 47.73, 22.57, 49.62
- Atribúcia: © ÚGKK SR (CC BY 4.0)
- Mapa: https://datovamapa.sk/mapa/ugkk/administrativne-hranice

### Geografické názvy

- Kľúč: `ugkk/geograficke-nazvy`
- Popis: Úradné názvy sídiel, vrchov, vôd a ďalších objektov z Geografického názvoslovia ZBGIS.
- Kategória: Územie a kataster
- Kľúčové slová: názvy, názvoslovie, pomenovanie, vrch, potok, osada, lokalita
- Účely: tourism, public-administration
- Zdroj: rastrové dlaždice (načítavajú sa priamo zo zdroja)
- Vizualizácia: `raster`
- Pokrytie: Slovensko; bbox 16.83, 47.73, 22.57, 49.62
- Atribúcia: © ÚGKK SR (CC BY 4.0)
- Mapa: https://datovamapa.sk/mapa/ugkk/geograficke-nazvy

### Výškopis

- Kľúč: `ugkk/vyskopis`
- Popis: Nadmorská výška terénu z digitálneho modelu reliéfu ÚGKK, farebne od nížin po hory.
- Kategória: Územie a kataster
- Kľúčové slová: nadmorská výška, výškopis, terén, reliéf, DMR, hory, nížina
- Účely: construction, land-purchase, tourism
- Zdroj: rastrové dlaždice (načítavajú sa priamo zo zdroja)
- Vizualizácia: `raster`
- Pokrytie: Slovensko; bbox 16.83, 47.73, 22.57, 49.62
- Atribúcia: © ÚGKK SR (CC BY 4.0)
- Mapa: https://datovamapa.sk/mapa/ugkk/vyskopis

### Vodné toky

- Kľúč: `ugkk/vodne-toky`
- Popis: Sieť riek a potokov Slovenska zo ZBGIS.
- Kategória: Voda
- Kľúčové slová: rieka, potok, vodný tok, hydrografia, vodstvo
- Účely: construction, land-purchase, agriculture
- Zdroj: rastrové dlaždice (načítavajú sa priamo zo zdroja)
- Vizualizácia: `raster`
- Pokrytie: Slovensko; bbox 16.83, 47.73, 22.57, 49.62
- Atribúcia: © ÚGKK SR (CC BY 4.0)
- Mapa: https://datovamapa.sk/mapa/ugkk/vodne-toky

## Štatistický úrad SR

- Id: `susr`
- Popis: Demografické ukazovatele za okresy a obce z verejnej databázy DATAcube a výsledky volieb.
- Web: https://slovak.statistics.sk/
- Licencia: CC BY 4.0 (https://slovak.statistics.sk/wps/portal/ext/Databases/Open_data/), atribúcia „Zdroj: Štatistický úrad SR“
- Manifest spravuje DátováMapa (verejná služba, vlastník dát sa zatiaľ nepripojil sám).

### Hustota obyvateľstva

- Kľúč: `susr/hustota-obyvatelstva`
- Popis: Počet obyvateľov na km² k 1. 7. zvoleného roka. Pri oddialení za okresy, od priblíženia 9 za obce.
- Kategória: Spoločnosť a služby
- Kľúčové slová: hustota, zaľudnenie, počet obyvateľov, obyvatelia, demografia, obec, okres, štatistika, ŠÚ SR
- Účely: housing, investment, public-administration
- Zdroj: GeoJSON, režim `bbox` (dotaz s bbox a zoom); dáta: https://datovamapa.sk/api/data/susr/hustota-obyvatelstva
- Vizualizácia: `fill`
- Pokrytie: Slovensko; bbox 16.83, 47.73, 22.57, 49.62
- Aktuálnosť: ročne
- Atribúcia: Zdroj: Štatistický úrad SR (CC BY 4.0)
- Mapa: https://datovamapa.sk/mapa/susr/hustota-obyvatelstva

| Vlastnosť | Popisok | Typ | Jednotka |
|---|---|---|---|
| `nazov` | Územie | string |  |
| `uroven` | Úroveň | string |  |
| `hodnota` | Hustota obyvateľstva | number | obyv./km² |
| `rok` | Rok | integer |  |

| Parameter | Popisok | Typ | Možnosti / rozsah | Predvolené |
|---|---|---|---|---|
| `rok` | Rok | enum | `2025`, `2024`, `2023`, `2022`, `2021`, `2020`, `2019`, `2018`, `2017`, `2016` | 2025 |

### Priemerný vek obyvateľov

- Kľúč: `susr/priemerny-vek`
- Popis: Priemerný vek obyvateľov k 31. 12. zvoleného roka. Pri oddialení za okresy, od priblíženia 9 za obce.
- Kategória: Spoločnosť a služby
- Kľúčové slová: vek, priemerný vek, starnutie, obyvatelia, demografia, obec, okres, štatistika, ŠÚ SR
- Účely: housing, investment, public-administration
- Zdroj: GeoJSON, režim `bbox` (dotaz s bbox a zoom); dáta: https://datovamapa.sk/api/data/susr/priemerny-vek
- Vizualizácia: `fill`
- Pokrytie: Slovensko; bbox 16.83, 47.73, 22.57, 49.62
- Aktuálnosť: ročne
- Atribúcia: Zdroj: Štatistický úrad SR (CC BY 4.0)
- Mapa: https://datovamapa.sk/mapa/susr/priemerny-vek

| Vlastnosť | Popisok | Typ | Jednotka |
|---|---|---|---|
| `nazov` | Územie | string |  |
| `uroven` | Úroveň | string |  |
| `hodnota` | Priemerný vek | number | rokov |
| `rok` | Rok | integer |  |

| Parameter | Popisok | Typ | Možnosti / rozsah | Predvolené |
|---|---|---|---|---|
| `rok` | Rok | enum | `2025`, `2024`, `2023`, `2022`, `2021`, `2020`, `2019`, `2018`, `2017`, `2016` | 2025 |

### Index starnutia

- Kľúč: `susr/index-starnutia`
- Popis: Počet obyvateľov vo veku 65 a viac rokov na 100 detí do 14 rokov. Nad 100 je viac seniorov ako detí. Pri oddialení za okresy, od priblíženia 9 za obce.
- Kategória: Spoločnosť a služby
- Kľúčové slová: index starnutia, seniori, deti, starnutie, obyvatelia, demografia, obec, okres, štatistika, ŠÚ SR
- Účely: housing, investment, public-administration
- Zdroj: GeoJSON, režim `bbox` (dotaz s bbox a zoom); dáta: https://datovamapa.sk/api/data/susr/index-starnutia
- Vizualizácia: `fill`
- Pokrytie: Slovensko; bbox 16.83, 47.73, 22.57, 49.62
- Aktuálnosť: ročne
- Atribúcia: Zdroj: Štatistický úrad SR (CC BY 4.0)
- Mapa: https://datovamapa.sk/mapa/susr/index-starnutia

| Vlastnosť | Popisok | Typ | Jednotka |
|---|---|---|---|
| `nazov` | Územie | string |  |
| `uroven` | Úroveň | string |  |
| `hodnota` | Index starnutia | number | % |
| `rok` | Rok | integer |  |

| Parameter | Popisok | Typ | Možnosti / rozsah | Predvolené |
|---|---|---|---|---|
| `rok` | Rok | enum | `2025`, `2024`, `2023`, `2022`, `2021`, `2020`, `2019`, `2018`, `2017`, `2016` | 2025 |

### Prírastok obyvateľov

- Kľúč: `susr/prirastok-obyvatelstva`
- Popis: Celkový prírastok (narodení − zomretí + prisťahovaní − vysťahovaní) na 1 000 obyvateľov za zvolený rok. Pri oddialení za okresy, od priblíženia 9 za obce.
- Kategória: Spoločnosť a služby
- Kľúčové slová: prírastok, úbytok, sťahovanie, migrácia, rast obyvateľov, obyvatelia, demografia, obec, okres, štatistika, ŠÚ SR
- Účely: housing, investment, public-administration
- Zdroj: GeoJSON, režim `bbox` (dotaz s bbox a zoom); dáta: https://datovamapa.sk/api/data/susr/prirastok-obyvatelstva
- Vizualizácia: `fill`
- Pokrytie: Slovensko; bbox 16.83, 47.73, 22.57, 49.62
- Aktuálnosť: ročne
- Atribúcia: Zdroj: Štatistický úrad SR (CC BY 4.0)
- Mapa: https://datovamapa.sk/mapa/susr/prirastok-obyvatelstva

| Vlastnosť | Popisok | Typ | Jednotka |
|---|---|---|---|
| `nazov` | Územie | string |  |
| `uroven` | Úroveň | string |  |
| `hodnota` | Celkový prírastok | number | ‰ |
| `rok` | Rok | integer |  |

| Parameter | Popisok | Typ | Možnosti / rozsah | Predvolené |
|---|---|---|---|---|
| `rok` | Rok | enum | `2025`, `2024`, `2023`, `2022`, `2021`, `2020`, `2019`, `2018`, `2017`, `2016` | 2025 |

### Voľby do NR SR 2023 – účasť

- Kľúč: `susr/volby-2023-ucast`
- Popis: Volebná účasť v predčasných voľbách do Národnej rady SR 30. 9. 2023. Pri oddialení za okresy, od priblíženia 9 za obce. Bez hlasov voličov zo zahraničia.
- Kategória: Spoločnosť a služby
- Kľúčové slová: účasť, parlament, NR SR, 2023, voľby, hlasovanie, výsledky volieb, obec, okres
- Účely: public-administration, housing
- Zdroj: GeoJSON, režim `bbox` (dotaz s bbox a zoom); dáta: https://datovamapa.sk/api/data/susr/volby-2023-ucast
- Vizualizácia: `fill`
- Pokrytie: Slovensko; bbox 16.83, 47.73, 22.57, 49.62
- Aktuálnosť: 2023-10-01
- Atribúcia: Zdroj: Štatistický úrad SR (CC BY 4.0)
- Mapa: https://datovamapa.sk/mapa/susr/volby-2023-ucast

| Vlastnosť | Popisok | Typ | Jednotka |
|---|---|---|---|
| `nazov` | Územie | string |  |
| `uroven` | Úroveň | string |  |
| `ucast` | Účasť | number | % |
| `volici` | Zapísaní voliči | integer |  |
| `ps` | Progresívne Slovensko | number | % |
| `olano` | OĽANO a priatelia | number | % |
| `sas` | Sloboda a Solidarita | number | % |
| `sme_rodina` | SME RODINA | number | % |
| `sns` | Slovenská národná strana | number | % |
| `smer` | SMER – sociálna demokracia | number | % |
| `hlas` | HLAS – sociálna demokracia | number | % |
| `aliancia` | Aliancia | number | % |
| `demokrati` | Demokrati | number | % |
| `kdh` | Kresťanskodemokratické hnutie | number | % |
| `republika` | Republika | number | % |

### Voľby do NR SR 2023 – výsledky strán

- Kľúč: `susr/volby-2023-strany`
- Popis: Podiel platných hlasov vybranej strany vo voľbách do Národnej rady SR 2023. Pri oddialení za okresy, od priblíženia 9 za obce. Bez hlasov voličov zo zahraničia.
- Kategória: Spoločnosť a služby
- Kľúčové slová: strana, parlament, NR SR, 2023, SMER, PS, HLAS, KDH, SaS, SNS, Republika, voľby, hlasovanie, výsledky volieb, obec, okres
- Účely: public-administration, housing
- Zdroj: GeoJSON, režim `bbox` (dotaz s bbox a zoom); dáta: https://datovamapa.sk/api/data/susr/volby-2023-strany
- Vizualizácia: `fill`
- Pokrytie: Slovensko; bbox 16.83, 47.73, 22.57, 49.62
- Aktuálnosť: 2023-10-01
- Atribúcia: Zdroj: Štatistický úrad SR (CC BY 4.0)
- Mapa: https://datovamapa.sk/mapa/susr/volby-2023-strany

| Vlastnosť | Popisok | Typ | Jednotka |
|---|---|---|---|
| `vybrana` | Vybraná strana | number | % |
| `nazov` | Územie | string |  |
| `uroven` | Úroveň | string |  |
| `ucast` | Účasť | number | % |
| `volici` | Zapísaní voliči | integer |  |
| `ps` | Progresívne Slovensko | number | % |
| `olano` | OĽANO a priatelia | number | % |
| `sas` | Sloboda a Solidarita | number | % |
| `sme_rodina` | SME RODINA | number | % |
| `sns` | Slovenská národná strana | number | % |
| `smer` | SMER – sociálna demokracia | number | % |
| `hlas` | HLAS – sociálna demokracia | number | % |
| `aliancia` | Aliancia | number | % |
| `demokrati` | Demokrati | number | % |
| `kdh` | Kresťanskodemokratické hnutie | number | % |
| `republika` | Republika | number | % |

| Parameter | Popisok | Typ | Možnosti / rozsah | Predvolené |
|---|---|---|---|---|
| `strana` | Strana | enum | `ps`, `olano`, `sas`, `sme_rodina`, `sns`, `smer`, `hlas`, `aliancia`, `demokrati`, `kdh`, `republika` | smer |

### Prezidentské voľby 2024 – 2. kolo

- Kľúč: `susr/volby-2024-prezident`
- Popis: Podiel hlasov Petra Pellegriniho a Ivana Korčoka v 2. kole voľby prezidenta 6. 4. 2024. Pri oddialení za okresy, od priblíženia 9 za obce. Bez hlasov voličov zo zahraničia.
- Kategória: Spoločnosť a služby
- Kľúčové slová: prezident, Pellegrini, Korčok, 2024, druhé kolo, voľby, hlasovanie, výsledky volieb, obec, okres
- Účely: public-administration, housing
- Zdroj: GeoJSON, režim `bbox` (dotaz s bbox a zoom); dáta: https://datovamapa.sk/api/data/susr/volby-2024-prezident
- Vizualizácia: `fill`
- Pokrytie: Slovensko; bbox 16.83, 47.73, 22.57, 49.62
- Aktuálnosť: 2024-04-07
- Atribúcia: Zdroj: Štatistický úrad SR (CC BY 4.0)
- Mapa: https://datovamapa.sk/mapa/susr/volby-2024-prezident

| Vlastnosť | Popisok | Typ | Jednotka |
|---|---|---|---|
| `nazov` | Územie | string |  |
| `uroven` | Úroveň | string |  |
| `ucast` | Účasť | number | % |
| `volici` | Zapísaní voliči | integer |  |
| `korcok` | Ivan Korčok | number | % |
| `pellegrini` | Peter Pellegrini | number | % |

## Slovenská agentúra životného prostredia

- Id: `sazp`
- Popis: Odborná organizácia MŽP SR: krajinná pokrývka CORINE, register environmentálnych záťaží a podniky s nebezpečnými látkami (SEVESO).
- Web: https://www.sazp.sk/
- Licencia: Podmienky poskytovateľa (https://www.enviroportal.sk/), atribúcia „© SAŽP“
- Manifest spravuje DátováMapa (verejná služba, vlastník dát sa zatiaľ nepripojil sám).

### Krajinná pokrývka CORINE 2024

- Kľúč: `sazp/krajinna-pokryvka`
- Popis: Ako je krajina využitá: zástavba, orná pôda, lúky, lesy, vody. Celoeurópska klasifikácia z družicových snímok, slovenskú časť spracúva SAŽP.
- Kategória: Územie a kataster
- Kľúčové slová: krajinná pokrývka, využitie územia, CORINE, les, orná pôda, zástavba, land cover
- Účely: agriculture, investment
- Zdroj: rastrové dlaždice (načítavajú sa priamo zo zdroja)
- Vizualizácia: `raster`
- Pokrytie: Slovensko; bbox 16.83, 47.73, 22.57, 49.62
- Aktuálnosť: 2024
- Atribúcia: © EÚ, Copernicus Land Monitoring Service, SAŽP (Copernicus – voľné použitie)
- Mapa: https://datovamapa.sk/mapa/sazp/krajinna-pokryvka

### Environmentálne záťaže

- Kľúč: `sazp/environmentalne-zataze`
- Popis: Miesta znečistené ľudskou činnosťou – staré skládky, priemyselné areály, sklady pohonných hmôt – z Informačného systému environmentálnych záťaží. Aj sanované lokality.
- Kategória: Riziká a obmedzenia
- Kľúčové slová: environmentálna záťaž, kontaminácia, znečistenie, skládka, sanácia, staré záťaže, brownfield
- Účely: construction, land-purchase, housing, investment
- Zdroj: GeoJSON, režim `full`; len na zobrazenie v mape, dáta poskytuje pôvodná služba: https://arc.sazp.sk/arcgis/rest/services/env_zataze/environmentalna_zataz/MapServer
- Vizualizácia: `circle`
- Pokrytie: Slovensko; bbox 16.83, 47.73, 22.57, 49.62
- Aktuálnosť: priebežne
- Atribúcia: © SAŽP (Podmienky poskytovateľa)
- Mapa: https://datovamapa.sk/mapa/sazp/environmentalne-zataze

| Vlastnosť | Popisok | Typ | Jednotka |
|---|---|---|---|
| `nazov` | Lokalita | string |  |
| `register` | Register | string |  |
| `cinnost` | Činnosť | string |  |
| `priorita` | Priorita | string |  |
| `poloha` | Poloha | string |  |
| `obec` | Obec | string |  |
| `kod` | Kód záťaže | string |  |
| `aktualizovane` | Aktualizované | date |  |
| `odkaz` | Detail v registri | url |  |

### Podniky s nebezpečnými látkami (SEVESO)

- Kľúč: `sazp/seveso`
- Popis: Areály podnikov, ktoré pracujú s nebezpečnými látkami v množstve podľa zákona o prevencii závažných priemyselných havárií (SEVESO). Kategória B má prísnejšie povinnosti.
- Kategória: Riziká a obmedzenia
- Kľúčové slová: SEVESO, nebezpečné látky, priemyselná havária, chemička, riziko, podnik
- Účely: housing, construction, investment
- Zdroj: GeoJSON, režim `full`; len na zobrazenie v mape, dáta poskytuje pôvodná služba: https://arc.sazp.sk/arcgis/rest/services/seveso/podnik_pzph/MapServer
- Vizualizácia: `fill`
- Pokrytie: Slovensko; bbox 16.83, 47.73, 22.57, 49.62
- Atribúcia: © SAŽP (Podmienky poskytovateľa)
- Mapa: https://datovamapa.sk/mapa/sazp/seveso

| Vlastnosť | Popisok | Typ | Jednotka |
|---|---|---|---|
| `nazov` | Podnik | string |  |
| `kategoria` | Kategória | string |  |
| `prevadzkovatel` | Prevádzkovateľ | string |  |
| `cinnost` | Činnosť | string |  |
| `adresa` | Adresa | string |  |

## Štátny geologický ústav Dionýza Štúra

- Id: `sguds`
- Popis: Geologická služba Slovenska: geologické mapy, svahové deformácie a radónové riziko.
- Web: https://www.geology.sk/
- Licencia: Podmienky poskytovateľa (https://www.geology.sk/), atribúcia „© ŠGÚDŠ“
- Manifest spravuje DátováMapa (verejná služba, vlastník dát sa zatiaľ nepripojil sám).

### Geologická mapa 1 : 50 000

- Kľúč: `sguds/geologicka-mapa`
- Popis: Horniny a útvary pod povrchom podľa digitálnej geologickej mapy Slovenska. Legendu a popis útvarov nájdete u ŠGÚDŠ.
- Kategória: Príroda a krajina
- Kľúčové slová: geológia, geologická mapa, horniny, podložie, zlom
- Účely: construction, land-purchase
- Zdroj: rastrové dlaždice (načítavajú sa priamo zo zdroja)
- Vizualizácia: `raster`
- Pokrytie: Slovensko; bbox 16.83, 47.73, 22.57, 49.62
- Atribúcia: © ŠGÚDŠ (Podmienky poskytovateľa)
- Mapa: https://datovamapa.sk/mapa/sguds/geologicka-mapa

### Svahové deformácie (zosuvy)

- Kľúč: `sguds/svahove-deformacie`
- Popis: Zosuvy a iné svahové deformácie z Atlasu svahových deformácií. Aktívne sú ohraničené červenou, potenciálne fialovou, stabilizované čiernou.
- Kategória: Riziká a obmedzenia
- Kľúčové slová: zosuv, zosuvy, svahová deformácia, svah, stabilita, geologické riziko
- Účely: construction, land-purchase, housing
- Zdroj: rastrové dlaždice (načítavajú sa priamo zo zdroja)
- Vizualizácia: `raster`
- Pokrytie: Slovensko; bbox 16.83, 47.73, 22.57, 49.62
- Atribúcia: © ŠGÚDŠ (Podmienky poskytovateľa)
- Mapa: https://datovamapa.sk/mapa/sguds/svahove-deformacie

### Radónové riziko

- Kľúč: `sguds/radonove-riziko`
- Popis: Odhad rizika prenikania radónu z podložia do budov. Pred stavbou v strednom a vysokom riziku sa oplatí radónový prieskum pozemku.
- Kategória: Riziká a obmedzenia
- Kľúčové slová: radón, radónové riziko, podložie, stavba, radiácia
- Účely: construction, land-purchase, housing
- Zdroj: rastrové dlaždice (načítavajú sa priamo zo zdroja)
- Vizualizácia: `raster`
- Pokrytie: Slovensko; bbox 16.83, 47.73, 22.57, 49.62
- Atribúcia: © ŠGÚDŠ (Podmienky poskytovateľa)
- Mapa: https://datovamapa.sk/mapa/sguds/radonove-riziko

## Hlavné mesto SR Bratislava

- Id: `bratislava`
- Popis: Otvorené dáta hlavného mesta: výsadba stromov a nahlásené čierne skládky.
- Web: https://data.bratislava.sk/
- Licencia: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/), atribúcia „Zdroj: Hlavné mesto SR Bratislava“
- Manifest spravuje DátováMapa (verejná služba, vlastník dát sa zatiaľ nepripojil sám).

### Výsadba stromov v Bratislave

- Kľúč: `bratislava/vysadba-stromov`
- Popis: Stromy, ktoré mesto vysadilo od roku 2020 (aj v projekte 10 000 stromov), s druhom, rokom výsadby a veľkosťou sadenice. Od priblíženia 12.
- Kategória: Príroda a krajina
- Kľúčové slová: strom, výsadba, zeleň, 10 000 stromov, drevina, Bratislava
- Účely: housing
- Zdroj: GeoJSON, režim `bbox` (dotaz s bbox a zoom); dáta: https://datovamapa.sk/api/data/bratislava/vysadba-stromov
- Vizualizácia: `circle`
- Pokrytie: Bratislava; bbox 16.94, 48, 17.29, 48.27; od priblíženia 12
- Aktuálnosť: sezónne
- Atribúcia: Zdroj: Hlavné mesto SR Bratislava (CC BY 4.0)
- Mapa: https://datovamapa.sk/mapa/bratislava/vysadba-stromov

| Vlastnosť | Popisok | Typ | Jednotka |
|---|---|---|---|
| `druh` | Drevina | string |  |
| `druh_lat` | Latinsky | string |  |
| `kultivar` | Kultivar | string |  |
| `rok` | Rok výsadby | integer |  |
| `obdobie` | Obdobie | string |  |
| `projekt` | Projekt | string |  |
| `obvod_kmena` | Obvod kmeňa pri výsadbe | number | cm |
| `vyska` | Výška pri výsadbe | number | cm |
| `katastralne_uzemie` | Katastrálne územie | string |  |

### Čierne skládky v Bratislave (2025)

- Kľúč: `bratislava/cierne-skladky`
- Popis: Nelegálne skládky odpadu, ktoré mesto evidovalo v roku 2025, podľa katastrálneho územia.
- Kategória: Príroda a krajina
- Kľúčové slová: čierna skládka, nelegálna skládka, odpad, smetie, znečistenie, Bratislava
- Účely: housing
- Zdroj: GeoJSON, režim `full`; dáta: https://datovamapa.sk/api/data/bratislava/cierne-skladky
- Vizualizácia: `circle`
- Pokrytie: Bratislava; bbox 16.94, 48, 17.29, 48.27
- Aktuálnosť: 2025
- Atribúcia: Zdroj: Hlavné mesto SR Bratislava (CC BY 4.0)
- Mapa: https://datovamapa.sk/mapa/bratislava/cierne-skladky

| Vlastnosť | Popisok | Typ | Jednotka |
|---|---|---|---|
| `katastralne_uzemie` | Katastrálne územie | string |  |
| `parcela` | Parcela | string |  |

## Mesto Košice

- Id: `kosice`
- Popis: Otvorené dáta mesta Košice: doprava, ihriská, kultúra, turistické ciele a zeleň.
- Web: https://opendata.kosice.sk/
- Licencia: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/), atribúcia „Zdroj: Mesto Košice“
- Manifest spravuje DátováMapa (verejná služba, vlastník dát sa zatiaľ nepripojil sám).

### Zastávky MHD v Košiciach

- Kľúč: `kosice/zastavky-mhd`
- Popis: Zastávky električiek, trolejbusov a autobusov Dopravného podniku mesta Košice, každý smer zvlášť.
- Kategória: Doprava
- Kľúčové slová: zastávka, MHD, električka, autobus, trolejbus, DPMK, Košice
- Účely: transport, housing
- Zdroj: GeoJSON, režim `full`; dáta: https://datovamapa.sk/api/data/kosice/zastavky-mhd
- Vizualizácia: `circle`
- Pokrytie: Košice; bbox 21.13, 48.63, 21.36, 48.81
- Atribúcia: Zdroj: Mesto Košice (CC BY 4.0)
- Mapa: https://datovamapa.sk/mapa/kosice/zastavky-mhd

| Vlastnosť | Popisok | Typ | Jednotka |
|---|---|---|---|
| `nazov` | Zastávka | string |  |
| `smer` | Smer | string |  |
| `druh` | Druh | string |  |
| `elektricka` | Električka | boolean |  |
| `trolejbus` | Trolejbus | boolean |  |
| `autobus` | Autobus | boolean |  |
| `mestska_cast` | Mestská časť | string |  |

### Detské ihriská v Košiciach

- Kľúč: `kosice/detske-ihriska`
- Popis: Verejné detské ihriská s povrchom, správcom a oplotením.
- Kategória: Spoločnosť a služby
- Kľúčové slová: ihrisko, detské ihrisko, deti, hojdačka, pieskovisko, Košice
- Účely: housing
- Zdroj: GeoJSON, režim `full`; dáta: https://datovamapa.sk/api/data/kosice/detske-ihriska
- Vizualizácia: `circle`
- Pokrytie: Košice; bbox 21.13, 48.63, 21.36, 48.81
- Atribúcia: Zdroj: Mesto Košice (CC BY 4.0)
- Mapa: https://datovamapa.sk/mapa/kosice/detske-ihriska

| Vlastnosť | Popisok | Typ | Jednotka |
|---|---|---|---|
| `nazov` | Ihrisko | string |  |
| `povrch` | Povrch | string |  |
| `oplotene` | Oplotené | boolean |  |
| `spravca` | Správca | string |  |
| `mestska_cast` | Mestská časť | string |  |

### Workoutové ihriská v Košiciach

- Kľúč: `kosice/workoutove-ihriska`
- Popis: Verejné ihriská na cvičenie s vlastnou váhou: hrazdy, bradlá, rebriny.
- Kategória: Spoločnosť a služby
- Kľúčové slová: workout, cvičenie, posilňovňa, hrazda, šport, fitness, Košice
- Účely: housing
- Zdroj: GeoJSON, režim `full`; dáta: https://datovamapa.sk/api/data/kosice/workoutove-ihriska
- Vizualizácia: `circle`
- Pokrytie: Košice; bbox 21.13, 48.63, 21.36, 48.81
- Atribúcia: Zdroj: Mesto Košice (CC BY 4.0)
- Mapa: https://datovamapa.sk/mapa/kosice/workoutove-ihriska

| Vlastnosť | Popisok | Typ | Jednotka |
|---|---|---|---|
| `nazov` | Ihrisko | string |  |
| `povrch` | Povrch | string |  |
| `vymera` | Výmera | number | m² |
| `spravca` | Správca | string |  |
| `mestska_cast` | Mestská časť | string |  |

### Výbehy pre psov v Košiciach

- Kľúč: `kosice/vybehy-pre-psov`
- Popis: Vyhradené miesta na voľný pohyb psov, s výmerou a oplotením.
- Kategória: Spoločnosť a služby
- Kľúčové slová: pes, psy, výbeh, venčenie, psí výbeh, Košice
- Účely: housing
- Zdroj: GeoJSON, režim `full`; dáta: https://datovamapa.sk/api/data/kosice/vybehy-pre-psov
- Vizualizácia: `circle`
- Pokrytie: Košice; bbox 21.13, 48.63, 21.36, 48.81
- Atribúcia: Zdroj: Mesto Košice (CC BY 4.0)
- Mapa: https://datovamapa.sk/mapa/kosice/vybehy-pre-psov

| Vlastnosť | Popisok | Typ | Jednotka |
|---|---|---|---|
| `nazov` | Výbeh | string |  |
| `oplotene` | Oplotený | boolean |  |
| `vymera` | Výmera | number | m² |
| `spravca` | Správca | string |  |

### Fontány v Košiciach

- Kľúč: `kosice/fontany`
- Popis: Fontány a pítka v meste so stavom a správcom.
- Kategória: Spoločnosť a služby
- Kľúčové slová: fontána, pítko, voda, osvieženie, Košice
- Účely: tourism
- Zdroj: GeoJSON, režim `full`; dáta: https://datovamapa.sk/api/data/kosice/fontany
- Vizualizácia: `circle`
- Pokrytie: Košice; bbox 21.13, 48.63, 21.36, 48.81
- Atribúcia: Zdroj: Mesto Košice (CC BY 4.0)
- Mapa: https://datovamapa.sk/mapa/kosice/fontany

| Vlastnosť | Popisok | Typ | Jednotka |
|---|---|---|---|
| `nazov` | Fontána | string |  |
| `stav` | Stav | string |  |
| `adresa` | Adresa | string |  |
| `spravca` | Správca | string |  |

### Chránené stromy v Košiciach

- Kľúč: `kosice/chranene-stromy`
- Popis: Stromy vyhlásené za chránené, s druhom, výškou a obvodom kmeňa.
- Kategória: Príroda a krajina
- Kľúčové slová: chránený strom, strom, príroda, pamätný strom, drevina, Košice
- Účely: tourism
- Zdroj: GeoJSON, režim `full`; dáta: https://datovamapa.sk/api/data/kosice/chranene-stromy
- Vizualizácia: `circle`
- Pokrytie: Košice; bbox 21.13, 48.63, 21.36, 48.81
- Atribúcia: Zdroj: Mesto Košice (CC BY 4.0)
- Mapa: https://datovamapa.sk/mapa/kosice/chranene-stromy

| Vlastnosť | Popisok | Typ | Jednotka |
|---|---|---|---|
| `nazov` | Strom | string |  |
| `druh` | Druh | string |  |
| `vyska` | Výška | number | m |
| `obvod_kmena` | Obvod kmeňa | number | cm |
| `koruna` | Priemer koruny | number | m |
| `pocet` | Počet stromov | integer |  |
| `evidencne_cislo` | Evidenčné číslo | string |  |

### Turistické ciele v Košiciach

- Kľúč: `kosice/turisticke-ciele`
- Popis: Pamiatky, múzeá, príroda a zážitky v Košiciach podľa Visit Košice, s popisom a odkazom.
- Kategória: Spoločnosť a služby
- Kľúčové slová: turistika, pamiatka, čo vidieť, výlet, zážitok, Visit Košice, Košice
- Účely: tourism
- Zdroj: GeoJSON, režim `full`; dáta: https://datovamapa.sk/api/data/kosice/turisticke-ciele
- Vizualizácia: `circle`
- Pokrytie: Košice; bbox 21.13, 48.63, 21.36, 48.81
- Atribúcia: Zdroj: Mesto Košice (CC BY 4.0)
- Mapa: https://datovamapa.sk/mapa/kosice/turisticke-ciele

| Vlastnosť | Popisok | Typ | Jednotka |
|---|---|---|---|
| `nazov` | Cieľ | string |  |
| `kategoria` | Kategória | string |  |
| `popis` | Popis | string |  |
| `adresa` | Adresa | string |  |
| `odkaz` | Visit Košice | url |  |
| `web` | Web | url |  |

### Kultúrne inštitúcie v Košiciach

- Kľúč: `kosice/kulturne-institucie`
- Popis: Divadlá, galérie, múzeá, knižnice, kiná a kultúrne strediská s kontaktmi.
- Kategória: Spoločnosť a služby
- Kľúčové slová: kultúra, divadlo, galéria, múzeum, knižnica, kino, Košice
- Účely: tourism, housing
- Zdroj: GeoJSON, režim `full`; dáta: https://datovamapa.sk/api/data/kosice/kulturne-institucie
- Vizualizácia: `circle`
- Pokrytie: Košice; bbox 21.13, 48.63, 21.36, 48.81
- Atribúcia: Zdroj: Mesto Košice (CC BY 4.0)
- Mapa: https://datovamapa.sk/mapa/kosice/kulturne-institucie

| Vlastnosť | Popisok | Typ | Jednotka |
|---|---|---|---|
| `nazov` | Inštitúcia | string |  |
| `typ` | Typ | string |  |
| `adresa` | Adresa | string |  |
| `zriadovatel` | Zriaďovateľ | string |  |
| `telefon` | Telefón | phone |  |
| `email` | E-mail | email |  |
| `web` | Web | url |  |

## nextbike

- Id: `nextbike`
- Popis: Zdieľané bicykle v Bratislave, Žiline, Senci, Senici a v Trnavskom kraji. Dostupnosť bicyklov na staniciach v reálnom čase.
- Web: https://www.nextbike.sk/
- Licencia: CC0 1.0 (https://creativecommons.org/publicdomain/zero/1.0/), atribúcia „nextbike“
- Manifest spravuje DátováMapa (verejná služba, vlastník dát sa zatiaľ nepripojil sám).

### Zdieľané bicykle nextbike (naživo)

- Kľúč: `nextbike/zdielane-bicykle`
- Popis: Stanice zdieľaných bicyklov a počet bicyklov, ktoré si teraz môžete požičať.
- Kategória: Doprava
- Kľúčové slová: zdieľané bicykle, bikesharing, bicykel, nextbike, požičanie bicykla, mobilita, BikeKIA, bajk
- Účely: transport, tourism
- Zdroj: GeoJSON, režim `full`; dáta: https://datovamapa.sk/api/data/nextbike/zdielane-bicykle
- Vizualizácia: `circle`
- Pokrytie: Slovensko; bbox 16.83, 47.73, 22.57, 49.62
- Aktuálnosť: každú minútu
- Atribúcia: nextbike (CC0 1.0)
- Mapa: https://datovamapa.sk/mapa/nextbike/zdielane-bicykle

| Vlastnosť | Popisok | Typ | Jednotka |
|---|---|---|---|
| `nazov` | Stanica | string |  |
| `mesto` | Mesto | string |  |
| `system` | Systém | string |  |
| `bicykle` | Voľné bicykle | integer |  |
| `stojany` | Stojany | integer |  |
| `volne_stojany` | Voľné stojany | integer |  |

## Sensor.Community

- Id: `sensor-community`
- Popis: Občianska sieť lacných senzorov prachových častíc. Neoficiálne meranie, slúži na orientáciu.
- Web: https://sensor.community/sk/
- Licencia: ODC DbCL 1.0 (https://opendatacommons.org/licenses/dbcl/1-0/), atribúcia „Sensor.Community“
- Manifest spravuje DátováMapa (verejná služba, vlastník dát sa zatiaľ nepripojil sám).

### Prach z občianskych senzorov (naživo)

- Kľúč: `sensor-community/prachove-castice`
- Popis: Koncentrácia jemného prachu PM2,5 a PM10 z domácich senzorov za posledných 5 minút. Hustejšia sieť ako štátne stanice, ale nižšia presnosť.
- Kategória: Príroda a krajina
- Kľúčové slová: prach, PM2,5, PM10, smog, ovzdušie, senzor, lokálne kúreniská
- Účely: housing
- Zdroj: GeoJSON, režim `full`; dáta: https://datovamapa.sk/api/data/sensor-community/prachove-castice
- Vizualizácia: `circle`
- Pokrytie: Slovensko; bbox 16.83, 47.73, 22.57, 49.62
- Aktuálnosť: každých 5 minút
- Atribúcia: Sensor.Community (ODC DbCL 1.0)
- Mapa: https://datovamapa.sk/mapa/sensor-community/prachove-castice

| Vlastnosť | Popisok | Typ | Jednotka |
|---|---|---|---|
| `pm25` | PM2,5 | number | µg/m³ |
| `pm10` | PM10 | number | µg/m³ |
| `merane` | Merané (UTC) | string |  |

## Euro-stredomorské seizmologické centrum (EMSC)

- Id: `emsc`
- Popis: Európske centrum, ktoré zbiera hlásenia seizmických observatórií vrátane slovenských. Zachytí aj slabé otrasy na Slovensku.
- Web: https://www.emsc-csem.org/
- Licencia: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/), atribúcia „EMSC-CSEM“
- Manifest spravuje DátováMapa (verejná služba, vlastník dát sa zatiaľ nepripojil sám).

### Zemetrasenia v Európe a okolí

- Kľúč: `emsc/zemetrasenia`
- Popis: Otrasy za zvolené obdobie v aktuálnom výreze mapy, aj slabé lokálne otrasy (napr. v okolí Žiliny či Komárna).
- Kategória: Riziká a obmedzenia
- Kľúčové slová: zemetrasenie, otras, seizmicita, Komárno, Žilina, Malé Karpaty
- Účely: construction, housing
- Zdroj: GeoJSON, režim `bbox` (dotaz s bbox a zoom); dáta: https://datovamapa.sk/api/data/emsc/zemetrasenia
- Vizualizácia: `circle`
- Pokrytie: Svet, podrobne Európa; bbox -180, -85, 180, 85
- Aktuálnosť: priebežne
- Atribúcia: EMSC-CSEM (CC BY 4.0)
- Mapa: https://datovamapa.sk/mapa/emsc/zemetrasenia

| Vlastnosť | Popisok | Typ | Jednotka |
|---|---|---|---|
| `miesto` | Miesto | string |  |
| `magnitudo` | Magnitúdo | number |  |
| `hlbka` | Hĺbka | number | km |
| `cas` | Čas | datetime |  |
| `pred_h` | Pred | integer | h |
| `odkaz` | Detail u zdroja | url |  |
| `zdroj` | Observatórium | string |  |

| Parameter | Popisok | Typ | Možnosti / rozsah | Predvolené |
|---|---|---|---|---|
| `dni` | Za posledných | enum | `1`, `7`, `30`, `365` | 30 |
| `minmag` | Najmenšie magnitúdo | number | 0–7 | 0 |

## U.S. Geological Survey

- Id: `usgs`
- Popis: Americká geologická služba. Celosvetový katalóg zemetrasení aktualizovaný každú minútu.
- Web: https://earthquake.usgs.gov/
- Licencia: Public domain (https://www.usgs.gov/information-policies-and-instructions/copyrights-and-credits), atribúcia „USGS“
- Manifest spravuje DátováMapa (verejná služba, vlastník dát sa zatiaľ nepripojil sám).

### Zemetrasenia vo svete

- Kľúč: `usgs/zemetrasenia`
- Popis: Zemetrasenia zaznamenané po celom svete. Veľkosť kruhu zodpovedá magnitúdu, farba veku otrasu.
- Kategória: Riziká a obmedzenia
- Kľúčové slová: zemetrasenie, otras, seizmicita, magnitúdo, cunami
- Účely: tourism, investment
- Zdroj: GeoJSON, režim `full`; dáta: https://datovamapa.sk/api/data/usgs/zemetrasenia
- Vizualizácia: `circle`
- Pokrytie: Svet; bbox -180, -85, 180, 85
- Aktuálnosť: každú minútu
- Atribúcia: USGS (Public domain)
- Mapa: https://datovamapa.sk/mapa/usgs/zemetrasenia

| Vlastnosť | Popisok | Typ | Jednotka |
|---|---|---|---|
| `miesto` | Miesto | string |  |
| `magnitudo` | Magnitúdo | number |  |
| `hlbka` | Hĺbka | number | km |
| `cas` | Čas | datetime |  |
| `pred_h` | Pred | integer | h |
| `odkaz` | Detail u zdroja | url |  |
| `cunami` | Varovanie pred cunami | boolean |  |

| Parameter | Popisok | Typ | Možnosti / rozsah | Predvolené |
|---|---|---|---|---|
| `obdobie` | Obdobie a sila | enum | `2.5_day`, `2.5_week`, `4.5_month`, `significant_month` | 2.5_week |

## Global Disaster Alert and Coordination System

- Id: `gdacs`
- Popis: Spoločný výstražný systém OSN a Európskej komisie pre prírodné katastrofy.
- Web: https://www.gdacs.org/
- Licencia: Podmienky GDACS (https://www.gdacs.org/About/termsofuse.aspx), atribúcia „GDACS (OSN, Európska komisia)“
- Manifest spravuje DátováMapa (verejná služba, vlastník dát sa zatiaľ nepripojil sám).

### Prebiehajúce katastrofy vo svete

- Kľúč: `gdacs/katastrofy`
- Popis: Aktuálne výstrahy pred zemetraseniami, cyklónami, povodňami, sopkami, suchom a požiarmi. Farba podľa závažnosti, výstrahy sa generujú automaticky.
- Kategória: Riziká a obmedzenia
- Kľúčové slová: katastrofa, povodeň, cyklóna, hurikán, sopka, sucho, požiar, výstraha
- Účely: tourism, investment
- Zdroj: GeoJSON, režim `full`; dáta: https://datovamapa.sk/api/data/gdacs/katastrofy
- Vizualizácia: `circle`
- Pokrytie: Svet; bbox -180, -85, 180, 85
- Aktuálnosť: priebežne
- Atribúcia: GDACS (OSN, Európska komisia) (Podmienky GDACS)
- Mapa: https://datovamapa.sk/mapa/gdacs/katastrofy

| Vlastnosť | Popisok | Typ | Jednotka |
|---|---|---|---|
| `nazov` | Udalosť | string |  |
| `typ` | Typ | string |  |
| `zavaznost` | Závažnosť | string |  |
| `skore` | Skóre výstrahy | number |  |
| `krajina` | Krajina | string |  |
| `od` | Od | datetime |  |
| `do` | Do | datetime |  |
| `odkaz` | Správa GDACS | url |  |

| Parameter | Popisok | Typ | Možnosti / rozsah | Predvolené |
|---|---|---|---|---|
| `typ` | Typy udalostí | multi-enum | `EQ`, `TC`, `FL`, `VO`, `DR`, `WF` |  |

## Wikipédia

- Id: `wikipedia`
- Popis: Otvorená encyklopédia. Články s polohou zo slovenskej Wikipédie.
- Web: https://sk.wikipedia.org/
- Licencia: CC BY-SA 4.0 (https://creativecommons.org/licenses/by-sa/4.0/), atribúcia „Wikipédia“
- Manifest spravuje DátováMapa (verejná služba, vlastník dát sa zatiaľ nepripojil sám).

### Články Wikipédie v okolí

- Kľúč: `wikipedia/clanky`
- Popis: Miesta, stavby a pamiatky, o ktorých existuje článok na slovenskej Wikipédii. Hľadá sa v okolí stredu mapy (cca 20 × 20 km).
- Kategória: Spoločnosť a služby
- Kľúčové slová: wikipédia, pamiatka, zaujímavosť, história, čo vidieť, turistika, článok
- Účely: tourism, housing
- Zdroj: GeoJSON, režim `bbox` (dotaz s bbox a zoom); dáta: https://datovamapa.sk/api/data/wikipedia/clanky
- Vizualizácia: `circle`
- Pokrytie: Svet; bbox -180, -85, 180, 85; od priblíženia 12
- Aktuálnosť: priebežne
- Atribúcia: Wikipédia (CC BY-SA 4.0)
- Mapa: https://datovamapa.sk/mapa/wikipedia/clanky

| Vlastnosť | Popisok | Typ | Jednotka |
|---|---|---|---|
| `nazov` | Článok | string |  |
| `popis` | Popis | string |  |
| `typ` | Typ | string |  |
| `obrazok` | Obrázok | image |  |
| `odkaz` | Wikipédia | url |  |

## NASA Earth Observing System (GIBS)

- Id: `nasa`
- Popis: Denné satelitné snímky Zeme z družíc NASA.
- Web: https://www.earthdata.nasa.gov/engage/open-data-services-software/earthdata-developer-portal/gibs-api
- Licencia: NASA open data (https://www.earthdata.nasa.gov/engage/open-data-services-software/data-and-information-policy), atribúcia „NASA EOSDIS GIBS“
- Manifest spravuje DátováMapa (verejná služba, vlastník dát sa zatiaľ nepripojil sám).

### Satelitná snímka dňa

- Kľúč: `nasa/druzicova-snimka-dna`
- Popis: Najnovšia denná snímka z družice Terra (MODIS) v prirodzených farbách. Ukáže oblačnosť, sneh, dym alebo zákal po povodniach. Rozlíšenie cca 250 m.
- Kategória: Príroda a krajina
- Kľúčové slová: satelit, družica, snímka, oblačnosť, počasie, sneh, MODIS
- Účely: agriculture, tourism
- Zdroj: rastrové dlaždice (načítavajú sa priamo zo zdroja)
- Vizualizácia: `raster`
- Pokrytie: Svet; bbox -180, -85, 180, 85
- Aktuálnosť: denne
- Atribúcia: NASA EOSDIS GIBS (NASA open data)
- Mapa: https://datovamapa.sk/mapa/nasa/druzicova-snimka-dna

### Nočné svetlá

- Kľúč: `nasa/nocne-svetla`
- Popis: Umelé osvetlenie Zeme v noci (VIIRS Black Marble). Ukazuje zástavbu, cesty a svetelné znečistenie.
- Kategória: Spoločnosť a služby
- Kľúčové slová: nočné svetlá, svetelné znečistenie, osvetlenie, zástavba, noc
- Účely: housing, investment
- Zdroj: rastrové dlaždice (načítavajú sa priamo zo zdroja)
- Vizualizácia: `raster`
- Pokrytie: Svet; bbox -180, -85, 180, 85
- Atribúcia: NASA EOSDIS GIBS (NASA open data)
- Mapa: https://datovamapa.sk/mapa/nasa/nocne-svetla

## Európska environmentálna agentúra

- Id: `eea`
- Web: https://www.eea.europa.eu/
- Licencia: CC BY 4.0 (https://www.eea.europa.eu/en/legal-notice), atribúcia „© EEA“
- Manifest spravuje DátováMapa (verejná služba, vlastník dát sa zatiaľ nepripojil sám).

### Prach PM2,5 – ročný priemer

- Kľúč: `eea/prach-pm25`
- Popis: Priemerná ročná koncentrácia jemného prachu PM2,5 v mriežke 1 km pre celú Európu, modelovaná z meraní staníc, satelitov a ďalších dát. Ukáže, kde je vzduch dlhodobo horší – na rozdiel od živých meraní nezávisí od dnešného počasia. Odporúčanie WHO je 5 µg/m³, limit EÚ 25 µg/m³ (od roku 2030 10 µg/m³).
- Kategória: Príroda a krajina
- Kľúčové slová: prach, PM2,5, znečistenie ovzdušia, kvalita ovzdušia, smog, ročný priemer, jemné častice
- Účely: housing, investment
- Zdroj: rastrové dlaždice (načítavajú sa priamo zo zdroja)
- Vizualizácia: `raster`
- Pokrytie: Európa; bbox -31, 27, 45, 72
- Aktuálnosť: 2022
- Atribúcia: © EEA (CC BY 4.0)
- Mapa: https://datovamapa.sk/mapa/eea/prach-pm25

### Natura 2000 v Európe

- Kľúč: `eea/natura-2000`
- Popis: Územia európskeho významu a chránené vtáčie územia sústavy Natura 2000 vo všetkých štátoch EÚ.
- Kategória: Príroda a krajina
- Kľúčové slová: natura 2000, územie európskeho významu, chránené vtáčie územie, ochrana prírody, ÚEV, CHVÚ
- Účely: construction, land-purchase
- Zdroj: rastrové dlaždice (načítavajú sa priamo zo zdroja)
- Vizualizácia: `raster`
- Pokrytie: Európska únia; bbox -31, 27, 45, 72
- Aktuálnosť: ročne
- Atribúcia: © EEA (CC BY 4.0)
- Mapa: https://datovamapa.sk/mapa/eea/natura-2000

## OpenStreetMap – komunitné mapy

- Id: `osm`
- Popis: Tematické mapy z dát OpenStreetMap od dobrovoľníckych projektov (Waymarked Trails, OpenRailwayMap, OpenTopoMap). Servery majú obmedzenú kapacitu.
- Web: https://www.openstreetmap.org/
- Licencia: ODbL / CC BY-SA (https://www.openstreetmap.org/copyright), atribúcia „dáta © prispievatelia OpenStreetMap“
- Manifest spravuje DátováMapa (verejná služba, vlastník dát sa zatiaľ nepripojil sám).

### Turistické trasy

- Kľúč: `osm/turisticke-trasy`
- Popis: Značené pešie trasy vrátane farby značenia (KST) z OpenStreetMap.
- Kategória: Doprava
- Kľúčové slová: turistika, turistické značenie, KST, pešia trasa, výlet, chôdza
- Účely: tourism
- Zdroj: rastrové dlaždice (načítavajú sa priamo zo zdroja)
- Vizualizácia: `raster`
- Pokrytie: Svet; bbox -180, -85, 180, 85
- Aktuálnosť: denne
- Atribúcia: Waymarked Trails, dáta © prispievatelia OpenStreetMap (CC BY-SA 3.0)
- Mapa: https://datovamapa.sk/mapa/osm/turisticke-trasy

### Cyklotrasy

- Kľúč: `osm/cyklotrasy`
- Popis: Značené cyklistické trasy a cyklochodníky z OpenStreetMap (Waymarked Trails), medzinárodné, národné aj miestne.
- Kategória: Doprava
- Kľúčové slová: cyklotrasa, bicykel, cyklistika, cyklochodník, výlet
- Účely: tourism, transport
- Zdroj: rastrové dlaždice (načítavajú sa priamo zo zdroja)
- Vizualizácia: `raster`
- Pokrytie: Svet; bbox -180, -85, 180, 85
- Aktuálnosť: denne
- Atribúcia: Waymarked Trails, dáta © prispievatelia OpenStreetMap (CC BY-SA 3.0)
- Mapa: https://datovamapa.sk/mapa/osm/cyklotrasy

### Železničná sieť

- Kľúč: `osm/zeleznice`
- Popis: Železničné trate, stanice a vlečky celého sveta z OpenRailwayMap (dáta OpenStreetMap).
- Kategória: Doprava
- Kľúčové slová: železnica, vlak, trať, stanica, vlečka
- Účely: transport, housing
- Zdroj: rastrové dlaždice (načítavajú sa priamo zo zdroja)
- Vizualizácia: `raster`
- Pokrytie: Svet; bbox -180, -85, 180, 85
- Atribúcia: OpenRailwayMap, dáta © prispievatelia OpenStreetMap (CC BY-SA 2.0)
- Mapa: https://datovamapa.sk/mapa/osm/zeleznice

### Topografická mapa

- Kľúč: `osm/topograficka-mapa`
- Popis: Krajina s vrstevnicami a tieňovaním terénu (OpenTopoMap). Prekryje podkladovú mapu.
- Kategória: Územie a kataster
- Kľúčové slová: topografická mapa, vrstevnice, terén, turistická mapa, výškopis
- Účely: tourism, construction
- Zdroj: rastrové dlaždice (načítavajú sa priamo zo zdroja)
- Vizualizácia: `raster`
- Pokrytie: Svet; bbox -180, -85, 180, 85
- Atribúcia: © OpenTopoMap, dáta © prispievatelia OpenStreetMap (CC BY-SA 3.0)
- Mapa: https://datovamapa.sk/mapa/osm/topograficka-mapa