Geodaten

OGC-Geodienste

GeoServer veröffentlicht räumliche Daten als standardisierte Karten-, Feature- und Coverage-Dienste. Die UDSP trennt geschützte Gateway-Routen von bewusst freigegebenen Open-Data-Pfaden.

Komponente

GeoServer

Dienste

WMS, WFS, WCS und konfigurierte OGC APIs

Gateway-Zugang

https://api.<DOMAIN>/geoserver/

Portal-Zugang

https://geoportal.<DOMAIN>/geoserver/

Welcher Geodienst passt zur Nutzung?

Dienst	Ergebnis	Typische Nutzung
WMS	serverseitig erzeugtes Kartenbild	Kartenanzeige ohne Rohdatenübertragung
WFS	Vektorfeatures mit Geometrie und Attributen	Analyse, Download und Weiterverarbeitung
WCS	Raster- beziehungsweise Coverage-Daten	Höhenmodelle, Fernerkundung und Rasteranalyse
OGC API Features	HTTP-/JSON-orientierter Feature-Zugang	moderne Webanwendungen und API-Integrationen

Welche Dienste tatsächlich verfügbar sind, hängt von GeoServer-Version, installierten Erweiterungen und den publizierten Workspaces und Layern ab.

Geschützter Gateway-Zugang

APISIX veröffentlicht GeoServer unter:

https://api.<DOMAIN>/geoserver/

Lesende GET-Aufrufe benötigen api:read. Die für administrative oder schreibende GeoServer-Aufrufe bereitgestellte Route verwendet für POST, PUT und PATCH den Scope api:write.

Beispiel für die WMS-Capabilities:

curl --fail --show-error \
  --get \
  "https://api.<DOMAIN>/geoserver/<WORKSPACE>/wms" \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --data-urlencode "service=WMS" \
  --data-urlencode "request=GetCapabilities"

Geoportal und Open Data

Das GeoStack-Deployment erzeugt zusätzlich Zugänge auf geoportal.<DOMAIN>. Ein konfiguriertes Open-Data-Workspace kann ohne denselben Schutz wie der allgemeine GeoServer-Zugang veröffentlicht werden:

https://geoportal.<DOMAIN>/geoserver/<OPEN_DATA_WORKSPACE>/...

Die Freigabe gilt nicht automatisch für alle Workspaces und Layer. Datenquelle, Workspace, Layer, OGC-Dienst und Berechtigungsregel müssen gemeinsam geprüft werden.

Ergänzende Geo-APIs

Neben GeoServer erzeugt die aktuelle APISIX-Konfiguration zwei weitere optionale Geo-Routen:

Pfad	Ziel	Verwendung
/geodataconfig/	Geoportal Backend	Portal-, Layer- und Werkzeugkonfiguration lesen oder schreiben
/geodata-citydb-wfs/	CityDB-/Mapfish-Dienst	für den GeoStack bereitgestellte Feature- und CityDB-Zugänge

Beide Routen verwenden ebenfalls api:read für GET und api:write für POST, PUT und PATCH. Sie sind keine allgemeinen Ersatzpfade für WMS oder WFS und existieren nur, wenn die zugehörigen GeoStack-Komponenten bereitgestellt wurden.

Browseranwendung und Datendienst trennen

Masterportal ist eine Kartenanwendung. Es konsumiert GeoServer- und Konfigurationszugänge, ist aber selbst kein OGC-Standard. Die technische Schnittstelle für andere Kartenclients bleibt der konfigurierte GeoServer-Dienst.

Technische Abhängigkeiten

• GeoServer publiziert Layer und OGC-Dienste.
• PostgreSQL/PostGIS kann räumliche Quelldaten halten.
• APISIX schützt die Gateway-Routen.
• Masterportal nutzt die Dienste als Kartenfrontend.
• Das auf der Masterportal-Seite eingeordnete Geoportal Backend stellt die mandantenbezogene Portal-Konfiguration bereit.

Offizielle Referenzen

WMS, WFS und WCS sind eigenständige OGC-Webservice-Standards und besitzen deshalb keine gemeinsame Swagger-Referenz. OGC API Features folgt dagegen dem neueren, OpenAPI-basierten Schnittstellenmodell. Die folgenden Referenzen werden direkt vom Open Geospatial Consortium gepflegt.

OGC-Standard

WMS

Offizielle Spezifikationen und Ressourcen zum Web Map Service.

WMS-Referenz öffnen ↗

OGC-Standard

WFS

Offizielle Spezifikationen und Ressourcen zum Web Feature Service.

WFS-Referenz öffnen ↗

OGC-Standard

WCS

Offizielle Spezifikationen und Ressourcen zum Web Coverage Service.

WCS-Referenz öffnen ↗

OGC API

OGC API Features

Standard, OpenAPI-Beispiele und Erläuterungen für featurebasierte Web-APIs.

API-Referenz öffnen ↗