STAC-API

Das Spatial Temporal Asset Catalog (STAC) – API ist ein datensatzbasierter Downloaddienst, der den Zugriff auf verpackte Geodaten und zugehörige Metadaten ermöglicht. Mittels dem STAC-API kann auf alle offenen Behördendaten zugegriffen werden. Berechtigte User können zudem auch auf zugriffsgeregelte Produkte wie die Daten der amtlichen Vermessung oder Leitungskataster- und Werkinformationsdaten zugreifen.

Das STAC-Datenmodell basiert auf einfachen Hauptkonzepten und bietet mehrere Abfrageendpunkte für die Abfrage von Geodatenprodukten.

Die drei Hauptkonzepte von STAC einblenden

Abfrageendpunkte einblenden

STAC-Browser - Daten einfach und manuell beziehen

Der STAC-Browser unter daten.geo.lu.ch/browser bietet einen visuellen Zugang zu allen über das STAC-API angebotenen Datenprodukte über eine leicht verständliche Benutzeroberfläche.

Neben dem Katalog stehen verschiedene Suchmöglichkeiten zu Verfügung um gesuchte Datenprodukte schnell aufzufinden.

Eine Anleitung, um Daten im STAC-Browser in drei Schritten zu beziehen, findet sich unten.

STAC-Browser öffnen

Produkt-Ansicht im STAC-Browser

Step-By-Step-Anleitung STAC-Browser einblenden

Alphabetische Liste aller Produkte (unter "Erkunden")

Schritt 1: Start-Ansicht (Katalog)

STAC-Browser öffnen und folgende Möglichkeiten nutzen, um nach Geodatenprodukten zu suchen:

Über Suchfeld nach Titel, Beschreibung oder Schlüsselwörtern filtern
Über Auswahlliste "Schlüsselwörter wählen" eines oder mehrere Schlüsselwörter auswählen um Liste zu filtern
Unter "Erkunden" (oben links) eine alphabetische Liste aller Produkte anzeigen lassen

Produkt-Ansicht im STAC-Browser

Schritt 2: Produkt-Ansicht (Collection)

In der Produkt- / Collection-Ansicht finden sich folgende Informationen:

Beschreibung der Produktes
Karte mit räumlicher Ausdehnung
Verfügbare Elemente (Items): Vektordaten verfügen über einen Eintrag, Rasterprodukte oder kachelweise abgegebene Produkte (z.B. DOM-Punktwolken) zeigen eine Liste mit allen verfügbaren Kacheln

Ansicht verfügbarer Dateien (Assets) zu einem Produkt

Schritt 3: Download Daten (Assets)

In der Item-Ansicht werden alle verfügbaren Datenformate für ein gewähltes Item angezeigt.

Abhängig vom Datentyp werden untenstehende Formate angeboten
Der Download kann über den Button "Herunterladen" gestartet werden. Alternativ kann auch die Webadresse zum Download kopiert werden.

Vektordaten	ESRI Geodatabase (.gdb), ESRI Shapefile (.shp), OGC GeoPackage (.gpkg), Interlis* (.ili)
Rasterdaten	Tagged Image File (.tif)
Höhendaten (Punktwolken)	ASCII (.xyz), (ESRI optimized LAS (.zlas) auf Anfrage)
3D-Daten	ESRI Geodatabase Multipatch Features (.gdb), OGC CityGML (.gml)

* nur für Produkte für die ein Interlis-Datenmodell unter models.geo.lu.ch vorliegt.

Alternative Bezugsmöglichkeit: Command Line Interface (CLI) oder Scripting

Ein Beispiel für den Download von Geodaten mittels STAC-API über die GDAL-Library findet sich hier.

Bezug von zugriffsgeschützten Daten

Berechtigte Kunden können - je nach zugeteilten Rechten - folgende nicht-öffentlichen Produkte via STAC-API beziehen.

Produkt	Wer kann Daten beziehen?	Was kann bezogen werden?
Amtliche Vermessung🔒	- Kunden mit einem Dauernutzervertrag für amtliche Vermessungsdaten - Mitglieder Raumdatenpool (Kat. A und B)*	Daten im Datenmodell DM.01-LU im INTERLIS-Format pro Gemeinde im berechtigten Vertragsgebiet
Nutzungsplanung	Mitglieder Raumdatenpool (Kat. A und B)*	Daten sind öffentlich. Berechtigte Kunden können Daten zusätzlich gemeindeweise im INTERLIS-Format beziehen.
Leitungskataster LKMap🔒, Werkinformationen Abwasser🔒, Werkinformationen Wasser 🔒	Mitglieder Raumdatenpool (Kat. A und B)*	Daten (alle Medien) im INTERLIS-Format im berechtigten Vertragsgebiet (eine oder mehrere Gemeinden)

* Zusätzlich erhalten GIS-Koordinatoren, Feuerwehren, sowie private Ing.-und Planungsbüros, welche im Auftrag eines Mitglieds der Kategorie A oder B Daten verwalten (nicht für einzelne Projekte), einen Zugang. Siehe raumdatenpool.ch (unter "Antrag Datenbezug und Downloaddienste")

Geschützte Daten via STAC-Browser beziehen

ℹ️Der Kanton bietet keinen Bezug von Daten via FTP mehr an. Berechtigte Kunden können alle Daten via STAC-Browser oder API beziehen.

Um geschützte Daten über das ATC-API beziehen zu können ins eine Authentifizierung notwendig.

Step-By-Step-Anleitung Geschützte Daten via STAC-Browser beziehen einblenden

