...

Weiterführende Informationen

• Organisationshandbuch geodienste.ch (Login als Bereitsteller erforderlichintern, Bereitstellung auf Anfrage)

• Strategie geodienste.ch

• Umsetzungsgrundlagen (technische Hilfestellungen zur Datentransformation in minimale Geodatenmodell (MGDM), Ergebnisberichte der Erstumsetzung der Angebote)

...

Es stehen grundsätzlich zwei Umgebungen bereit, das Integrationssystem (https://integration.geodienste.ch) und das Produktivsystem (https://geodienste.ch).

Angebotsplanung

Sobald ein Angebot eingerichtet ist, werden die Bereitsteller von geodienste.ch mit einer automatischen Benachrichtigung (E-Mail) aufgefordert, innerhalb einer bestimmten «Planungsfrist» (i.d.R. ein Monat) die Bereitstellung des entsprechenden Angebots einzuplanen.

...

Es stehen die Parameter gemäss Tabelle zur Verfügung:

Datenimport

Der Datenimport wird mit dem geodienste.ch REST-API ausgelöst oder kann auch manuell über über das Administrationstool eingeplant werden. geodienste.ch prüft vor dem Import die Geodaten bezüglich der Modellkonformität mit der Software ilivalidator. Diese Software berücksichtigt gegebenenfalls die konfigurierte Fehlertoleranz bei unvollständigen oder fehlerhaften Daten gemäss mitgieferter mitglieferter Konfigurationsdatei config.toml. Die ZIP-Datei kann entweder via kantonalem Web-/FTP-Server oder über das geodienste.ch REST-API auf geodienste.ch transferiert werden.

...

Beispiele mit cURL:

• Vollimport planerischer_gewaesserschutz mit automatischer Veröffentlichung:
  curl -u [user]:[password] -F topic=planerischer_gewaesserschutz -F lv95_file=@[/path/to/lv95.zip] -F publish=true "https://geodienste.ch/data_agg/interlis/import"

• Vollimport planerischer_gewaesserschutz bei Verwendung des konfigurierten Web-/FTP-Servers als Datenquelle, statt die Zip-Datei direkt hochzuladen, mit automatischer Veröffentlichung:
  curl -u [user]:[password] -F topic=planerischer_gewaesserschutz -F publish=true "https://geodienste.ch/data_agg/interlis/import"

• Teilmport av mit automatischer Veröffentlichung und Überspringen von fehlerhaften Dateien:
  curl -u [user]:[password] -F topic=av -F lv95_file=@[/path/to/lv95.zip] --F replace_all=false -F force_import=true -F publish=true "https://geodienste.ch/data_agg/interlis/import"

...

Tipps zu cURL:

...

• Löschen eines oder mehrerer xtf aus den bestehenden Daten: curl -u [user]:[password] -F topic=av -F delete=true -F datasets=example_a.xtf,example_b.xtf "https://geodienste.ch/data_agg/interlis/import"

...

Falls bei Datenimport nicht die Option publish=true verwendet wurde, muss die Publikation noch manuell angestossen werden über die URL https://geodienste.ch/data_agg/interlis/publish.

Beispiel mit cURL:

curl -u user:password -F topic=planerischer_gewaesserschutz "https://geodienste.ch/data_agg/interlis/publish"

...

Der Vertrieb des Darstellungsdienstes (WMS) und der Daten (z.B. WFS, INTERLIS, GeoPackage, ESRI Shapefile) erfolgt getrennt. Pro Angebot sind hierzu die erforderlichen kantonalen Angebotsinformation unter ./services/subscribable zu konfigurieren. Folgende Felder stehen zur Verfügung:

Aktualisierung

...

Wählt der Nutzer im Bestellformular eines Angebots ein Kanton mit Zugriffskategorie «Freigabe erforderlich» aus, wird dieser aufgefordert, zusätzlich folgende Angaben zu machen:

Die Bereitsteller werden bei Anmeldungen bzw. Bestellungen automatisch per E-Mail an die im Profil unter "E-Mail Admin [Kantonskürzel]" definierte E-Mail-Adresse benachrichtigt.

...

Es besteht die Möglichkeit, die Bereitsteller-Rechte zu delegieren.

Berechtigungen

Die Delegierung der Rechte erfolgt getrennt nach den Prozessen der Datenintegration und des Vertriebs angebotsweise an registrierte Nutzer unter geodienste.ch . Dabei sind folgende Einschränkungen zu beachtenkönnen folgende Berechtigungen delegiert werden:

• Delegierung DatenintegrationDatenupload: Der delegierte Nutzer erhält vom Kanton lediglich das Recht, den Datenimport Upload für das bestimmte Angebot mit dem API auszuführen. Die Konfiguration der Integration muss also vorgängig durch den Bereitsteller festgelegt worden sein, damit der delegierte Nutzer das API entsprechend nutzen kann. Automatische Benachrichtigungen bezüglich der Datenintegration werden anstatt an den Bereitsteller an den Delegierten versendet.

• Delegierung Veröffentlichung: Der delegierte Nutzer erhält vom Kanton lediglich das Recht, den Datenimport und die Veröffentlichung für das bestimmte Angebot mit dem API auszuführen. Die Konfiguration der Integration muss also vorgängig durch den Bereitsteller festgelegt worden sein, damit der delegierte Nutzer das API entsprechend nutzen kann. Automatische Benachrichtigungen bezüglich der Datenintegration werden anstatt an den Bereitsteller an den Delegierten versendet.

• Delegierung Vertriebauszuführen.

  • Gelieferte Datasets werden dem delegierten User zugewiesen, validiert und intern abgelegt.

  • Uploads können von unterschiedlichen Delegierten pro Angebot und Kanton parallel gestartet werden.

  • Die Kantone können mit API uploaded_datasets die angelieferten Datasets abfragen (welche Datasets wurden wann durch welchen Delegierten geliefert?) und als Zip beziehen (beispielsweise zur Weiterverarbeitung KGDI-intern).

  • Die Kantone können mit API import_uploadeddie angelieferten Datasets direkt auf geodienste.ch importieren und publizieren.

  • Gelieferte Datasets, welche nicht innerhalb eines Monats durch den Kanton verarbeitet werden, werden automatisch entfernt.

• Delegierung Datenimport: Der delegierte Nutzer erhält vom Kanton lediglich das Recht, die Zugriffskontrolle den Upload und Datenimport für das bestimmte Angebot mit den API auszuführen. Automatische Benachrichtigungen bezüglich Anmeldungen werden anstatt an den Bereitsteller an den Delegierten versendet.

...

• • Gelieferte Datasets werden dem delegierten User zugewiesen, validiert und importiert.

  • ❗ Aus technischen Gründen ist es nicht möglich, dass mehrere Delegierte Datasets für einen Kanton in denselben Angebot gleichzeitig importieren.❗

  • Mit Option replace_all=true werden nur die eigenen Datasets des Delegierten oder jene des Kantons entfernt bzw. ersetzt, aber keine anderer Delegierter.

  • Mit Option delete können bestimmte Datasets gelöscht werden. Es können nur eigene Datasets des Delegierten gelöscht werden.

  • Die Kantone sowie alle Delegierten können mit API imported_datasets die importierten Datasets abfragen (welche Datasets von welchen User wurden wann importiert?).

• Delegierung Veröffentlichung: Der delegierte Nutzer erhält vom Kanton das Recht, die Veröffentlichung für das bestimmte Angebot mit dem API auszuführen.

  • Importierte Datasets werden publiziert.

• Delegierung Vertrieb: Der delegierte Nutzer erhält vom Kanton das Recht, die Zugriffskontrolle für das bestimmte Angebot auszuführen.

  • Zugriffsrechte für Angebote mit Zugangskategorie (“Freigabe erforderlich”) können administriert werden.

  • Automatische Benachrichtigungen bezüglich Anmeldungen werden anstatt an den Bereitsteller an den Delegierten versendet.

Grundsätzliches

• Die Konfiguration der Integration muss vorgängig durch den Bereitsteller festgelegt worden sein, damit der delegierte Nutzer das API entsprechend nutzen kann.

• Delegierte können Datensätze von anderen Delegierten nicht überschreiben.

• Die Kantone sowie alle Delegierten können mit API imported_datasets die importierten Datasets abfragen (welche Datasets von welchen User wurden wann importiert?).

• Automatische Benachrichtigungen bezüglich der Datenintegration werden anstatt an den Kanton/Bereitsteller an den Delegierten versandt.

Übersicht API und Berechtigungen

siehe https://geodienste.ch/api-docs/index.html

Die für die Datenbereitstellung relevanten API sind die folgenden:

• GET data_agg/delegations: Abfrage der aktuellen Berechtigungen

• POST /data_agg/interlis/import: Import, Delete oder nur Upload

• GET /data_agg/import_tasks/uploaded_datasets: Liste der Datasets aus nur Upload, Bezugsmöglichkeit Uploaded.zip

• POST /data_agg/import_tasks/import_uploaded: Import Datasets aus nur Upload

• GET /data_agg/import_tasks/imported_datasets: Liste der importierten Datasets

• POST /data_agg/interlis/publish: Veröffentlichung

Zusätzlich stehen Endpunkte zur Abfrage der Status und Logs bereit.

Image Added

Change Management der Angebote

...

Rasterdaten können mit einem Pythonskript (https://www.kgk-cgc.ch/download_file/938/224) auf geodienste.ch integriert werden. Bei Rasterdaten muss im Gegensatz zu Vektordaten keine Konfiguration der Datenintegration eingerichtet werden.

Beachten Sie die Informationen im Skript. Die Zeilen zwischen --->>> START: TO BE FILLED OUT BY USER <<<--- und --->>> END: TO BE FILLED OUT BY USER <<<--- des Skripts müssen durch den Anwender ausgefüllt werden. Für den Erhalt des S3 Access Key sowie S3 Secret Key wenden Sie sich bitte an geodienste@kgk-cgc.ch. Nachdem alle Parameter ausgefüllt sind, kann das Skript ausgeführt werden. Dabei werden sowohl Import als auch Veröffentlichung der Rasterdaten durchgeführt. Weitere Informationen zum Skript sind direkt im Skript selbst enthalten. Mit dem Aufruf python3 rasterdata_import.py --h können Informationen zu den verfügbaren Argumenten angezeigt werden.

Beispiel Beispiele Ausführung Skript:

python3 rasterdata_import.py -t luftbild -p /path/to/rasterdata -e production --dry_run

python3 rasterdata_import.py -t luftbild -p /path/to/rasterdata -e production

...

Die Datenlieferung erfolgt pro Kanton (full extract) und Modell als XTF-Datei. In den Modellen der landwirtschaftlichen Bewirtschaftung existieren modellübergreifende Referenzen. Entsprechend müssen beim Datenimport nicht nur die Referenzen geliefert werden, sondern jeweils alle referenzierten modellübergreifenden Objekte mitimportiert werden. Dies hat zur Folge, dass gewisse Daten mehrmals importiert werden müssen. Beispielsweise müssen die Bewirtschaftungseinheiten (ID 153.6) zusätzlich beim Import der Nutzungsflächen (ID 153.1) mitimportiert werden und je nach Referenzen müssen die Nutzungsflächen gewisse Daten mehrmals importiert werden müssen. Beispielsweise müssen die Bewirtschaftungseinheiten (ID 153.16) zusätzlich beim Import der Biodiversitätsförderflächen Q II und Vernetzung Nutzungsflächen (ID 153.31) mitimportiert werden (siehe Beispiele unten). Die alphabetische Namensgebung der XTF-Files garantiert die korrekte Importreihenfolge. Beim Import müssen erst die referenzierten Objekte - danach die darauf referenzierenden Objekte importiert werden. Die Transferdaten der sieben Modelle müssen nach den Namensvorgaben des BLW und der alphabetischen Reihenfolge von geodienste.ch aufbereitet und benannt werden. Die Struktur besteht aus dem Kantonskürzel, dem Buchstaben a-c und der Datensatz-ID. Der Dateiname muss immer gleich bleiben.

1. Rebbaukataster (ID 151.1):
   BE_151_1.zip
   - BE_a_151_1.xtf

2. Nutzungsflächen (inkl. BFF Qualitätsstufe I) (ID 153.1):
   BE_153_1.zip
   - BE_a_153_6.xtf
   - BE_b_153_1.xtf

3. Perimeter Terrassenreben (ID 153.2):
   BE_153_2.zip
   - BE_a_153_2.xtf

4. BFF Q2 und Vernetzung (ID 153.3):
   BE_153_3.zip
   - BE_a_153_6.xtf
   - BE_b_153_1.xtf
   - BE_c_153_3.xtf

5. Perimeter LN- und Sömmerungsflächen (ID153.5):
   BE_153_5.zipBE_a_1zip
   - BE_a_153_5.xtf

6. Bewirtschaftungseinheit (ID 153.6):
   BE_153_6.zip
   - BE_a_153_6.xtf

7. Elemente mit Landschaftsqualität (ID 153.8):
   BE_153_8.zip
   - BE_a_153_8.xtf

Weitere Informationen zur Landwirtschaftlichen Bewirtschaftung sind unter https://www.kgkcgc.ch/koordination/umsetzung-mgdm/Umsetzungsprozess und im Leitfaden Geodatenaustausch Landwirtschaftliche Bewirtschaftung zu finden.

Checkliste

Folgende Checkliste kann kopiert und verwendet werden für die Umsetzung eines Angebots.