Table of Contents | ||||||||
---|---|---|---|---|---|---|---|---|
|
...
Informations complémentaires
Manuel d'organisation geodienste.ch (interne, en allemand uniquement, login nécessaire en tant que préparateur, mise à disposition sur demande)
Bases de mise en œuvre (assistance technique pour la transformation des données en modèle de géodonnées minimal (MGDM), rapports sur les résultats de la première mise en œuvre des offres)
...
En principe, deux environnements sont disponibles : le système d'intégration (https://integration.geodienste.ch) et le système de production (https://geodienste.ch).
Environnement | Objectif | Processus |
---|---|---|
système d'intégration |
| Intégration initiale (cantons) |
système de production |
| Plan d’offre Intégration initiale (cantons) Mise à jour Distribution |
Plan d’offre
Au terme de l’intégration des thèmes par le centre opérationnel de la CGC, les préparateurs de geodienste.ch sont invités, par un message automatique (E-Mail), à planifier la mise à disposition de l’offre correspondante dans un certain «délai de planification» (il est d’un mois en général).
...
Les paramètres sont disponibles selon le tableau :
Paramètre | Description |
---|---|
Offre | Choix du thème (si nécessaire, tenir compte du numéro de version requis) |
Importation de données | Choix de la méthode d’importation de données. Serveur Web/FTP Préparateur: les géodonnées sont importées via un téléchargement depuis un serveur Web/FTP. Les importations de données et les publications sont soit planifiées par le préparateur/chargé de la mise à disposition, soit lancées via le REST-API Upload. REST-API Upload: La transmission des géodonnées s'effectue lors de l'importation des données au moyen d'un téléchargement des données de l'infrastructure cantonale de géodonnées vers geodienste.ch . Les importations de données et les publications peuvent ainsi être effectuées automatiquement après les processus de mise à jour des géodonnées dans l'infrastructure cantonale. |
ilivalidator | Sélection de la version d'ilivalidator à utiliser. |
URL MN95 (ZIP) | Lien vers le fichier |
Nom d’utilisateur | Paramètre pour l’importation de données via la variante Serveur Web/FTP: Nom d’utilisateur en cas d’authentification de base http pour URL MN95 |
Mot de passe | Paramètre pour l’importation de données via la variante Serveur Web/FTP: Mot de passe en cas d’authentification de base http pour URL MN95 |
Importation de données
L'importation des données est déclenchée par l'API REST geodienste.ch ou peut être planifiée manuellement via l'outil d'administration. Avant l'importation, geodienste.ch vérifie la conformité du modèle des géodonnées avec le logiciel ilivalidator. Ce logiciel tient compte, le cas échéant, de la tolérance d'erreur configurée en cas de données incomplètes ou erronées selon le fichier de configuration config.toml livré avec le logiciel. Le fichier ZIP peut être transféré sur geodienste.ch soit via le serveur web/ FTP cantonal, soit via l'API REST de geodienste.ch .
...
Note |
---|
Tous les jours entre 18h00 et 6h00, il y a une pause obligatoire pour la maintenance automatique (VACUUM) de la database de geodienste.ch . Il se peut donc que les tâches lancées durant cette période démarrent avec un retard pouvant aller jusqu'à 2 heures. |
Paramètres pour POST Request | Description | ||
---|---|---|---|
| désignation technique de l‘offre (ex.: | ||
| fichier Zip avec des données MN95 (paramètres non utilisables si la variante «Préparateur serveur Web» est utilisée) | ||
| Toutes les données du canton sont effacées avant l'importation ; en désactivant cette option ( Default:
| ||
| Ainsi, tous les fichiers Default:
| ||
| la publication se fait automatiquement après l'importation des données si Default: | ||
| Avec | ||
| Abréviation du canton (ce paramètre n'est nécessaire que si l'importation des données n'est pas effectuée par le fournisseur, mais par un utilisateur délégué) |
Exemples avec cURL:
...
Importation complète de topic
planerischer_gewaesserschutz
avec publication automatique :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"
Importation complète de topic
planerischer_gewaesserschutz
en utilisant le serveur web/FTP configuré comme source de données, au lieu de télécharger directement le fichier zip, avec publication automatique :curl -u [user]:[password] -F topic=planerischer_gewaesserschutz -F publish=true "https://geodienste.ch/data_agg/interlis/import"
Importation partielle de topic
av
avec publication automatique et omission des fichiers erronés :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"
...
Supprimer un ou plusieurs xtf des données existantes :
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 |
---|
Conseils pour cURL: Si geodienste.ch est considéré comme étant peu sûr par votre pare-feu (firewall) cantonal, l'option supplémentaire En cas de problèmes de timeout dus à cURL, les options suivantes peuvent être utilisées : |
...
Si l'option publish=true n'a pas été utilisée lors de l'importation des données, la publication doit encore être déclenchée manuellement via l'URL https://geodienste.ch/data_agg/interlis/publish.
Paramètres pour POST Request | Description |
---|---|
| Désignation technique de l'offre (par exemple |
| Abréviation du canton (ce paramètre n'est nécessaire que si l'importation des données n'est pas effectuée par le préparateur, mais par un utilisateur délégué) |
Exemple avec cURL:
curl -u user:password -F topic=planerischer_gewaesserschutz "https://geodienste.ch/data_agg/interlis/publish"
...
La distribution du service de représentation (WMS) et des données (p. ex. WFS, INTERLIS, GeoPackage, ESRI Shapefile) s'effectue séparément. Pour chaque offre, les informations d'offre cantonales nécessaires doivent être configurées à cet effet sous ./services/subscribable. Les propriétés suivants sont disponibles :
Feld | Erklärung | |||
---|---|---|---|---|
pas de données | Pour les offres pour lesquelles le canton ne possède pas d'objets réels sur son territoire, la case à checkbox "Aucune donnée disponible" doit être sélectionnée. Ainsi, toute l'intégration des données est superflue et le statut "aucune donnée disponible" est affiché dans les informations détaillées. | |||
Version | Après l'intégration et la publication des données, la version disponible de l'offre est sélectionnée et affichée. | |||
Cycle de mise à jour | indications relatives à la mise à jour des données: «irrégulière», «au besoin», «hebdomadaire», «mensuelle», «trimestrielle», «annuelle», etc. Le choix proposé correspond aux prescriptions du modèle de métadonnées GM03. La règle suivante s’applique pour des cycles de mise à jour réguliers: à l’issue de chaque cycle après la dernière publication, le préparateur concerné en est informé par un message le lendemain matin à 8h00 ou cela lui est rappelé, si l’actualisation n’a pas encore eu lieu. La logique de la mise à jour «en permanence» est identique à celle de l’actualisation «quotidienne»: une première fois deux jours après la dernière actualisation, puis chaque jour. Exemple pour une actualisation «hebdomadaire»: premier rappel au bout de 8 jours, puis chaque semaine. | |||
Intégralité cantonale | Cochez cette case lorsque la couverture territoriale est intégrale pour le jeu de données | |||
Contact (service spécialisé) | Contact du service cantonal compétent | |||
Remarques | elles portent sur les géodonnées ou sur l’offre (note: des indications de portée générale peuvent être fournies ici pour tous les cantons par la direction de l’exploitation). | |||
catégorie d’accès | en cours d’élaboration | L’offre n’est pas publiée ou est encore en cours d’élaboration (valeur par défaut). Le plan d’offre du canton est indiqué entre parenthèses le cas échéant. | ||
librement disponible | L’offre est librement disponible. Les géoservices (WMS/WFS) peuvent être intégrés dans un SIG ou une application sans enregistrement via une URL (exemple: https://geodienste.ch/db/av), puis être utilisés. Les offres à base de fichiers peuvent être téléchargées sur geodienste.ch . | |||
enregistrement requis | L’accès à l’offre est protégé. Son utilisation nécessite d’être enregistré. Aucun contrôle d’accès n’est toutefois effectué. Le géoservice peut être intégré dans un SIG/une application via une URL avec les données de connexion, puis être utilisé sans restriction. Les offres à base de fichiers peuvent être téléchargées sur geodienste.ch , après la connexion. | |||
autorisation requise | L’accès à l’offre est protégé. Son utilisation requiert un enregistrement et une commande par l’utilisateur ainsi qu’une autorisation délivrée par le préparateur. Une fois celle-ci obtenue, le géoservice peut être intégré dans un SIG/une application via une URL avec les données de connexion, puis être utilisé sans restriction. En outre, les offres à base de fichiers peuvent être téléchargées sur geodienste.ch , après la connexion. | |||
Contrat requis? | indique si la conclusion d’un contrat est nécessaire pour s’abonner au géoservice. | |||
Frais | indique si des frais sont perçus, par exemple sur demande, gratuit, forfait mensuel de 150 francs, lien vers l’ordonnance cantonale sur les émoluments, etc. | |||
Conditions d’utilisation | choix entre «pas de conditions d’utilisation» ou les conditions d’utilisation cantonales (lien ou téléchargement de fichier) | |||
Conditions d’utilisation opendata.swiss | conditions d'utilisation selon opendata.swiss. La déclaration a pour effet que les conditions d'utilisation tendent à être harmonisées et que l'utilisation est simplifiée et plus claire pour les clients. Une publication des offres sur opendata.swiss par geodienste.ch n'a pas lieu.
|
Mise à jour
Note |
---|
La mise à jour ne doit être configurée que sur le système de production afin d'éviter toute charge inutile. Veuillez ne pas la configurer sur le système d'intégration. |
...
Si, dans le formulaire de commande d'une offre, l'utilisateur sélectionne un canton avec la catégorie d'accès « autorisation requise », celui-ci est invité à fournir en outre les informations suivantes :
Feld | Bemerkung |
---|---|
Période d‘utilisation | La durée minimale d’utilisation est d’un mois |
Commande passée par | Particulier, entreprise, Confédération ou en son nom, canton ou en son nom, commune ou en son nom, établissement de formation / de recherche. Cette indication peut se révéler utile pour le traitement rapide de la commande par le canton concerné. |
But de l’utilisation (en option) | Cette indication peut se révéler utile pour le traitement rapide de la commande par le canton concerné. |
BBOX | Il est par ailleurs possible d’indiquer une délimitation (BBOX) pour tous les formats hormis INTERLIS (par exemple pour les cantons dont les offres sont payantes). Pour la commune de Kriens, on pourrait envisager les valeurs suivantes en MN95: Ouest: 2658400.0, Sud: 1204000.0, Est: 2666200.0, Nord: 1211200.0. La taille de la BBOX peut également être ajustée ultérieurement par les préparateurs ou un délégué sous l'onglet "Contrôle d'accès". |
Les préparateurs sont automatiquement prévenus par courriel (transmis à l’adresse définie dans le profil sous «E-Mail admin [abréviation du canton]») en cas d’inscription ou de commande.
...
Il est possible de déléguer les droits de préparateur.
Droits
La délégation des droits à des utilisateurs enregistrés sur geodienste.ch est réalisée offre par offre, de manière séparée pour les processus d’intégration s'effectue séparément selon les processus d'intégration des données et de distribution, offre par offre, aux utilisateurs enregistrés sous geodienste.ch. Les droits suivants peuvent être délégués :
Délégation pour l’importation de l'upload de données : L'utilisateur délégué reçoit du canton uniquement le droit d'effectuer l'importation de données upload pour l'offre déterminée avec l'API conformément. La configuration de l'intégration doit donc avoir été définie au préalable par le préparateur pour que .
Les jeux de données livrés sont attribués à l'utilisateur délégué
Délégation pour publication de données: L'utilisateur délégué reçoit du canton uniquement le droit d'effectuer l'importation de données et la publication pour l'offre déterminée avec l'API conformément. La configuration de l'intégration doit donc avoir été définie au préalable par le préparateur pour que l'utilisateur délégué puisse utiliser l'API en conséquence. Les notifications automatiques concernant l'intégration des données sont envoyées au délégué au lieu d'être envoyées au préparateur.
- Délégation pour la distribution: L
, validés et stockés en interne.
Les uploads peuvent être lancés en parallèle par différents délégués par offre et par canton.
Avec l'API
uploaded_datasets
, les cantons peuvent consulter les datasets livrés (quels datasets ont été livrés par quel délégué et quand ?) et les obtenir sous forme de zip (par exemple pour un traitement ultérieur interne à l’ICDG).Les cantons peuvent importer et publier les datasets livrés directement sur geodienste.ch avec l'API
import_uploaded
.Les jeux de données livrés qui ne sont pas traités par le canton dans un délai d'un mois sont automatiquement supprimés.
Délégation de l'importation de données : l'utilisateur délégué reçoit du canton uniquement le droit d'exécuter le contrôle d'accès 'effectuer l'upload et l'importation de données pour l'offre déterminée avec l'API. Les notifications automatiques concernant les inscriptions sont envoyées au délégataire au lieu d'être envoyées au préparateur.
...
Les datasets livrés sont attribués à l'utilisateur délégué, validés et importés.
❗ Pour des raisons techniques, il n'est pas possible que plusieurs délégués importent simultanément des datasets pour un canton dans la même offre. ❗
Avec l'option
replace_all=true
, seuls les propres datasets du délégué ou ceux du canton sont supprimés ou remplacés, mais pas ceux des autres délégués.L'option
delete
permet de supprimer certains datasets. Seuls les propres datasets du délégué peuvent être supprimés.Les cantons ainsi que tous les délégués peuvent consulter les datasets importés avec l'API
imported_datasets
(quels datasets de quel utilisateur ont été importés et quand ?).
Délégation de publication : l'utilisateur délégué reçoit du canton le droit d'effectuer la publication pour l'offre déterminée avec l'API.
Les datasets importés sont publiés.
Délégation de la distribution : l'utilisateur délégué reçoit du canton le droit d'effectuer le contrôle d'accès pour l'offre déterminée.
Les droits d'accès pour les offres avec catégorie d'accès ("autorisation requise") peuvent être administrés.
Les notifications automatiques concernant les inscriptions sont envoyées au délégué au lieu d'être envoyées au fournisseur.
Principe de base
La configuration de l'intégration doit avoir été définie au préalable par le fournisseur afin que l'utilisateur délégué puisse utiliser l'API en conséquence.
Les délégués ne peuvent pas écraser les jeux de données d'autres délégués.
Les cantons ainsi que tous les délégués peuvent consulter les jeux de données importés avec l'API
imported_datasets
(quels jeux de données de quels utilisateurs ont été importés et quand ?)Les notifications automatiques concernant l'intégration des données sont envoyées au délégué au lieu d'être envoyées au canton/fournisseur.
Aperçu de l'API et des autorisations
voir https://geodienste.ch/api-docs/index.html
Les API pertinentes pour la mise à disposition des données sont les suivantes :
GET data_agg/delegations
: Consultation des autorisations actuelles
POST /data_agg/interlis/import
: Import, Delete ou seulement UploadGET /data_agg/import_tasks/uploaded_datasets
: liste des datasets de l'upload seulement, possibilité d'obtenir Uploaded.zipPOST /data_agg/import_tasks/import_uploaded
: Importation de jeux de données depuis UploadGET /data_agg/import_tasks/imported_datasets
: liste des datasets importésPOST /data_agg/interlis/publish
: publication
En outre, des points de terminaison sont disponibles pour la consultation des statuts et des logs.
Rôle / Droits |
| Importation | seulement Upload |
|
|
| Publication | Distribution |
---|---|---|---|---|---|---|---|---|
Préparateur/Canton | X | X | X | X | X | X | ||
délégué / | X | X | X | |||||
délégué / | X | X | X | |||||
délégué / | X | X | X | X | X | X | ||
délégué / | X | X | ||||||
Admin | X | X | X | X | X | X |
...
Change Management des offres
...
python3 rasterdata_import.py -t luftbild -p /path/to/rasterdata -e production --dry_run
À noter :
python3 rasterdata_import.py -t luftbild -p /path/to/rasterdata -e production
...
-e production
Note |
---|
À noter :
|
...
cadastre viticole (ID 151.1):
BE_151_1.zip
- BE_a_151_1.xtfsurfaces d’utilisation (y c. SPB du niveau de qualité I) (ID 153.1):
BE_153_1.zip
- BE_a_153_6.xtf
- BE_b_153_1.xtfpérimètre des vignobles en terrasses (ID 153.2):
BE_153_2.zip
- BE_a_153_2.xtfsurfaces de promotion de la biodiversité, niveau de qualité II et mises en réseau (ID 153.3):
BE_153_3.zip
- BE_a_153_6.xtf
- BE_b_153_1.xtf
- BE_c_153_3.xtfpérimètre SAU et de la surface d'estivage (ID153.5):
BE_153_5.zipBE_a_1
- BE_a_153_5.xtfL’unité d’exploitation (ID 153.6):
BE_153_6.zip
- BE_a_153_6.xtféléments relatifs à la qualité du paysage (ID 153.8):
BE_153_8.zip
- BE_a_153_8.xtf
Des informations supplémentaires sur la gestion agricole sont disponibles sous dans le https://www.kgkcgckgk-cgc.ch/frdownload_file/coordination/mgdm/processus-de-mise-en-oeuvre et dans le Guide concernant l’échange de géodonnées sur l’exploitation agricole 1055/0 .
Checklist
La checklist suivante peut être copiée et utilisée pour la mise en œuvre d'une offre.
| Nr | Prozess | Umgebung | Aufgabe |
---|---|---|---|---|
1 | Plan d’offre |
| ||
2.1 | Intégration initiale |
| ||
2.2 |
| |||
2.3 |
| |||
2.4 |
| |||
3.1 | Intégration initiale |
| ||
3.2 |
| |||
3.3 |
| |||
3.4 |
| |||
4.1 | Mise à jour |
| ||
4.2 |
| |||
5.1 | Distribution |
|