Geschützte Daten via Kommandozeile (CLI) oder Scripting automatisiert beziehen

Folgende Step-By-Step-Anleitung zeigt wie Daten der amtlichen Vermessung (AV-Daten) mittels Kommandozeilen-Programm cURL automatisiert bezogen werden können.

Step-By-Step cURL-Aufruf und Antworten einblenden

Schritt 1: Zugangstoken (bearer token) generieren, um auf geschützte Daten zugreifen zu können

ℹ️Sonderzeichen in Passwörtern sind durch %-kodierte Zeichen zu ersetzen.

curl -v --data "email=hans.muster@lu.ch&password=PASSWORD"
https://daten.geo.lu.ch/api/stac/v1.0/login/

Antwort (HTTP-Header):

< HTTP/1.1 201 Created
< Cache-Control: max-age=0, private, must-revalidate
< Content-Type: application/json
< Vary: Origin,Accept-Encoding
< x-robots-tag: noindex
< authorization: Bearer <ACCESS_TOKEN>
...

Schritt 2 (optional): Gültigkeit Zugrifftoken prüfen

curl -H "Authorization: Bearer <ACCESS_TOKEN>" https://daten.geo.lu.ch/api/stac/v1.0/login/

Antworten (JSON):

Token gültig:

{
"firstname": "Hans",
"lastname": "Muster",
"email": "hans.muster@lu.ch"
}

Token ungültig:

{

"error": "Unauthorized. Invalid or expired token."
}

Schritt 3: Liste aller verfügbaren Produkte (collections) abfragen

curl -H "Authorization: Bearer <ACCESS_TOKEN>"
https://daten.geo.lu.ch/api/stac/v1.0/collections/

Antwort (JSON, Ausschnitt):

{
"type": "Catalog",
"collections": [
...
{
"id": "AMTVERXX_COL_V2",
"type": "Collection",
"title": "Amtliche Vermessung 🔒",
"updated": "2025-02-24T23:49:29.583Z",
"created": "2021-09-02T09:19:07.559Z",
"keywords": ["Basiskarte", "Grundbuch", "Grundeigentum", "Amtliche Vermessung/AV"],
"description": "Die amtliche Vermessung liefert geometrische Daten zum Grundeigentum. Die Daten sind in drei verschiedenen Modellen verfügbar. \nBei jedem Bezug werden zusätzlich aktuelle 1m-Höhenlinien abgegeben.\n\n",
"summaries": {
"proj:code": ["EPSG:2056"]
},
"license": "proprietary",
"providers": [ ...],
"extent": { ... },
"links": [
...
{
"rel": "items",
"href": "https://daten.geo.lu.ch/api/stac/v1.0/collections/AMTVERXX_COL_V2/items/",
"type": "application/json",
"auth:refs": ["jwt"]
},
....
],
"assets": { ... },
"stac_version": "1.1.0"
},
...
}

Schritt 4: Auflisten aller verfügbaren Datensätze (Items) im Produkt "Amtliche Vermessung 🔒"

ℹ️Geodatenprodukte sind versioniert. Auf Angabe der korrekten Version achten (in diesem Fall "_V2").

curl -H "Authorization: Bearer <ACCESS_TOKEN>"
https://daten.geo.lu.ch/api/stac/v1.0/collections/AMTVERXX_COL_V2/items/

Antwort (JSON, Ausschnitt):

{
"type": "FeatureCollection",
"features": [{
"id": "AMTVERXX_COL-1052",
"collection": "AMTVERXX_COL_V2",
"type": "Feature",
"properties": { ... },
"bbox": [ ... ],
"geometry": { ... },
"links": [
...
{
"rel": "self",
"href": "https://daten.geo.lu.ch/api/stac/v1.0/collections/AMTVERXX_COL_V2/items/AMTVERXX_COL-1052",
"type": "application/json"
}],
"assets": {}
}
],
"links": [ ... ],
"stac_version": "1.1.0"
}

Schritt 5: Datei (Asset) herunterladen

ℹ️In diesem Beispiel werden amtliche Vermessungsdaten für die Stadt Luzern (luze) als INTERLIS-Datei (.itf) über ein ZIP-File bezogen.

curl -H "Authorization: Bearer <ACCESS_TOKEN>" https://download.geo.lu.ch/api/stac/v1.0/downloads/AMTVERXX_COL_V2/AMTVERXX_COL-1061/a_luze.itf -o a_luze.itf

Schritt 6: Zugriffstoken löschen (Logout)

curl -H "Authorization: Bearer <ACCESS_TOKEN>" -X DELETE https://daten.geo.lu.ch/api/stac/v1.0/logout/

Antwort wenn abmelden erfolgreich (JSON):

{
"message": "Logged out"
}

Seite zuletzt aktualisiert. Mai 2025

Endpunkt	Beschreibung
/	Liefert die API-Capabilities
/conformance	Info über die Standards, mit denen die API konform ist. (Stand Frühling 2025: STAC Specification v.1.0, OGC API Features v.1.0)
/collections	Liste der verfügbaren Datenprodukte (Collections)
/collections/{collectionId}	Liefert Beschreibung (Metadaten) einer einzelnen Collection (JSON)
/collections/{collectionId}/items	Liefert die Items in einer Collection (GeoJSON)
/collections/{collectionId}/items/{featureId}	Liefert ein einzelnes Item (GeoJSON)
/search *Coming Soon*	Liefert eine Liste von Items, die den Abfrageparametern entsprechen. Ähnlich wie /collections/{collectionId}/items, führt jedoch die Filterung über alle Collections durch