API des Portals Datenkarte

Die maschinelle Schnittstelle des Portals für Anwendungen und KI-Agenten: Datenkatalog, Daten aus allen Quellen in einheitlicher Form, Abfragen zu einem Ort (was sich an einem Punkt und in seiner Umgebung befindet, Zusammenfassung für eine Gemeinde), Validator und Registrierung für Datenanbieter sowie ein MCP-Server. Alles ist öffentlich, ohne Authentifizierung, mit CORS *. Die formale Beschreibung steht in der OpenAPI.

Überblick

Katalog

GET /api/catalog

{
  "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": "Risiken und Einschränkungen",
      "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" }
    }
  ]
}

Der Katalog enthält nur freigegebene Daten. Datensätze von Anbietern, die sich selbst registriert haben und noch nicht freigegeben sind, sind darin nicht enthalten (siehe Registrierung).

Die Datensätze tragen alle Felder aus dem Manifest des Anbieters (description, fields, params, coverage…) außer der Quell-URL – GeoJSON-Daten werden über das Portal gelesen (links.data), Rasterkacheln direkt von der Quelle (source.tiles). Derselbe Inhalt, lesbar für Menschen wie Modelle: quellen.md.

Daten

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

Die Antwort ist eine GeoJSON FeatureCollection. Angaben aus feature.dm des Anbieters werden in properties mit dem Präfix __dm_ verschoben (__dm_title, __dm_description, __dm_url, __dm_color, __dm_chart). Bei Datensätzen mit color.type = "trend" ergänzt das Portal __dm_trend (roste, stagnuje, klesá), berechnet aus dm.chart. Metadaten der Antwort:

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

Header X-DM-Cache: hit (aus dem Cache), miss (frisch von der Quelle), stale (Quelle nicht erreichbar, letzte bekannte Daten – siehe dm.notice).

Fehler haben die Form { "error": "Meldung", "code": "kod" }: 400 ungültige Anfrage, 404 unbekannter Datensatz, 502 Fehler der Quelle.

Datensätze nur zur Anzeige. Bei einigen vom Portal verwalteten Datensätzen ist für die Quelle keine Lizenz zur Weiterverbreitung belegt. Das Portal zeichnet sie in seiner eigenen Karte, gibt die Daten aber nicht weiter: Im Katalog ist links.data leer und links.source enthält die Adresse des ursprünglichen Dienstes des Anbieters. Eine Anfrage außerhalb der Karte des Portals erhält 303 mit dem Header Location auf diesen Dienst und dem Body { "error": "…", "code": "display_only", "source": "…" }. Ebenso antwortet das MCP-Werkzeug fetch_data.

Ort und Umgebung

Abfragen für KI-Assistenten und Anwendungen, die Fragen zu einem konkreten Ort beantworten. Sie liefern für Menschen beschriebene Werte (Beschriftungen und Einheiten nach den fields des Datensatzes) ohne Geometrien, mit Quellenangabe und Link zur Karte. Anleitung für Nutzerinnen und Nutzer von Assistenten: Daten für KI-Assistenten.

Ortssuche

GET /api/places?query=Hauptplatz 1, Graz (optional max, standardmäßig 5, höchstens 10)

Sucht im Adressregister nach Adressen, Straßen, Gemeinden, Ortschaften und weiteren Gebietseinheiten. Geben Sie nur die Adresse oder den Namen ein; Präzisierungen wie den Bezirk oder „bei Bad Ischl“ versteht der Dienst nicht. municipality ist die Gemeinde, in der der Ort liegt (name, district, region und die Gemeindekennziffer code) – für sie liefert die Zusammenfassung Daten für die ganze Gemeinde. Bei Orten außerhalb von Städten mit über 10 000 Einwohnern gibt es zusätzlich near mit der nächstgelegenen solchen Stadt und der Entfernung in km; anhand beider Angaben lassen sich gleichnamige Orte unterscheiden.

Für Österreich ist noch kein Adressregister angeschlossen. Bis dahin antwortet die Ortssuche mit geocoding_unavailable (HTTP 501); Abfragen zur Umgebung funktionieren mit Koordinaten (point). Das Beispiel zeigt die Form der Antwort:

{
  "query": "Hauptplatz 1, Graz",
  "count": 1,
  "places": [{ "name": "Hauptplatz 1, 8010 Graz", "type": "Adresse", "point": [15.4382, 47.0709], "municipality": { "slug": "graz", "code": "60101", "name": "Graz", "district": "Graz", "region": "Steiermark" } }],
  "attribution": "© Quelle des Adressregisters"
}

Was sich an einem Punkt und in der Umgebung befindet

GET /api/nearby

Eines von datasets, purpose, search ist Pflicht. Die automatische Auswahl nimmt nur Datensätze, die zum Punkt Auskunft geben können: zuerst Risiken und Einschränkungen, Grundkarten zuletzt. Datensätze über dem Limit landen in skipped.

• GeoJSON-Datensätze: Objekte bis zur Entfernung radius, vom nächstgelegenen an sortiert. distance ist in Metern, 0 = der Punkt liegt innerhalb einer Fläche (z. B. einer Gemeinde im Kartogramm). count ist die Anzahl der Objekte in der Umgebung. Datensätze, die nur bei starker Vergrößerung geladen werden, verkleinern die Umgebung (radius, notice). Bei vollständigen Datensätzen (mode: full), die in der Umgebung nichts haben, wird zumindest das nächstgelegene Objekt zurückgegeben (z. B. eine Messstation).
• Raster-Datensätze: Das Portal fragt die Quelle direkt nach dem Punkt. Die Abfrage leitet es aus der Kachelvorlage ab: WMS GetMap → GetFeatureInfo, ArcGIS MapServer/export → identify, ImageServer/exportImage → identify mit der Klassentabelle des Rasters. Die Werte sind Attribute der Quelle (Feldnamen so, wie die Quelle sie liefert). Bei der Deutung von Codes helfen description und legend.

{
  "place": { "name": "Hauptplatz 1, 8010 Graz", "type": "Adresse", "point": [15.4382, 47.0709] },
  "point": [15.4382, 47.0709],
  "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://datenkarte.at/?d=cgs/radon&d=npu/kulturni-pamatky#15/47.0709/15.4382"
}

Zusammenfassung

GET /api/summary/{provider}/{dataset}?municipality=Graz (die übrigen Query-Parameter sind Parameter des Datensatzes)

Zusammenfassung eines GeoJSON-Datensatzes für das gesamte Gebiet oder, mit municipality, nur für eine Gemeinde – jede beliebige Gemeinde Österreichs: count, categories (Anzahlen nach Farbkategorie), rankings (höchste und niedrigste Werte) und beim Kartogramm own – die Werte der Fläche, in der die Gemeinde liegt. Es sind dieselben Zahlen, die die Seite des Datensatzes zeigt. Datensätze, die nur bei starker Vergrößerung geladen werden, haben eine Zusammenfassung nur für eine Gemeinde. Raster-Datensätze haben keine Zusammenfassung.

municipality ist der Name („Graz“), der Name mit Bezirk oder Bundesland („Krumbach (Bezirk Bregenz)“), die Gemeindekennziffer („60101“, die Ortssuche liefert sie in municipality.code) oder die Adresse ihrer Übersichtsseite („vorarlberg/krumbach“). Ein bloßer Name, den mehrere Gemeinden tragen, endet mit dem Fehler ambiguous_place und einer Liste dieser Gemeinden mit Bezirk und Code.

Validator

Ein Werkzeug für Datenanbieter und ihre KI-Agenten. Liefert immer HTTP 200 und einen Bericht:

{
  "valid": false,
  "summary": "Das Manifest ist nicht gültig: 1 Fehler, 2 Empfehlungen.",
  "errors": [{ "path": "datasets[0].source.tiles[0]", "code": "raster_without_template", "message": "Die Kachelvorlage enthält weder {z}/{x}/{y} noch {bbox-epsg-3857}." }],
  "warnings": [{ "path": "datasets[0].keywords", "code": "missing_keywords", "message": "Der Datensatz hat keine Schlüsselwörter.", "hint": "Ergänzen Sie 5–15 Wörter…" }]
}

