Services web (API)

ArcGIS Server

Les données diffusées par le SITG sont accessibles aussi par le biais de services web (API). Ces services web permettent, notamment :

  • la consultation des données du SITG à partir de logiciels GIS comme ArcGIS Pro ou QGIS ;
  • l’intégration des données dans des applications de tierce partie ;
  • l’extraction selon des critères de filtrage personnalisables.

Les services web exposés par le SITG sont propulsés par l’application « ArcGIS Server » d’ESRI. 
La section « SERVICES EN LIGNE » des fiches de métadonnées (par exemple https://ge.ch/sitg/fiche/0802) reporte, pour chaque jeu de données concerné, la référence (URL) vers la racine des services disponibles. Vous noterez qu’en plus du service de type « Esri ArcGIS Rest », le service « WMS » est également disponible. Ce dernier, conforme au standard de l’Open Geospatial Consortium (OGC), garantit une meilleure interopérabilité mais permet uniquement l’affichage cartographique et la récupération des attributs d’un seul enregistrement à la fois. Comme alternative à la découverte à partir des métadonnées, vous pouvez aussi découvrir l’entièreté des services disponibles depuis les pages suivantes :

En particulier :

Tous ces services supportent des capacités avancées de requêtage, notamment :

  • pour les données vectorielles, il est possible d’extraire un sous-ensemble d’enregistrements, selon des filtres sur les attributs et/ou sur la géométrie ;
  • pour les données raster, il est possible d’extraire des images recouvrant une certaine « boîte englobante », préciser la système de projection des images produites, etc.

Pour accéder à ces fonctionnalités, il faut d’abord aller à la page relative au jeu de données souhaité (par exemple https://ge.ch/sitgags1/rest/services/VECTOR/SITG_OPENDATA_01/MapServer/802), puis cliquer sur le bouton « Query », en bas de page à la droite de « Supported Operations ». Cela ouvrira le formulaire permettant de préciser une requête vis-à-vis du jeu de données « AGGLO - COMMUNES ET TERRITOIRES VOISINS », dont le nom technique est « AGGLO_COMMUNES » et l’identifiant unique 802. Toujours à titre d’exemple, l’utilisateur peut :

  • extraire toutes les communes de Haute-Savoie et renseignant « CANTON_DEPARTEMENT='Haute-Savoie' » comme valeur du champ « Where » ;
  • extraire toutes les communes en renseignant « 1=1 » comme valeur du même champ « Where » ;
  • extraire les communes de « Carouge » et « Lancy » en utilisant « COMMUNE='Carouge' OR COMMUNE='Lancy' » comme valeur du champ « Where » ;
  • n'extraire que le 10 premiers enregistrements en renseignant « 10 » comme valeur du champ « Result Record Count » ;
  • extraire un certain nombre d’enregistrements à partir de l'énième, en saisissant une valeur pour le champ « Result Offset » ;
  • préciser les attributs souhaités en sortie en renseignant une valeur pour le champ « Out Fields » (l'utilisation du symbole « * » comporte la restitution de tous les attributs disponibles) ;
  • préciser le système de projection souhaité pour les données en sortie, en précisant une valeur pour le champ « Output Spatial Reference » (e.g. « 4326 » pour obtenir des coordonnées GPS, c'est-à-dire selon le système de coordonnées WGS84) ;
  • choisir différents formats de sortie, en choisissant l'un des formats disponibles dans la liste déroulante relative au champ « Format ».

Pour accéder aux fonctionnalités d’extraction des données raster, il faut cliquer sur le bouton « Extract Map » se trouvant tout en bas à la droite de « Supported Operations » dans les pages relatives aux données raster (e.g. https://ge.ch/sitgags2/rest/services/RASTER/ORTHOPHOTOS_2021/MapServer).

Les formulaires présentés par l’application ArcGIS Server assistent l’utilisateur dans la composition des requêtes. Une fois la requête composée et lancée par le clic sur « Query (GET) » (données vectorielles) ou sur « Export Map Image (GET)», l’utilisateur peut copier-coller l’URL s’affichant dans la barre de navigation et rejouer (voire réajuster) la requête même en dehors du formulaire.

Pour toutes les questions dont la réponse ne serait pas incluse dans cette brève documentation, n’hésitez pas à nous contacter.
 

 

ArcGIS Online

Les données en consultation sont intégralement référencées sur la plateforme ArcGIS Online d'ESRI dans les groupes publics suivants :

 

Recommandations

Les modèles des données en libre accès peuvent évoluer occasionnellement en fonction des nouveaux besoins des gestionnaires de données et de l'évolution des bases légales. Tout changement sur un modèle de données est annoncé préalablement sur la page d'actualité sur les données, également accessible par flux RSS. Il est de la responsabilité des utilisateurs de s'informer des changements sur les données et d'anticiper les impacts éventuels sur leur développement.

Afin que le SITG puisse adapter ses services et ses niveaux de service en fonction des besoins des utilisateurs, nous vous recommandons de nous informer de vos réalisations à l'aide du formulaire d'annonce. Si vous le choisissez, vos réalisations pourront également être référencées sur le futur portail du SITG des applications open data. Ce portail sera constitué prochainement en fonction de vos réalisations !

 

Conditions d'utilisation

L'utilisation des services web implique l'acceptation des conditions générales de ce site.