Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

Umgebung

Zweck

Prozesse

Integrations-system

  • Aufbau und Test neuer Angebote durch die KGK und die beteiligten Kantone sowie Partner

  • Test Datenintegration durch Kantone

Erstintegration (Kantone)

Produktiv-system

  • Bereitstellung Geobasisdaten und -dienste

Angebotsplanung

Erstintegration

Aktualisierung

Vertrieb

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:

Parameter

Beschreibung

Angebot

Auswahl des Themas (ggf. auf benötigte Versionsnummer achten)

Datenimport

Auswahl der Methodik für den Datenimport.
Web-/FTP-Server Bereitsteller: Die Übermittlung der Geodaten erfolgt beim Datenimport mittels eines Downloads vom einem Web-/FTP-Server. Datenimporte und Publikationen werden entweder durch den Bereitsteller eingeplant oder übers REST-API ausgelöst.
geodienste.ch REST-API: Die Übermittlung der Geodaten erfolgt beim Datenimport mittels eines Uploads der Daten von der kantonalen Geodateninfrastruktur nach geodienste.ch. Datenimporte und Publikationen können so automatisch nach den Nachführungsprozessen der Geodaten in den kantonalen Geodateninfrastruktur ausgeführt werden.

ilivalidator

Auswahl der zu verwendenden Version des ilivalidators.

LV95 URL (ZIP)

Link zum *.zip, welches die zu importierenden Geodaten im Bezugsrahmen LV95 enthält (bei Datenimport mit Variante Web-/FTP-Server), respektive Aktivierung des LV95 Imports (bei Datenimport mit Variante geodienste.ch REST-API)

Benutzername

Parameter für Datenimport mit Variante Web-/FTP-Server:

Benutzername bei Einsatz von http basic authentication für LV95 URL

Passwort

Parameter für Datenimport mit Variante Web-/FTP-Server:

Passwort bei Einsatz von http basic authentication für LV95 URL

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 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.

...

Note

Täglich zwischen 18:00 und 6:00 Uhr gibt es eine Zwangspause für die automatische Wartung (VACUUM) der Datenbank von geodienste.ch. Dadurch kann es sein, dass Jobs, welche in diesem Zeitraum angestossen werden, bis zu 2h verzögert starten.

Paramter für POST Request

Beschreibung

topic

Technische Bezeichnung des Angebots (z.B. planerischer_gewaesserschutz)

lv95_file

Zip-File mit LV95 Daten (Parameter nicht verwendbar, falls Variante «Webserver Bereitsteller» verwendet wird)

replace_all

Alle Daten des Kantons werden vor dem Import gelöscht; mit der Deaktivierung dieser Option (false) können bei einem Import nur einzelne *.xtf oder *.itf Dateien aktualisiert/ergänzt werden (Teil-Import). Dabei ist zu beachten, dass diese Teil- Aktualisierung auf dem *.xtf oder *.itf Dateinamen basiert, die neue Datei muss entsprechend gleich benannt sein wie die zu ersetzende Datei.

Default: true

Note
  • Erstintegration: Bei der Erstintegration ist ein Voll-Import erforderlich.

  • Aktualisierung: Für die Aktualisierung empfiehlt es sich beim umfangreichen Thema Amtliche Vermessung, Teil-Importe durchzuführen, d.h. die Prozesse so einzurichten, dass die Option replace_all=false verwendet wird und nur die aktualisierten *.itf Dateien transferiert werden.

force_import

Damit werden alle validierten *.xtf / *.itf Dateien importiert, auch wenn sich fehlerhafte *.xtf / *.itf Dateien im ZIP-File befinden. Die fehlerhaften *.xtf / *.itf Dateien werden übersprungen und entsprechend mit validation failed und Skipping import of [Filename].xtf / [Filename].itf im Log der Datenintegration vermerkt. Beinhaltet das ZIP-File fehlerhafte *.xtf / *.itf Dateien, wird der Import-Status completed with errors ausgegeben.

