...
Es stehen grundsätzlich zwei Umgebungen bereit, das Integrationssystem (https://integration.geodienste.ch) und das Produktivsystem (https://geodienste.ch).
Umgebung | Zweck | Prozesse |
---|---|---|
Integrations-system |
| Erstintegration (Kantone) |
Produktiv-system |
| 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. |
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 | ||
---|---|---|---|
| Technische Bezeichnung des Angebots (z.B. | ||
| Zip-File mit LV95 Daten (Parameter nicht verwendbar, falls Variante «Webserver Bereitsteller» verwendet wird) | ||
| Alle Daten des Kantons werden vor dem Import gelöscht; mit der Deaktivierung dieser Option ( Default:
| ||
| Damit werden alle validierten Default:
| ||
| Bei Default: | ||
| Mit | ||
| 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 |
---|---|
| Technische Bezeichnung des Angebots (z.B. |
| 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.
|
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.
...
Rebbaukataster (ID 151.1):
BE_151_1.zip
- BE_a_151_1.xtfNutzungsflächen (inkl. BFF Qualitätsstufe I) (ID 153.1):
BE_153_1.zip
- BE_a_153_6.xtf
- BE_b_153_1.xtfPerimeter Terrassenreben (ID 153.2):
BE_153_2.zip
- BE_a_153_2.xtfBFF Q2 und Vernetzung (ID 153.3):
BE_153_3.zip
- BE_a_153_6.xtf
- BE_b_153_1.xtf
- BE_c_153_3.xtfPerimeter LN- und Sömmerungsflächen (ID153.5):
BE_153_5.zipBE_a_1
- BE_a_153_5.xtfBewirtschaftungseinheit (ID 153.6):
BE_153_6.zip
- BE_a_153_6.xtfElemente 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 |
| |
2.1 | Erstintegration | integration.geodienste.ch |
| |
2.2 |
| |||
2.3 |
| |||
2.4 |
| |||
3.1 | Erstintegration | geodienste.ch |
| |
3.2 |
| |||
3.3 |
| |||
3.4 |
| |||
4.1 | Aktualisierung | geodienste.ch |
| |
4.2 |
| |||
5.1 | Vertrieb | geodienste.ch |
|