LandNutzen.Anmelden
Dokumentation: Seiten auswählen

Österreich-Coverage-/Rechtematrix v1

Stand: 7. Oktober 2026

Zweck

GET /api/v1/data-sources/coverage-matrix weist für alle neun österreichischen Bundesländer den Status jeder bekannten public_display-Quellen-/Fähigkeitskombination der öffentlichen Werkzeuge aus. Die Matrix trennt ausdrücklich:

  • Registry- und Rechtestatus,
  • zweckgebundenen Active Release,
  • Distribution und Consumer-Fähigkeit,
  • Coverage und regionale Evidenz,
  • Freshness und Quality Summary,
  • technische Consumer-Bindung,
  • daraus abgeleitete Verfügbarkeit.

„9/9 dokumentiert“ bedeutet nur, dass kein Bundesland verschwiegen wird. unknown, gated und notConfigured zählen niemals als verfügbar.

Scope von v1

  • Land: AT
  • Regionen: ISO 3166-2 AT-1 bis AT-9
  • Nutzungszweck: ausschließlich public_display
  • Werkzeuge: pv-yield, site-check und market-signal (Preis-Lanes seit Matrixversion 2026-09-17.market-signal-price-lanes-v1; nationale Indexquellen statat, eurostat, oenb, Fähigkeit index_lookup)
  • Seit Matrixversion 2026-09-25.site-check-earthquake-heat-lanes-v1 (ADR-0071) sind erdbeben-oenorm (Coverage-Key orte:at:oenorm-b-1998-1) und geosphere-hora-hitzelayer (country:AT) national qualifizierte site-check-Lanes mit report_lookup; beide öffnen nur über den exakten Coverage-Key ihres aktiven Releases.
  • Seit Matrixversion 2026-09-25.site-check-radon-lane-v1 ist radon-onrap (Distribution ages-radonpotenzialklassen-ogcapi, Coverage-Key gemeinden:at:radonpotenzial-rnv-2020) eine national qualifizierte site-check-Lane mit point_lookup. Die Report-Fähigkeit radon-onrap/report_lookup liest weiterhin live (Legacy-Shadow) und ist wie Altlasten aus dieser Werkzeugmatrix ausgenommen.
  • Seit Matrixversion 2026-09-27.site-check-public-transport-lane-v1 ist oev-gueteklassen mit Distribution oev-gk-nap-polygone-werktag und Fähigkeit point_lookup eine nationale site-check-Lane (country:AT, Migration 0057). Der Legacy-Pilot oev-gueteklassen/report_lookup des Mehrwert-Berichts ist aus der Werkzeugmatrix ausgeschlossen.
  • Seit Matrixversion 2026-09-27.site-check-zoning-noe-lane-v1 ist widmung-noe (Distribution widmung-noe-wfs-snapshot, Coverage-Key noe-widmungsumhuellende-v1) ein regionaler Scope für AT-3 mit release-gebundenem point_lookup. Seit der Aktivierung am 27. September 2026 zeigt AT-3 availableWithGaps, die acht übrigen Bundesländer zeigen outsideCoverage. Die Lane widmung-noe/zoning_geojson trägt denselben regionalen Scope, bleibt als nicht release-gebundener Legacy-Verbraucher aber gated. widmung-noe-wms bleibt notConfigured (#413).
  • Seit Matrixversion 2026-09-27.site-check-flood-at-lane-v1 (ADR-0072) gibt es zusätzlich die nationale site-check-Lane hochwasser-at mit point_lookup (Coverage-Key at-hochwasser-hwrl-gzp-v1, Release-Coverage partial). Bis zur Aktivierung am 27. September 2026 waren ihre neun Zellen gated; seitdem sind sie availableWithGaps.
  • Seit Matrixversion 2026-09-28.site-check-zoning-wien-lane-v1 (ADR-0076) ist widmung-wien (Distribution widmung-wien-wfs-snapshot, Coverage-Key wien-generalisierte-flaechenwidmung-v1) ein regionaler Scope für AT-9 mit release-gebundenem point_lookup. Bis zu Migration 0063, eingespieltem Rechte-Review und aktivem Release waren alle neun Zellen gated. Seit der Aktivierung am 30. September 2026 zeigt AT-9 availableWithGaps, die acht übrigen zeigen outsideCoverage; die Matrix hat 40 Lanes und 360 Zellen (Nachweis).
  • Seit Matrixversion 2026-09-30.site-check-heritage-lane-v1 (ADR-0073) führt die Matrix für bda-denkmalschutz nur noch die nationale site-check-Lane mit point_lookup (Distribution bda-denkmalliste-csv-bev-dkm-snapshot, Coverage-Key at-denkmalliste-parzellen-v1, Release-Coverage partial). Die frühere report_lookup-Lane des NÖ-Report-Piloten ist kein Site-Check-Verbraucher mehr in der Matrix. Bis zu Rechte-Review und aktivem Release waren die neun Zellen gated; seit der Aktivierung am 30. September 2026 sind sie availableWithGaps. Die Lane-Zahl bleibt dadurch unverändert (40 Lanes, 360 Zellen) (Nachweis).
  • Seit Matrixversion 2026-09-30.site-check-broadband-lane-v1 (ADR-0074) ist rtr-breitband (Distribution breitbandatlas-ogd-raster100m, Coverage-Key raster100m:at:breitbandatlas) eine national qualifizierte site-check-Lane mit point_lookup. Die Report-Lane rtr-breitband/report_lookup liest weiterhin live per WMTS (Legacy-Shadow) und ist aus der Werkzeugmatrix ausgeschlossen. Bis zu Migration 0061, eingespieltem Rechte-Review und aktivem Release waren die neun Zellen gated; seit der Aktivierung am 30. September 2026 sind sie available. Die Lane-Zahl blieb dadurch unverändert (40 Lanes, 360 Zellen) (Nachweis).
  • Seit Matrixversion 2026-09-30.site-check-wlv-gzp-lane-v1 (ADR-0075) gibt es die nationale site-check-Lane wlv-gzp mit point_lookup (Distribution lfrz-000901-wlv-gzp-gpkg-snapshot, Coverage-Key at-wlv-gzp-v1, Release-Coverage partial: Gefahrenzonen nur im raumrelevanten Bereich der Gemeindepläne). Bis zu Migration 0062, eingespieltem Rechte-Review und aktivem Release waren ihre neun Zellen gesperrt; seit der Aktivierung am 30. September 2026 sind sie availableWithGaps. Die drei Report-Lanes wlv-lfrz (Live-WMS) bleiben davon getrennt und notConfigured. Die Matrix umfasst damit 41 Lanes und 369 Zellen (produktiv rückgelesen am 30. September 2026: 126 available, 41 availableWithGaps, 18 gated, 40 outsideCoverage, 144 notConfigured; Nachweis).
  • Seit Matrixversion 2026-10-04.site-check-zoning-vorarlberg-lane-v1 (ADR-0077) ist widmung-vorarlberg (Distribution widmung-vorarlberg-wfs-snapshot, Coverage-Key vorarlberg-flaechenwidmungsplan-v1) ein regionaler Scope für AT-8 mit release-gebundenem point_lookup. Bis zu Migration 0064, eingespieltem Rechte-Review und aktivem Release waren alle neun Zellen gated. Seit der Aktivierung am 4. Oktober 2026 zeigt AT-8 availableWithGaps, die acht übrigen zeigen outsideCoverage; die Matrix hat 42 Lanes und 378 Zellen (Nachweis).
  • Seit Matrixversion 2026-10-07.site-check-zoning-oberoesterreich-lane-v1 (ADR-0081) ist widmung-oberoesterreich (Distribution widmung-oberoesterreich-wfs-snapshot, Coverage-Key oberoesterreich-flaechenwidmungsplan-v1) ein regionaler Scope für AT-4 mit release-gebundenem point_lookup. Bis zu Migration 0068, eingespieltem Rechte-Review und aktivem Release waren alle neun Zellen gated. Seit der Aktivierung am 8. Oktober 2026 zeigt AT-4 availableWithGaps, die acht übrigen zeigen outsideCoverage; die Matrix hat 43 Lanes und 387 Zellen (Nachweis).
  • Stand 08.10.2026 (Live-Abruf, Matrixversion 2026-10-07.site-check-zoning-oberoesterreich-lane-v1): 43 Lanes, 387 Zellen, 9 von 9 Bundesländern dokumentiert. Verfügbarkeit: available 126, availableWithGaps 43 (zusammen 169 nutzbare Zellen), gated 18, outsideCoverage 56, notConfigured 144. Frühere Stände: 27.09.2026 351 Zellen (139 nutzbar), 30.09.2026 369 Zellen (167 nutzbar), 04.10.2026 378 Zellen (168 nutzbar). Die Zahlen ändern sich mit jeder neuen Lane; die Antwort des Endpunkts (summary) ist maßgeblich.
  • Export, Derivate, Rohdatenweitergabe und ml_ai sind nicht umfasst.

Die Lanes stammen aus dem technischen Consumer-Binding-Inventar. Zusätzlich wird google-solar/building_solar_lookup ausdrücklich als legacy_shadow-Lane mit ungeklärtem Scope ergänzt, damit diese bestehende öffentliche Verbrauchergrenze in der Matrix nicht verschwiegen wird. Eine statische Scope-Zuordnung beschreibt nur den erwarteten Vertrag. Sie öffnet keine Zelle. Noch nicht regional qualifizierte Legacy-Quellen bleiben für alle neun Bundesländer notConfigured.

Stabiler Schlüssel

Jede Zelle verwendet mindestens:

regionCode|sourceSlug|distributionKey|usagePurpose|capability

Der Lane-Schlüssel enthält dieselbe Identität ohne regionCode. WMS- und Snapshot-Kanäle sind getrennte Lanes und erben weder Rechte noch Coverage voneinander.

Ableitung

Die Matrix liest die redigierte öffentliche Source-Provenienz. Ein dort vorhandener Active Release belegt für den gespeicherten public_display-Kontext einen qualifizierten Release und ein damals gültiges Registry-Rechtegate. Für die konkrete Lane werden zusätzlich exakt geprüft:

  1. Registry registered und Rechte conditional oder approved;
  2. erwarteter Active-Pointer-Kanal;
  3. erwartete Distribution;
  4. erwartete Capability;
  5. Freshness fresh oder notApplicable;
  6. bestandene Quality Summary;
  7. erforderlicher Coverage-Key und Status covered oder partial;
  8. technische Bindung release_bound.

Der Coverage-Status wird nicht aus dem aggregierten Provenienzfeld abgeleitet. Die Matrix liest den konkret erforderlichen Key aus source_release_coverage und verlangt dabei weiterhin einen qualifizierten, aktiven public_display-Release. Fehlt diese key-genaue Evidenz oder wurde der Active Pointer zwischenzeitlich verschoben, bleibt die Zelle geschlossen.

PVGIS benötigt zusätzlich die hash- und release-gebundene öffentliche 45-Punkte-Evidence. Pro Bundesland müssen exakt fünf valide Referenzpunkte vorliegen. Ein kaputtes oder nicht mehr an den Active Release gebundenes Evidence-Artefakt sperrt alle betroffenen Zellen, ohne den restlichen Matrixvertrag zu erfinden.

Nationale partial-Coverage wird als availableWithGaps ausgewiesen. Das gilt seit der Aktivierung am 27. September 2026 auch für die Lane hochwasser-at / lfrz-000801-hochwasser-gml-snapshot / point_lookup (Coverage-Key at-hochwasser-hwrl-gzp-v1): Sie deckt alle neun Bundesländer ab, aber nur die amtlichen Hochwasser-Risikogebiete und gemeldeten BWV-Gefahrenzonen; vorher waren ihre neun Zellen gated (ADR-0072). Regionale Pilot-Coverage wird nur im benannten Bundesland als availableWithGaps dargestellt; die übrigen acht Zellen sind outsideCoverage. Ein Format- oder Identitätskorpus ist kein Coverage-Nachweis.

Availability-Werte

WertBedeutung
availablealle Gates bestanden, belegte Coverage ohne bekannten Coverage-Teilstand
availableWithGapsalle harten Gates bestanden, aber belegter Partial-/Pilotstand
gatedmindestens ein Rechte-, Release-, Freshness-, Quality- oder Binding-Gate fehlt
outsideCoverageaußerhalb des versioniert belegten regionalen Pilots
notConfiguredQuelle/Capability sichtbar, aber regionaler Scope noch nicht qualifiziert

Reason-Codes nennen alle erkannten Grenzen. knownGaps bleiben davon getrennt: Ein fachlicher Modellhinweis wie „PVGIS ist keine Dachprüfung“ ist sichtbar, sperrt aber keinen ansonsten qualifizierten Standortmodell-Release.

Caching und Fehler

Der erfolgreiche Contract verwendet einen SHA-256-ETag über das vollständige DTO und unterstützt If-None-Match mit HTTP 304. Es gibt keinen requestabhängigen Zeitstempel im Hash; evidenceUpdatedAt wird deterministisch aus Activation-, Coverage-, Quality- und PVGIS-Evidence-Zeitpunkten gebildet.

Kann das Registry-/Release-Ledger nicht gelesen werden, antwortet die API mit HTTP 503 und Cache-Control: no-store. Die Dokumentationsseite zeigt dann keine Ersatzverfügbarkeit, sondern einen expliziten fail-closed Hinweis.

Österreich-Adapter und Canary-Harness

Das Österreich-Adapter-Harness liest diese Matrix als verbindliches Eingangsgate. Ein Quellenadapter darf einen Canary nur für eine Zelle mit available oder availableWithGaps und exakt passender Quellen-, Distributions-, Zweck-, Fähigkeits-, Kanal-, Release-, Pointer- und Coverage-Identität ausführen. gated, outsideCoverage und notConfigured bleiben unverändert geschlossen; ein Source Review oder vorhandener Consumer-Code ersetzt keine aktuell qualifizierte Matrixzelle.

Für PVGIS und SPARTACUS v3 werden ausschließlich die bereits dokumentierten 45 öffentlichen Referenzpunkte verwendet, fünf je Bundesland. Regionale Piloten dürfen erst mit fünf ausdrücklich für ihren exakten Scope versionierten öffentlichen Punkten angebunden werden. Die Canarys lesen nur; sie verändern weder Registry-Freigaben, Quellenstände, Active Pointer noch Coverage.

Erweiterung

Ein weiterer Nutzungszweck oder eine neue Quelle wird erst aufgenommen, wenn Distribution, Capability, Kanal, erwarteter Scope und das zweckspezifische Release-Gate versioniert sind. Insbesondere werden BEV-Exportrechte nicht aus public_display abgeleitet. parcel_dxf ist in seinem separaten Exportvertrag release-gebunden und seit dem vollständigen Produktions-, Parser- und Rollback-Readback #412 mit DXF_EXPORT_ENABLED=true kontrolliert aktiv. Der Consumer bleibt absichtlich außerhalb dieser Public-Display-/Standort-Check- Matrix; false ist sein nachgewiesener Rollbackzustand. Widmungs-WMS und Widmungs-Kartenausgabe bleiben bis zur distributionsweisen Qualifikation in #413 offen; die Widmungs-Punktabfrage ist seit 27. September 2026 über die eigene Snapshot-Distribution widmung-noe-wfs-snapshot qualifiziert. Die SPARTACUS-v3-Migration aus #404 ist produktiv abgeschlossen.