Default: false

Note

Einschränkung: Diese Option kann nur für Teil-Importe verwendet werden, wenn auch replace_all=false verwendet wird.

Achtung: Bedingt durch den Teil-Import gibt es keinen einheitlichen kantonalen Datenstand mehr.

publish

Bei publish=true wird die Veröffentlichung automatisch anschliessend an den Datenimport durchgeführt.

Default: false

delete

Mit delete lassen sich ein oder mehrere bereits importierte xtf löschen. Im Anschluss wird ein Publish ausgeführt.

canton

Kantonskürzel (dieser Parameter ist nur nötig, falls der Datenimport nicht durch den Bereitsteller, sondern durch einen delegierten Nutzer durchgeführt wird)

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"

  • 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.

Paramter für POST Request

Beschreibung

topic

Technische Bezeichnung des Angebots (z.B. planerischer_gewaesserschutz)

canton

Kantonskürzel (dieser Parameter ist nur nötig, falls der Datenimport nicht durch den Bereitsteller, sondern durch einen delegierten Nutzer durchgeführt wird)

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:

Feld

Erklärung

keine Daten

Bei Angeboten, für welche der Kanton auf seinem Gebiet keine realen Objekte besitzt bzw. keine Daten vorhanden sind, muss die Checkbox «keine Daten vorhanden» ausgewählt werden. Dadurch erübrigt sich die gesamte Datenintegration und der Status «keine Daten vorhanden» wird in den Detailinformationen angezeigt.

Version

Nach erfolgreicher Datenintegration und Veröffentlichung wird die verfügbare Version des Angebots ausgewählt und angezeigt.

Aktualisierungs-Zyklus

Angaben zur Nachführung der Daten, z.B. „unregelmässig“, „bei Bedarf“, „wöchentlich“, „monatlich“, „quartalsweise“, „jährlich“, etc. Die Auswahl entspricht den Vorgaben des Metadatenmodells GM03. Für regelmässige Nachführungs-Zyklen gilt: Nach jedem verstrichenen Nachführungs-Zyklus nach der letzten Veröffentlichung wird der betroffene Bereitsteller am Folgetag um 08:00 Uhr benachrichtigt bzw. erinnert, falls die Aktualisierung noch nicht erfolgte. Für den Nachführungszyklus «Laufend» wird dieselbe Logik wie für «Täglich» verwendet, d.h. erstmals 2 Tage nach der letzten Aktualisierung, dann täglich. Beispiel «Wöchentlich»: erste Erinnerung nach 8 Tagen und dann jeweils jede Woche darauf.

Kantonale Vollständigkeit

Häkchen setzen, wenn die Vollständigkeit des Datensatzes vorhanden ist.

Kontakt Fachstelle

Kontakt der zuständigen kantonalen Fachstelle

Bemerkungen

Bemerkungen zu den Geodaten oder zum Angebot. (Hinweis: allgemeingültige Hinweise können hier von der Betriebsleitung für alle Kantone ergänzt werden)

Zugriffskategorie

im Aufbau

Das Angebot nicht erhältlich bzw. im Aufbau (DefaultWert). In Klammer wird ggf. die Angebotsplanung des Kantons angezeigt.

frei erhältlich

