Table of Contents | ||||||||
---|---|---|---|---|---|---|---|---|
|
...
Weiterführende Informationen
Organisationshandbuch geodienste.ch (Login als Bereitsteller erforderlichintern, Bereitstellung auf Anfrage)
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).
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 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.
...
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"
...
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"
Info |
---|
Tipps zu cURL: Falls geodienste.ch von der eigenen kantonalen Firewall als unsicher eingestuft wurde, kann zur Überbrückung der zusätzliche Schalter Bei Problemen mit Timeouts aufgrund cURL können folgende Optionen verwendet werden: |
...
publish
ist nur bei automatischer Veröffentlichung (publish=true
) vorhanden. Falls der Import noch nicht abgeschlossen ist, sind Publish-Task ID und Status je null
.
Anchor | ||||
---|---|---|---|---|
|
Abfrage Log-FilesDie Logs eines Import-Tasks oder eines Publish-Tasks können ohne Login als Plain-Text (default) oder JSON abgefragt werden: Status staging
Zeigt den letzten Importiert Stand an. Kann zum Beispiel in Zusammenhang mit der Delegation von Bereitstellerrechten verwendet werden.
GET https://www.geodienste.ch/data_agg/import_tasks/:id/logs
Code Block |
---|
Import / Publish task ID: 123
Status: completed
15.06.2017 17:12:26: Downloading LV95 zip
15.06.2017 17:12:27: Download of LV95 zip complete (835217 Bytes, 0.268
s)
15.06.2017 17:12:27: Starting ilivalidator with options: '--
forceTypeValidation false --disableAreaValidation true'
15.06.2017 17:12:53: Info: ilivalidator-1.2.1-20170420
Info: ili2c-4.7.2-20170413
... |
GET https://geodienste.ch/data_agg/import_tasks/:id/logs.json
...
staging?topic=naturereigniskataster_v1_0
curl -u user:password "https://geodienste.ch/data_agg/import_tasks/staging?topic=naturereigniskataster_v1_0"
Code Block |
---|
{
"task_id":2454,
"status":"completed",
"completed_at":"2022-09-29T11:57:33",
"logs_url":"https://geodienste.ch/data_agg/import_tasks/2454/logs.json",
"data_published":true,
"import_zip_url":"https://geodienste.ch/downloads/staging/interlis/naturereigniskataster/FL/naturereigniskataster_v1_0_FL_lv95_import.zip"
},
"publish":
{
"task_id":1516,
"status":"completed",
"completed_at":"2022-09-29T11:59:59"
}
} |
Abfrage Log-Files
Die Logs eines Import-Tasks oder eines Publish-Tasks können ohne Login als Plain-Text (default) oder JSON abgefragt werden:
GET https://geodienste.ch/data_agg/import_tasks/:id/logs
Code Block |
---|
Import / Publish task ID: 123 Status: completed 15.06.2017 17:12:26: Downloading LV95 zip 15.06.2017 17:12:27", "message": "Download of LV95 zip complete (835217 Bytes, 0.268s)", "level": 0 }, ... ] } |
Publikation
Publikation starten
...
268
s)
15.06.2017 17:12:27: Starting ilivalidator with options: '--
forceTypeValidation false --disableAreaValidation true'
15.06.2017 17:12:53: Info: ilivalidator-1.2.1-20170420
Info: ili2c-4.7.2-20170413
... |
GET 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"
Die Abfragen und Antworten des API für den Status und des Logs erfolgt analog zum Import.
Status: GET https://geodienste.ch/data_agg/publish_tasks/:id/status
Plain-Text Log: GET https://geodienste.ch/data_agg/publish_tasks/:id/logs
JSON Log: GET https://geodienste.ch/data_agg/publish_tasks/:id/logs.json
Aktivierung Angebot
Note |
---|
Wichtig: Nach der erstmaligen Veröffentlichung sind die Geodienste und -daten noch nicht für die Nutzung zugänglich, dazu muss das Angebot zuerst aktiviert werden! |
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. |
Es wird angestrebt, dass der Stand der veröffentlichten Daten zwischen geodienste.ch und den weiteren kantonalen Vertriebskanälen (bspw. kantonales Geoportal) nicht mehr als 24 Stunden voneinander abweicht. Die Bereitsteller sind angehalten, die Datenaktualisierung auf geodienste.ch entsprechend zu automatisieren und ihre Datenprozesse beispielsweise mittels API geodienste.ch zu überwachen.
Vertrieb
Eine anonymisierte Zugriffsstatistik steht ab 2018 unter https://geodienste.ch/distribution/stats zur Verfügung und kann jederzeit bezogen werden.
Administration der Zugangsberechtigung (nur für Angebote mit «Freigabe erforderlich»)
Für Angebote der Zugriffskategorie “Freigabe erforderlich” ist die Administration der Zugangsberechtigungen erforderlich.
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.
Die Bereitsteller von Angeboten mit Zugriffskategorie «Freigabe erforderlich» müssen bei Daten- / Dienstbezügen die Zugriffsrechte an den registrierten Nutzer vergeben oder die Anmeldung ablehnen.
Falls eine offene Anmeldung nicht bearbeitet wurde, wird der betroffene Bereitsteller erstmals nach 8 Tagen automatisch per E-Mail erinnert. Wenn die Anmeldung danach offen bleibt, wird alle 2 Wochen nach dem Bestelldatum die Erinnerung mit CC an geodienste@kgk-cgc.ch versendet und zusätzlich eine Meldung an den Kunden geschickt.
Verlängerung: Die Nutzer/innen werden automatisch zwei Wochen vor Ablauf des «Zeitraum der Verwendung» erinnert, dass das Zugriffsrecht abläuft. Für die Weiterbenutzung kann der Nutzer die Bestellung unter https://geodienste.ch/myservices verlängern.
Info |
---|
Hinweise:
|
Delegierung Bereitsteller-Rechte
Es besteht die Möglichkeit, die Bereitsteller-Rechte zu delegieren. 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 beachten:
...
Delegierung Datenintegration: Der delegierte Nutzer erhält vom Kanton lediglich das Recht, den Datenimport für das bestimmte Angebot mit dem API gemäss 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 gemäss 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.
...
/import_tasks/:id/logs.json
Code Block |
---|
{
"success": true,
"import"/"publish": {
"task_id": 123,
"status": "completed"
},
"logs": [
{
"timestamp": 1497539546,
"timestamp_text": "15.06.2017 17:12:26",
"message": "Downloading LV95 zip",
"level": 0
},
{
"timestamp": 1497539547,
"timestamp_text": "15.06.2017 17:12:27",
"message": "Download of LV95 zip complete (835217 Bytes, 0.268s)",
"level": 0
},
...
]
} |
Publikation
Publikation starten
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"
Die Abfragen und Antworten des API für den Status und des Logs erfolgt analog zum Import.
Status: GET https://geodienste.ch/data_agg/publish_tasks/:id/status
Plain-Text Log: GET https://geodienste.ch/data_agg/publish_tasks/:id/logs
JSON Log: GET https://geodienste.ch/data_agg/publish_tasks/:id/logs.json
Aktivierung Angebot
Note |
---|
Wichtig: Nach der erstmaligen Veröffentlichung sind die Geodienste und -daten noch nicht für die Nutzung zugänglich, dazu muss das Angebot zuerst aktiviert werden! |
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. |
Es wird angestrebt, dass der Stand der veröffentlichten Daten zwischen geodienste.ch und den weiteren kantonalen Vertriebskanälen (bspw. kantonales Geoportal) nicht mehr als 24 Stunden voneinander abweicht. Die Bereitsteller sind angehalten, die Datenaktualisierung auf geodienste.ch entsprechend zu automatisieren und ihre Datenprozesse beispielsweise mittels API geodienste.ch zu überwachen.
Vertrieb
Eine anonymisierte Zugriffsstatistik steht ab 2018 unter https://geodienste.ch/distribution/stats zur Verfügung und kann jederzeit bezogen werden.
Administration der Zugangsberechtigung (nur für Angebote mit «Freigabe erforderlich»)
Für Angebote der Zugriffskategorie “Freigabe erforderlich” ist die Administration der Zugangsberechtigungen erforderlich.
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.
Die Bereitsteller von Angeboten mit Zugriffskategorie «Freigabe erforderlich» müssen bei Daten- / Dienstbezügen die Zugriffsrechte an den registrierten Nutzer vergeben oder die Anmeldung ablehnen.
Falls eine offene Anmeldung nicht bearbeitet wurde, wird der betroffene Bereitsteller erstmals nach 8 Tagen automatisch per E-Mail erinnert. Wenn die Anmeldung danach offen bleibt, wird alle 2 Wochen nach dem Bestelldatum die Erinnerung mit CC an geodienste@kgk-cgc.ch versendet und zusätzlich eine Meldung an den Kunden geschickt.
Verlängerung: Die Nutzer/innen werden automatisch zwei Wochen vor Ablauf des «Zeitraum der Verwendung» erinnert, dass das Zugriffsrecht abläuft. Für die Weiterbenutzung kann der Nutzer die Bestellung unter https://geodienste.ch/myservices verlängern.
Info |
---|
Hinweise:
|
Delegierung Bereitsteller-Rechte
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 können folgende Berechtigungen delegiert werden:
Delegierung Datenupload: Der delegierte Nutzer erhält vom Kanton das Recht, den Upload für das bestimmte Angebot auszufü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_uploaded
die 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 das Recht, den Upload und Datenimport für das bestimmte Angebot mit den API auszuführen.
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 BerechtigungenPOST /data_agg/interlis/import
: Import, Delete oder nur UploadGET /data_agg/import_tasks/uploaded_datasets
: Liste der Datasets aus nur Upload, Bezugsmöglichkeit Uploaded.zipPOST /data_agg/import_tasks/import_uploaded
: Import Datasets aus nur UploadGET /data_agg/import_tasks/imported_datasets
: Liste der importierten DatasetsPOST /data_agg/interlis/publish
: Veröffentlichung
Zusätzlich stehen Endpunkte zur Abfrage der Status und Logs bereit.
Rolle / Berechtigung |
| Import | nur Upload |
|
|
| Veröffentlichung | Vertrieb |
---|---|---|---|---|---|---|---|---|
Bereitsteller/Kanton | X | X | X | X | X | X | ||
Delegierter / | X | X | X | |||||
Delegierter / | X | X | X | |||||
Delegierter / | X | X | X | X | X | X | ||
Delegierter / | X | X | ||||||
Admin | X | X | X | X | X | X |
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
Note |
---|
Zu beachten: :
|
...
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 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.
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_1zip
- 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
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.
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 |
|