Protokol DatováMapa 0.1
Normativní popis rozhraní mezi poskytovatelem dat a portálem. Při rozporu s jinou dokumentací platí tento dokument a strojová schémata:
- JSON Schema manifestu a JSON Schema dat – generované ze zod schémat v
src/lib/protocol/, - OpenAPI kontrakt poskytovatele.
Postup přípravy dat krok za krokem (zejména pro AI agenty) je v návodu pro AI agenty, srozumitelný úvod v průvodci pro poskytovatele. Platné vzory: manifest-complete.json, data-points.json.
Přehled
Poskytovatel Portál DatováMapa Prohlížeč
───────────── ───────────────── ─────────
manifest.json ◄── GET (cache 10 min) ── registr → katalog ──────────► /api/catalog
data endpoint ◄── GET ?bbox&zoom&… ──── proxy + validace + cache ───► /api/data/{provider}/{dataset}
rastrové dlaždice ◄───────────────────────────────────────────────────── přímo z prohlížeče
Obecná pravidla
- Formát JSON, kódování UTF-8, souřadnice WGS84 (EPSG:4326) v pořadí
[lon, lat]. - Komunikace přes HTTPS (http jen pro
localhostpři vývoji). - Neznámá pole se ignorují. Neznámý typ
presentationse vykreslí jakoauto. - Verze
protocolve tvarumajor.minor. Portál přijme manifest se stejnou hlavní verzí. - Identifikátory (
provider.id,dataset.id): malá písmena bez diakritiky, číslice, pomlčky, max. 64 znaků. Globální klíč sady jeprovider/dataset. - Barvy jen v hex zápisu (
#rgb,#rrggbb,#rrggbbaa).
Manifest
| Pole | Povinné | Popis |
|---|---|---|
protocol |
ano | Verze protokolu, např. "0.1" |
provider.id |
ano | Identifikátor; musí odpovídat id v registru portálu |
provider.name |
ano | Název zobrazovaný jako zdroj |
provider.description, homepage, logo, contact |
ne | |
provider.managedBy |
ne | provider (výchozí) / portal – manifest pro veřejnou službu udržuje DatováMapa |
license |
ne | { name, url?, attribution } – výchozí licence všech sad |
datasets[] |
ano | 1–200 datových sad s unikátním id |
Datová sada
| Pole | Povinné | Popis |
|---|---|---|
id, title |
ano | |
description |
ne | |
category |
ne | territory, nature, water, risks, energy, transport, society, economy, infrastructure, sample, other; jiná hodnota → Ostatní |
tags, keywords |
ne | Pro vyhledávání a budoucího asistenta |
useCases |
ne | Účely, pro které se sada hodí: construction, housing, land-purchase, agriculture, investment… |
coverage |
ne | { bbox?, area?, minZoom?, maxZoom? } – pod minZoom portál data nenačítá |
temporal |
ne | { updated?, frequency?, param? } – param = klíč parametru, kterým se volí období (viz časový filtr) |
license |
ne | Přepisuje licenci poskytovatele |
source |
ano | Odkud data brát (viz níže) |
presentation |
ano | Jak data vykreslit (viz níže) |
fields[] |
ne | Popis vlastností objektů: key, label, type, unit, decimals, description, primary |
params[] |
ne | Filtry pro uživatele (viz níže) |
cache |
ne | { ttl?: sekundy, store?: boolean } |
live |
ne | { interval: sekundy } – živá data: otevřená mapa sadu sama obnovuje (10 až 3600 s), viz cache |
detail |
ne | { url } – detail objektu na vyžádání po kliknutí (jízdní řád, bohatší popis, zvýraznění v mapě), viz detail objektu |
profile |
ne | Druh sady se společným chováním v portálu: transit_vehicles = živé polohy vozidel veřejné dopravy, viz doprava |
source
geojson – nativní formát.
{ "type": "geojson", "url": "/data/kontejnery", "mode": "bbox", "maxFeatures": 5000 }
urlmůže být relativní vůči URL manifestu. Zdrojem může být i statický soubor (lavicky.geojsonvedlemanifest.jsonna libovolném webovém hostingu) – v režimufullportál žádné query parametry nevyžaduje a soubor je platný endpoint.mode: "full"– celá sada jedním dotazem (malé sady).mode: "bbox"– portál se ptá na výřez mapy.maxFeatures≤ 5000.
raster – hotové dlaždice, prohlížeč je načítá přímo ze zdroje.
{ "type": "raster", "tiles": ["https://…/{z}/{x}/{y}.png"], "tileSize": 256, "minZoom": 0, "maxZoom": 19 }
Šablony podporují {z}/{x}/{y} i {bbox-epsg-3857} (WMS GetMap). Jen https.
image – jeden georeferencovaný obrázek přes celé území (radar, družicový snímek, předpovědní mapa), nebo řada snímků v čase. Prohlížeč ho načítá přes portál (/api/image/…), zdroj tedy nemusí posílat hlavičky CORS.
{ "type": "image", "frames": "radar.json", "coordinates": [[11.267, 51.458], [19.624, 51.458], [19.624, 48.047], [11.267, 48.047]] }
coordinatesjsou rohy obrázku[délka, šířka]v pořadí levý horní, pravý horní, pravý dolní, levý dolní. Obrázek musí být v projekci Web Mercator (EPSG:3857), jinak mezi rohy nesedne na mapu.- Buď
url(jeden obrázek PNG, JPEG nebo WebP), neboframes(JSON se snímky v čase). Obojí může být relativní vůči manifestu. - Snímky:
{ "frames": [{ "time": "2026-11-11T09:15:00Z", "url": "radar/0915.png", "preview": "radar/p0915.png" }, { "time": "2026-11-11T09:25:00Z", "url": "radar/f0915-10.png", "forecast": true }] }. Od nejstaršího, nejvýš 48,urlrelativní vůči souboru se snímky,forecastu předpovědi. Portál snímky přehrává, výchozí je poslední měřený, a seznam obnovuje podlelive.interval. Změněný obrázek dejte na novou adresu: obrázky snímků z řady portál drží v cache až den. Volitelnépreviewje zmenšená verze snímku (třeba poloviční rozlišení); portál ji použije pro přehled, například pozadí hlavní stránky. - Prezentace je vždy
raster; legendu uveďte ručně.
presentation
type |
Geometrie | Volby |
|---|---|---|
circle |
body | color, radius, opacity, strokeColor, strokeWidth, label, cluster |
heatmap |
body | weight, radius, intensity, colors[], opacity |
line |
linie | color, width, opacity, dash[], label |
fill |
plochy | color, opacity, outlineColor, outlineWidth, label |
raster |
dlaždice, obrázek | opacity |
auto |
cokoli | color |
Všechny typy mají volitelnou legend: [{ label, color }] (max. 20 položek). Portál ji ukazuje v legendě přímo v mapě a ve výběru vrstev. U vektorových typů ji umí odvodit z barev, u raster ne – barvy jsou zapečené v obrázcích dlaždic, takže legendu rastru uveďte ručně (např. převzetím z legendy WMS / ArcGIS služby).
Barva (color) je buď hex řetězec, nebo pravidlo podle vlastnosti objektu:
{ "field": "druh", "type": "categorical", "values": { "papír": "#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 barví objekty podle toho, zda jejich hodnota v čase roste, stagnuje, nebo klesá. Počítá ho portál z grafu vývoje dm.chart – viz vývoj v čase a trend.
Číslo (radius, width, weight) je číslo nebo { "field", "type": "interpolate", "stops": [[hodnota, číslo], …] }.
Popisek (label): { field, minZoom?, color?, size? }.
params
Filtr, který uživatel nastaví v portálu; portál ho pošle jako query parametr key=value.
type |
Hodnota v dotazu |
|---|---|
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 znaků) |
Klíče bbox, zoom, limit, cursor, lang, protocol jsou rezervované. Portál posílá jen deklarované parametry a hodnoty předem ověří; nevyplněný parametr nahradí default.
Časový filtr
Data v čase (nehody, měření, události) mají jeden parametr pro období a odkazují na něj z temporal.param. Portál ho pak neukazuje mezi ostatními filtry, ale jako časovou osu v okně pod legendou: posuvník období a sloupcový graf po letech, ve kterém jde období vybrat kliknutím nebo tažením. Zvolené období je vidět i u vrstvy v legendě.
- Typ
ranges roky –minamaxjsou první a poslední rok dat, hodnotaod,do(např.2019,2023, jeden rok2023,2023). Objekty za celé období vracejte dohromady (souhrnně), ne po jednotlivých letech. - Typ
date-range– období po dnech,2026-01-01,2026-06-30.
{
"protocol": "0.1",
"provider": { "id": "mesto-priklad", "name": "Město Příklad" },
"license": { "name": "CC BY 4.0", "attribution": "© Město Příklad" },
"datasets": [{
"id": "nehody",
"title": "Dopravní nehody",
"description": "Nehody evidované Policií ČR podle následků.",
"category": "transport",
"keywords": ["nehoda", "dopravní nehoda", "bezpečnost", "zranění", "křižovatka"],
"useCases": ["transport", "housing"],
"coverage": { "bbox": [16.43, 49.1, 16.73, 49.3], "minZoom": 12 },
"temporal": { "frequency": "ročně", "param": "obdobi" },
"source": { "type": "geojson", "url": "https://data.mesto-priklad.cz/datovamapa/nehody", "mode": "bbox", "maxFeatures": 5000 },
"presentation": {
"type": "circle",
"color": { "field": "nasledky", "type": "categorical", "values": { "zranění": "#dc2626", "hmotná škoda": "#facc15" }, "default": "#facc15" }
},
"fields": [
{ "key": "nasledky", "label": "Následky", "type": "string", "primary": true },
{ "key": "datum", "label": "Datum", "type": "date" }
],
"params": [{ "key": "obdobi", "label": "Období", "type": "range", "min": 2015, "max": 2025, "step": 1, "default": "2025,2025" }]
}]
}
Graf kreslí portál z dm.timeline v odpovědi (viz datová odpověď). U hodnot v čase, kde počty objektů nedávají smysl (počet obyvatel, cena), pošlete místo něj souhrnný vývoj v dm.chart – portál ho u posuvníku ukáže jako čárový graf, viz vývoj v čase a trend. Bez obojího zůstane jen posuvník období.
Vývoj v čase a trend
Standardní zobrazení dat, jejichž hodnota se u objektu mění v čase – počet obyvatel obce, cena, naměřená koncentrace, návštěvnost. Kdykoli data takovou řadu mají, posílejte ji; portál z ní sám kreslí graf a umí podle ní barvit.
- Graf vývoje. Má-li objekt hodnotu za více období, pošlete ji v
feature.dm.chart(viz datová odpověď). Portál ji ukáže v detailu objektu jako čárový graf s hodnotou za zvolené období a změnou proti jeho začátku. Platí to i pro kartogramy, kde se rok volí parametrem: pošlete řadu za všechny roky a zvolený rok jakohighlightse stejnýmfromato. Když sada barví podle číselné hodnoty, období se volí parametrem a graf chybí, validátor to hlásí jakomissing_trend_chart. - Kolísavé řady (počasí). U hodnot, které rok od roku kolísají (průměrná teplota, srážky), zkresluje srovnání dvou jednotlivých let: teplý první rok oteplení zmenší. Pošlete proto
reference: { from, to, value, recent }– referenční období (např. klimatický normál 1961–1990) s jeho průměrem a nedávné období (např. posledních 10 let) s jeho průměrem. Portál pak změnu každého období počítá proti průměru referenčního období, nakreslí ho do grafu čárkovaně, pod hodnotou ukáže průměr nedávného období proti němu a nejvyšší a nejnižší hodnotu řady.valuemůžete vynechat, portál průměr spočítá z bodů; pošlete ho, když ho máte spočítaný jinak (např. z měsíčních normálů) a stejné číslo je v hodnotách sady. Průměry skryjí špičky: má-li bod i nejnižší a nejvyšší hodnotu naměřenou v období (např. nejnižší a nejvyšší teplotu roku u průměrné roční teploty), pošlete je jakolowahigha portál je ukáže u hodnoty období. - Souhrnný graf u legendy. Vývoj za celé území sady nebo za výřez (např. počet obyvatel Česka) pošlete v
dm.chartodpovědi – stejný tvar jako graf objektu. Portál ho ukáže u časového filtru, dokud uživatel žádný objekt nerozklikne, a zvolené období vyznačí podlehighlight. Barví-li sada podle trendu, dostane čára barvu trendu celku – je pak vidět, jestli zelené tečky jen nekopírují celostátní vývoj. - Barva podle trendu. Je-li smyslem sady změna („roste, nebo ubývá?“), nastavte
color: { "type": "trend" }. Portál z grafu každého objektu spočítá průměrnou změnu za jedno období v % počáteční hodnoty – ve zvýrazněném období (highlight), jinak za celou řadu. Odthreshold(výchozí 0,5 %) výš hodnota roste (zelená), od −thresholdníž klesá (červená), mezi tím stagnuje (šedá). Barvy lze přepsat přescolors: { up, flat, down }, třeba když je růst nežádoucí. Legendu portál odvodí sám a graf v detailu obarví stejně jako objekt v mapě. Objekt bez grafu zůstane světle šedý (trend_without_chart).
Trend vychází z relativní změny, hodí se proto pro kladné veličiny (počty, ceny, koncentrace). Hodnoty kolem nuly, jako saldo stěhování, barvěte přes interpolate a vývoj ukažte jen grafem.
{
"protocol": "0.1",
"provider": { "id": "kraj-priklad", "name": "Kraj Příklad" },
"license": { "name": "CC BY 4.0", "attribution": "© Kraj Příklad" },
"datasets": [{
"id": "vyvoj-obyvatel",
"title": "Vývoj počtu obyvatel obcí",
"description": "Kde obyvatel přibývá a kde ubývá. Barva podle trendu ve zvoleném období, v detailu obce graf po letech.",
"category": "society",
"keywords": ["obyvatelé", "vývoj", "trend", "růst", "vylidňování"],
"useCases": ["housing", "public-administration"],
"temporal": { "frequency": "ročně", "param": "obdobi" },
"source": { "type": "geojson", "url": "https://data.kraj-priklad.cz/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": "Obyvatel na konci období", "type": "integer" }
],
"params": [{ "key": "obdobi", "label": "Období", "type": "range", "min": 2015, "max": 2025, "step": 1, "default": "2015,2025" }]
}]
}
Odpověď pak u každé obce posílá řadu za všechny roky a zvolené období v highlight, například { "from": "2015", "to": "2025" }.
Datový dotaz
GET {source.url}?bbox=minLon,minLat,maxLon,maxLat&zoom=10&limit=5000&lang=cs&protocol=0.1[&cursor=…][&{params}]
Accept: application/geo+json, application/json
User-Agent: DatovaMapa/0.1 (+https://datovamapa.cz/dokumentace/pro-poskytovatele)
bboxazoomjen v režimubbox. Výřez je zarovnaný na dlaždice úrovnězoom(celé číslo), takže blízké pohledy vedou na stejný dotaz – poskytovatel i portál mohou odpovědi cachovat.limit= kolik objektů portál nanejvýš zpracuje.- Časový limit odpovědi 10 s, velikost max. 15 MB.
Datová odpověď
GeoJSON FeatureCollection (RFC 7946). Podporované geometrie: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon. Objekty s geometry: null se přeskočí.
Volitelná rozšíření:
{
"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 detailu, odkaz na detail u zdroje, přepsání barvy, graf vývoje.feature.dm.transit– vozidlo veřejné dopravy u sad s profilemtransit_vehicles, viz doprava.feature.dm.chart– vývoj jedné hodnoty objektu v čase, který portál nakreslí v detailu objektu jako čárový graf s hodnotou za poslední období (např. počet obyvatel obce po letech) a ze kterého počítá barvu podle trendu.labelříká, co graf ukazuje, nepovinnéunit,decimals,note(poznámka pod grafem, např. o změně metodiky) ahighlight: { from, to }– zvýrazněné období, typicky zvolené v časovém filtru; portál ho podbarví, ukáže hodnotu na jeho konci a změnu i trend počítá od jeho začátku. Stejnéfromatooznačí jedno období, např. rok zvolený u kartogramu – graf se na něm zastaví.pointsjsou dvojice{ period, value }seřazené od nejstaršího období –periodje rok, měsíc nebo den jako udm.timeline. 2–100 bodů. Posílejte ho vždy, když má objekt hodnotu za více období (viz vývoj v čase a trend). Pro kolísavé řady nepovinnéreferencea u bodůlowahigh(viz vývoj v čase a trend).feature.dm.breakdown– rozklad hodnot objektu jako přehledný výkaz, např. hospodaření obce. Portál ho ukáže na stránce obce (nebo jiného území) místo prosté mřížky čísel.labelje nadpis, nepovinnéperiod(období, za které výkaz je),unitadecimalspro částky aper: { label, unit, base: { label, value } }pro přepočet, např. na obyvatele.sectionsjsou oddíly (nepovinnýlabel, nepovinnéunitadecimals, když má oddíl jinou jednotku než výkaz, např. mzda v Kč vedle počtu míst) s řádkyrows:label,value, nepovinnéper(hodnota přepočtená podlepervýkazu),note(vysvětlení pro laika),color(barva pruhu řádku bez částí) aparts– části částky (label,value, nepovinnácolor), které portál nakreslí jako dělený pruh. Pruhy řádků jednoho oddílu mají společné měřítko, takže jde porovnat třeba příjmy s výdaji. Řádek skind: "result"je výsledek pod čarou bez pruhu, kladný zeleně a záporný červeně (např. přebytek a schodek). 1–6 oddílů, v oddílu 1–10 řádků, v řádku nejvýš 8 částí.feature.dm.empty: true– objekt jen doplňuje mapu, např. obec bez školy, kterou kartogram kapacity barví nulou. Na stránce obce (nebo jiného území) portál jeho hodnoty nevypíše, protože by karta opakovala samé nuly.dm.ttl– platnost odpovědi (portál použije menší zcache.ttladm.ttl).dm.total,dm.truncated– kolik objektů celkem / zda je odpověď zkrácená.dm.notice– krátké sdělení pro uživatele (zobrazí se u vrstvy).dm.next– kurzor na další stránku (portál ho zatím nevyužívá, rezervováno).dm.timeline– počty objektů ve výřezu po obdobích za celou dobu, kterou sada pokrývá, nezávisle na zvoleném období a nalimit(spočítejte je agregačním dotazem, ne z vrácených objektů). Portál z nich kreslí graf u legendy.periodje rok (2023), měsíc (2023-05) nebo den; nepovinnévaluesrozdělí počet podle hodnot vlastnosti zcolor.fielda graf je obarví jako legendu. Max. 400 období.dm.chart– souhrnný vývoj hodnoty za celé území sady nebo výřez (např. počet obyvatel Česka), stejný tvar jakofeature.dm.chart. Portál ho ukáže u časového filtru jako čárový graf, když odpověď neposíládm.timeline.
{
"type": "FeatureCollection",
"features": [],
"dm": {
"timeline": [
{ "period": "2024", "count": 2366, "values": { "zranění": 701, "hmotná škoda": 1665 } },
{ "period": "2025", "count": 1894, "values": { "zranění": 652, "hmotná škoda": 1242 } }
]
}
}
Souhrnný vývoj za celé území místo počtů objektů (zvolené období 2023–2025):
{
"type": "FeatureCollection",
"features": [],
"dm": {
"chart": {
"label": "Počet obyvatel Česka k 31. 12.",
"highlight": { "from": "2022", "to": "2025" },
"points": [
{ "period": "2021", "value": 10516707 },
{ "period": "2022", "value": 10827529 },
{ "period": "2023", "value": 10900555 },
{ "period": "2024", "value": 10909500 },
{ "period": "2025", "value": 10915839 }
]
}
}
}
Objekt s grafem vývoje v detailu:
{
"type": "FeatureCollection",
"features": [{
"type": "Feature",
"id": "500496",
"geometry": { "type": "Point", "coordinates": [17.2731, 49.5957] },
"properties": { "nazev": "Olomouc", "obyvatel": 105297 },
"dm": {
"chart": {
"label": "Počet obyvatel k 31. 12.",
"points": [
{ "period": "2023", "value": 102293 },
{ "period": "2024", "value": 103063 },
{ "period": "2025", "value": 105297 }
]
}
}
}]
}
- Vlastnosti s prefixem
__dm_jsou rezervované pro portál a z odpovědi se odstraní.
Detail objektu
Sada může nabídnout detail objektu na vyžádání: po kliknutí na objekt portál ukáže popup z vlastností a pod ním doplní detail, který se stáhne zvlášť. Hodí se pro bohatší obsah, který se nevejde do vlastností: jízdní řád vlaku, průběh jízdy, zvýraznění trasy v mapě. Pole detail v sadě obsahuje šablonu adresy se zástupným {id}, za které portál dosadí id objektu z dat (objekty proto musí mít stabilní id). Adresa je https, nebo relativní vůči manifestu; validátor hlásí šablonu bez {id} (detail_url_without_id) a jiné schéma než https (detail_url_not_https).
"detail": { "url": "https://data.example.cz/detail?id={id}" }
Odpověď je JSON FeatureDetail (title a generated jsou povinné, ostatní pole volitelná):
title,subtitle,badge { text, color, textColor }– hlavička,status { label, tone }– stav s tónemok,warning,dangerneboneutral,fields[] { label, value },tags[],notes[]– další údaje, krátké štítky a poznámky,journey.calls[]– zastávky po sobě (nejvýš 300):name,arrival,departure(čas, který platí),scheduledArrival,scheduledDeparture(plán),estimated(čas je odhad),platform,state(passed,current,upcoming); časy jsou ISO 8601 s posunem pásma,highlight– GeoJSONFeatureCollectionke zvýraznění v mapě do zhruba 200 kB: čáry s vlastnostírolepassed(ujetá část, utlumená) neboupcoming, body srolestopnebocurrentanamejako popiskem,color,url,notice,generated,ttl(jak dlouho je detail platný, sekundy).
Dokud je detail otevřený, mapa ho obnovuje s intervalem live.interval sady. Portál odpovědi cachuje podle ttl a jejich schéma ověřuje stejně jako data. Neznámé id vrací poskytovatel jako 404.
{
"title": "RJ 1000",
"subtitle": "→ Praha-Zahradní Město · RegioJet a.s.",
"badge": {
"text": "RJ 1000",
"color": "#0f766e"
},
"status": {
"label": "+8 min",
"tone": "warning"
},
"journey": {
"calls": [
{
"name": "Ostrava hlavní nádraží",
"departure": "2026-11-04T05:05:00+01:00",
"scheduledDeparture": "2026-11-04T05:05:00+01:00",
"platform": "2",
"state": "passed"
},
{
"name": "Pardubice hlavní nádraží",
"arrival": "2026-11-04T07:30:00+01:00",
"departure": "2026-11-04T07:38:00+01:00",
"scheduledArrival": "2026-11-04T07:22:00+01:00",
"scheduledDeparture": "2026-11-04T07:30:00+01:00",
"platform": "3",
"state": "current"
}
]
},
"highlight": {
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "LineString",
"coordinates": [
[
15.77,
50.03
],
[
14.43,
50.08
],
[
14.6,
50.07
]
]
},
"properties": {
"role": "upcoming"
}
},
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
15.77,
50.03
]
},
"properties": {
"role": "current",
"name": "Pardubice hlavní nádraží"
}
}
]
},
"color": "#0f766e",
"generated": "2026-11-04T07:35:00Z",
"ttl": 30
}
Úplný příklad: detail-jizda.json.
Doprava
Sady s živými polohami vozidel veřejné dopravy (vlaky, autobusy, tramvaje, metro…) označte "profile": "transit_vehicles". Portál je pak ukáže ve společné vrstvě „Doprava živě“: všechny stejným stylem (tvar podle druhu, barva podle zpoždění), s jednou legendou, filtrem podle druhu dopravy, zpoždění a dopravce a s hledáním spoje. Uživatel tak vybírá druh dopravy, ne zdroj dat.
Sada s profilem musí mít live, prezentaci circle a objekty jako body s feature.dm.transit. Validátor hlásí chybějící live (transit_missing_live), jinou prezentaci (transit_not_circle), objekt bez dm.transit (transit_missing_properties) a objekt, který není bod (transit_not_point).
Pole dm.transit |
Povinné | Popis |
|---|---|---|
mode |
ano | rail, bus, tram, metro, trolleybus, ferry, funicular, other |
label |
ano | Označení, které lidé hledají: vlak (R 1234), linka (188) |
line |
ne | Linka, když se liší od označení (S2) |
headsign, operator |
ne | Cíl spoje, dopravce |
delay_min |
ne | Zpoždění v celých minutách, záporné = před časem |
delay_band |
ano | on_time do 4 min, minor 5 až 14, medium 15 až 29, major 30 až 59, extreme 60 a víc, unknown bez údaje |
bearing |
ne | Směr jízdy ve stupních od severu |
trip_ref |
ne | Stálý klíč spoje (stejný napříč obnovami); stejný jako id objektu, pokud sada nabízí detail jízdy |
observed_at |
ano | Kdy byla poloha změřena (ISO 8601) |
Každé vozidlo má být na mapě jen jednou. Když stejná vozidla hlásí víc zdrojů, ať je vydává jen jedna sada. Vlastnosti v properties (popisky pro lidi v jazyce země) zůstávají, dm.transit je neutrální část pro portál.
{
"type": "FeatureCollection",
"features": [{
"type": "Feature",
"id": "1234|20261104",
"geometry": { "type": "Point", "coordinates": [14.4352, 50.0833] },
"properties": { "vlak": "R 1234", "cil": "Brno hl.n.", "zpozdeni_min": 6 },
"dm": {
"transit": {
"mode": "rail", "label": "R 1234", "headsign": "Brno hl.n.", "operator": "České dráhy",
"delay_min": 6, "delay_band": "minor", "bearing": 135, "trip_ref": "1234|20261104",
"observed_at": "2026-11-04T07:35:10Z"
}
}
}]
}
Úplný příklad: data-doprava.json.
Cache
- Portál drží odpovědi po dobu
min(cache.ttl, dm.ttl), výchozí 300 s. Manifesty 10 min. - Po vypršení drží záznam ještě 24 h jako zálohu: když zdroj neodpovídá, ukáže poslední data s upozorněním.
cache.store: false– poskytovatel nesouhlasí s trvalým uložením dat do datové vrstvy portálu (krátkodobé cachování odpovědí podlettlplatí dál).live: { interval }– živá data. Zapnutá sada se v otevřené mapě sama znovu stáhne každýchintervalsekund (10 až 3600), bez obnovení stránky; u skryté karty se obnova zastaví. Interval kratší nežcache.ttlvalidátor hlásí (live_interval_below_ttl), protože by se mapa ptala častěji, než se data mění. Portál sadu sliveoznačí jako živou i bez „(živě)“ v názvu.
Validace
Shodu s protokolem ověřuje validátor (POST /api/validate, živý test GET /api/validate?manifestUrl=…, nebo MCP nástroje validate_manifest a validate_data). Rozlišuje:
- chyby (
errors) – porušení tohoto dokumentu; manifest s chybou portál nepřijme, data s chybou nezobrazí, - doporučení (
warnings) – data fungují, ale hůř se hledají, zobrazují nebo kombinují.
Každý nález má stabilní code (přehled kódů), cestu path a u doporučení radu hint. Kódy se mezi minor verzemi nemění, nové mohou přibývat.
Vývoj protokolu
- Nová volitelná pole a nové typy
presentation/source= nová minor verze (0.2…). - Změna významu existujících polí = nová major verze; portál po přechodnou dobu podporuje obě.
- Kandidáti na další verze:
symbol(ikony),extrusion(3D), časová dimenze (timeu objektů + parametr),vector-tiles/pmtiles/ogc-featuresjako zdroje, stránkování přesnext, agregace pro malá přiblížení.