Das Angebot ist frei verfügbar. Über die URL (z.B. https://geodienste.ch/db/av) können die Geodienste (WMS/WFS) ohne Registrierung in einem GIS/Applikation eingebunden und genutzt werden. Unter geodienste.ch können dateibasierten Angebote heruntergeladen werden.

Registrierung erforderlich

Das Angebot ist zugriffsgeschützt. Die Nutzung erfordert eine Registrierung. Es erfolgt jedoch keine Zugriffskontrolle. Der Geodienst kann über die URL mit den Logindaten in einem GIS/Applikation eingebunden und genutzt werden. Unter geodienste.ch können die dateibasierten Angebote nach dem Login heruntergeladen werden.

Freigabe erforderlich

Das Angebot ist zugriffsgeschützt. Die Nutzung erfordert eine Registrierung und Bestellung durch den Nutzer sowie eine Freigabe durch den Bereitsteller. Der Geodienst kann nach der Freigabe über die URL mit den Logindaten in einem GIS/Applikation eingebunden und genutzt werden. Unter geodienste.ch können zudem die dateibasierten Angebote nach dem Login heruntergeladen werden.

Vertrag nötig? (nur bei Zugriffskategorie «Freigabe erforderlich»)

Angabe, ob für den Bezug des Geodienstes ein Vertrag nötig ist.

Kosten (optional, nur bei Zugriffskategorie «Freigabe erforderlich»)

Angaben zu den Kosten, z.B. «auf Anfrage», «kostenlos», «pauschal CHF 150.- monatlich», Link zur Gebührenverordnung des Kantons, etc

Nutzungsbedingungen

„keine Nutzungsbedingungen“ oder kantonale Nutzungsbedingungen (Link oder Datei-Upload)

opendata.swiss Nutzungsbedingungen

Nutzungsbedingungen nach opendata.swiss.

Die Deklaration führt dazu, dass die Nutzungsbedingungen tendenziell harmonisiert sind und die Nutzung für die Kunden vereinfacht und übersichtlicher wird. 

Eine Publikation der Angebote auf opendata.swiss durch geodienste.ch findet nicht statt.

Note

Die Kantone, welche Open Data anbieten, werden gebeten, die "opendata.swiss Nutzungsbedingungen" für ihre Angebote anzugeben.

Aktualisierung

Note

Die Aktualisierung soll nur auf dem Produktivsystem eingerichtet werden, um unnötige Last zu vermeiden. Bitte nicht auf dem Integrationssystem einrichten.

...

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

Feld

Bemerkung

Zeitraum der Verwendung

Die Mindestdauer für die Verwendung ist 1 Monat.

Bestellung als

Privatperson, Firma, Bund oder im Auftrag des Bundes, Kanton oder im Auftrag eines Kantons, Gemeinde oder im Auftrag einer Gemeinde, Bildungs- und Forschungsstätten Diese Angabe kann für die rasche Bearbeitung der Bestellung durch den jeweiligen Kanton von Nutzen sein.

Verwendungszweck (optional)

Diese Angabe kann für die rasche Bearbeitung der Bestellung durch den jeweiligen Kanton von Nutzen sein.

BBOX (optional)

Für alle Formate ausser INTERLIS besteht zudem die Möglichkeit der Angabe einer BBOX-Einschränkung. Für die Gemeinde Kriens in LV95 wäre das z.B.: West: 2658400, Süd: 1204000, Ost: 2666200, Nord: 1211200. Die Grösse der BBOX kann vom Bereitsteller oder einem Delegierten unter dem Reiter «Zugriffskontrolle» auch nachträglich angepasst werden.

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.

...

  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_1
    - 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

...

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

Nr

Prozess

Umgebung

Aufgabe

  •  

1

Angebotsplanung

geodienste.ch

  •  Definition Termin (Quartal)
  •  

2.1

Erstintegration

integration.geodienste.ch

  •  Konfiguration der Datenintegration
  •  

2.2

  •  Datenimport
  •  

2.3

  •  Publikation
  •  

2.4

  •  Aktivierung Angebot
  •  

3.1

Erstintegration

geodienste.ch

  •  Konfiguration der Datenintegration
  •  

3.2

  •  Datenimport
  •  

3.3

  •  Publikation
  •  

3.4

  •  Aktivierung Angebot
  •  

4.1

Aktualisierung

geodienste.ch

  •  autom. Aktualisierung mittels API einrichten
  •  

4.2

  •  Optional: Delegierung der Datenintegration
  •  

5.1

Vertrieb

geodienste.ch

  •  Optional: Delegierung des Vertriebs