# Datenkarte

> Offene Schnittstelle zur Visualisierung von Daten auf der Karte. Wer Daten mit Ortsbezug hat, veröffentlicht ein Manifest und GeoJSON-Daten nach dem Protokoll 0.1; das Portal Datenkarte lädt sie, prüft sie, speichert sie im Cache und zeigt sie gemeinsam mit den Daten anderer Quellen auf der Karte an – mit Quellenangabe.

Das Portal wird von vrealmatic.com betrieben (https://vrealmatic.com/web).

Agenten, die Fragen zu einem Ort beantworten („Liegt die Adresse im Überschwemmungsgebiet?“, „Wie ist die Luft in Linz?“), nutzen den MCP-Server https://datenkarte.at/mcp (Tools `find_place`, `nearby`, `summary`, `catalog`) oder die HTTP-API: `GET https://datenkarte.at/api/places?query=…`, `GET https://datenkarte.at/api/nearby?point=lon,lat&datasets=…`, `GET https://datenkarte.at/api/summary/{provider}/{dataset}?municipality=…`. Anleitung: https://datenkarte.at/dokumentation/ki-assistenten.md

Die Daten bei den Anbietern bereiten typischerweise KI-Agenten vor. Das Vorgehen beschreibt die Anleitung für KI-Agenten; das fertige Ergebnis prüft der Validator (`POST https://datenkarte.at/api/validate`, Live-Test `GET https://datenkarte.at/api/validate?manifestUrl=…`). Dasselbe bietet der MCP-Server https://datenkarte.at/mcp (Streamable HTTP, ohne Authentifizierung). Die Dokumentation ist auf Deutsch; jede Seite hat eine Markdown-Version mit der Endung `.md`.

## Dokumentation

- [Anleitung für KI-Agenten](https://datenkarte.at/dokumentation/fuer-ki-agenten.md): Vorgehen Schritt für Schritt, Regeln, Codevorlagen und Kriterien für eine fertige Arbeit für den Agenten, der die Daten eines Anbieters vorbereitet.
- [Daten für KI-Assistenten](https://datenkarte.at/dokumentation/ki-assistenten.md): Wie Sie die Datenkarte mit einem KI-Assistenten verbinden (MCP, HTTP-API) und nach Orten und Daten fragen.
- [Für Datenanbieter](https://datenkarte.at/dokumentation/fuer-datenanbieter.md): Wie Sie Daten anbinden: statische Dateien, eigener Endpunkt oder WMS; Manifest, Daten, Visualisierungen, Prüfung, Bedingungen.
- [Protokoll 0.1](https://datenkarte.at/dokumentation/protokoll.md): Normative Spezifikation von Manifest, Datenabfrage, Antwort und Cache.
- [Portal-API und MCP-Server](https://datenkarte.at/dokumentation/api.md): Katalog, Daten, Validator, MCP-Werkzeuge, Links auf die Karte und Fundcodes.
- [Über das Projekt](https://datenkarte.at/dokumentation/ueber-das-projekt.md): Vision der Datenkarte, Prinzipien und Entwicklungsplan.

## Schemas und Verträge

- [JSON Schema des Manifests](https://datenkarte.at/schema/0.1/manifest.json): was ein Anbieter über sich und seine Datensätze veröffentlicht
- [JSON Schema der Daten](https://datenkarte.at/schema/0.1/data.json): GeoJSON-Antwort des Daten-Endpoints
- [OpenAPI des Anbieters](https://datenkarte.at/schema/0.1/provider-openapi.json): Vertrag der Endpoints, die der Anbieter implementiert (daraus lässt sich ein Server generieren)
- [OpenAPI des Portals](https://datenkarte.at/openapi.json): Katalog, Daten, Ort und Umgebung, Übersichten, Validator

## Beispiele

- [manifest-minimal.json](https://datenkarte.at/beispiele/manifest-minimal.json): Das kleinste sinnvolle Manifest: eine statische GeoJSON-Datei, Modus full.
- [manifest-complete.json](https://datenkarte.at/beispiele/manifest-complete.json): Manifest mit allen wichtigen Möglichkeiten: bbox, Filter, Farben nach Werten, Gruppierung, Choroplethenkarte, WMS.
- [data-points.json](https://datenkarte.at/beispiele/data-points.json): Antwort mit Punkten einschließlich der dm-Erweiterung.
- [data-polygons.json](https://datenkarte.at/beispiele/data-polygons.json): Antwort mit einer Fläche (Polygon) und einem numerischen Wert für die Choroplethenkarte.
- [Beispielanbieter](https://datenkarte.at/api/sample/manifest): Referenzimplementierung des Protokolls über HTTP (fiktive Daten, nicht im Katalog)

## Daten im Portal

- [Katalog in Markdown](https://datenkarte.at/quellen.md): 33 Datensätze von 16 Anbietern, mit Eigenschaften und Parametern
- [Katalog in JSON](https://datenkarte.at/api/catalog)

## Optional

- [Gesamte Dokumentation in einer Datei](https://datenkarte.at/llms-full.txt)