• POST /api/validate mit dem Body:
  • Manifest (Objekt mit datasets) oder { "manifest": … } – statische Prüfung,
  • GeoJSON FeatureCollection oder { "data": …, "dataset": … } – Prüfung der Daten; mit dataset (Datensatz-Objekt aus dem Manifest) auch die Übereinstimmung mit dem Manifest,
  • { "manifestUrl": "https://…" } – Live-Test.
• GET /api/validate?manifestUrl=https://… – Live-Test: lädt das Manifest, prüft es und sendet für jeden Datensatz eine Testanfrage wie das Portal (bei bbox auf die Mitte von coverage.bbox, Zoom 12 oder coverage.minZoom; bei Rastern eine Kachel). Der Bericht enthält zusätzlich provider und datasets[] mit request, durationMs, featureCount, errors, warnings.

Registrierung

POST /api/registration mit dem Body { "manifestUrl": "https://…" }. Das Portal prüft das Manifest mit einem Live-Test (wie der Validator). Besteht es, wird der Anbieter unter den ungeprüften Daten registriert:

• Die Daten sind über /api/data/… und auf den Seiten der Datensätze /karte/{provider}/{dataset} verfügbar. Die Seite zeigt zuerst eine Warnung, dass die Daten von Dritten hochgeladen und vom Betreiber nicht freigegeben wurden. Die Daten werden erst nach Bestätigung in die Karte geladen. Die Seite hat noindex.
• In den Katalog, die Suche, llms.txt, das MCP-Werkzeug catalog und auf die Gemeindeseiten gelangen die Daten erst nach Freigabe durch den Betreiber.
• Die Freigabe gilt für den Fingerabdruck (SHA-256) des Manifestinhalts. Nach einer Änderung des Manifests ist der Anbieter wieder ungeprüft, bis ihn der Betreiber erneut freigibt.
• Übersicht der ungeprüften Anbieter: /ungepruefte-daten.

{
  "registered": true,
  "status": "pending_review",
  "message": "Registriert. …",
  "provider": { "id": "gemeinde-beispiel", "name": "Gemeinde Beispiel" },
  "links": { "review": "/ungepruefte-daten#gemeinde-beispiel", "datasets": ["/karte/gemeinde-beispiel/parkbaenke"] },
  "check": { "summary": "Der Anbieter ist ohne Einschränkungen gültig.", "warnings": [] }
}

MCP-Server

Endpoint https://datenkarte.at/mcp, Transport Streamable HTTP (zustandslos, Antworten in JSON), ohne Authentifizierung.

Verbindung:

claude mcp add --transport http datenkarte https://datenkarte.at/mcp

{ "mcpServers": { "datenkarte": { "type": "http", "url": "https://datenkarte.at/mcp" } } }

Link zur Karte

https://datenkarte.at/?d={provider}/{dataset}&d=…&{provider}/{dataset}.{param}={wert}#{zoom}/{lat}/{lon}

Jeder Datensatz hat außerdem eine eigene Seite mit Karte und Beschreibung: https://datenkarte.at/karte/{provider}/{dataset}, bundesweite GeoJSON-Datensätze auch für Gemeinden mit über 10 000 Einwohnern: https://datenkarte.at/karte/{provider}/{dataset}/{gemeinde} (z. B. /karte/{provider}/{dataset}/graz). Der Link zur Seite des Datensatzes steht im Katalog in links.map. Auf der Seite eines Datensatzes (auch einer zusammengestellten Karte /karten/{slug}) wird in ?d=… nur die Abweichung von der Standardauswahl geschrieben: Ohne d gelten die Datensätze der Seite, d zählt die gesamte Auswahl auf (?d= = nichts ist eingeschaltet), und ein Parameter wird nur angegeben, wenn er vom Standardwert abweicht.

Beispiel – Verkehrsunfälle in Brünn zusammengefasst für die Jahre 2019–2023: /?d=brno/dopravni-nehody&brno/dopravni-nehody.obdobi=2019,2023#13/49.195/16.608

Befundcodes

Stabile Codes für Fehler (errors) und Empfehlungen (warnings) von Validator und Proxy.

Manifest

Daten

Live-Test und Proxy