API Data (données)

Rédigé par David - -
Paramètres d'appels de l'API data pour utiliser les données Géoportail93 au sein d'autres applications, sous forme de flux image ou vectoriel.

Ce webservice est compatible avec les protocoles WMS (Web Map Service) et WFS-T (Web Features Service Transactionnel).

URL d'appel :

http://geoportail93.fr/SERV/DATA/

Méthodes

  • GET : consultation de données
  • POST : envoie de données (nouvelles ou MAJ)
  • DELETE : effacement de données

Paramètres :

  • SERVICE=     (facultatif)

    Type de service invoqué, vectoriel (WFS) ou image (WMS)

    Valeurs : WFS | WMS
    Défaut : WMS
  • REQUEST= 
Valeurs : getMap | getFeatureInfo | getFeature | getCapabilities | getDistinctValues (hors norme OGC) | getMiniature 
 (hors norme OGC)
Défaut : getMap
  • LAYERS=         (requis)
  • LAYER=
  • TYPENAME=

    ID de la données à récupérer
    Valeurs : n° de catalogue dans Géoportail93 (cf. fiche de métadonnées de la données)
  • FORMAT=      (facultatif)

    Format de retour des données

    Valeurs : KML | CSV | JSON | GEOJSON | TABLEAU | GML | GPX
    Défaut : GEOJSON
  • COL=                         (facultatif)
  • PROPERTYNAME=

    Liste des attributs à récupérer. Si non précisé, toutes les colonnes sont récupérées.

    Valeurs : liste de champs (séparées par des ;) | ALL | *
    Défaut : ALL

    Exemple : COL=id;nom;telephone;ville&
  • BBOX=      (facultatif)

    Filtre géographique sur une emprise définie, en projection webmercator ESPG:3857

    Défaut : null (pas de filtre géographique)

    Exemple : BBOX=254548 6242051 289926 6277164&
  •           FILTER=    (facultatif)
  • CQL_FILTER=    (facultatif)

    Filtres à appliquer en syntaxe SQL

    Défaut : null (pas de filtre alphanumérique)

    Exemple : FILTER=id IN (45,126,45) AND termine IS FALSE&
  • GROUP=   (facultatif)

    Nom de la colonne sur laquelle effectuer une opération agrégation. Type d'agrégation des valeurs demandées (parametre COL=) : les valeurs numériques sont additionnées, les valeurs textes sont mises en tableau, les dates sont moyennées et les géométries sont fusionnées.

  •   ORDER=    (facultatif)
  • SORTBY=    (facultatif)

    Nom de la colonne à utiliser pour le tri des données.
    Pour préciser le sens du tri, ajouter :DESC ou :ASC à la suite du nom de la colonne. ASC indique un tri ascendant (alphabétique) et DESC un tri descendant (inversement alphabétique). Le tri est ascendant par défaut si le sens n'est pas précisé.
    Plusieurs nom de champs peuvent être indiqués pour faire un tri sur plusieurs colonnes. Séparer les nom des champs par des points virgules "col1;col2"

    Défaut : null (pas de tri, ordre des objets dans la base)

    Exemple 1 : ORDER=nom_etablissement&    
    Exemple 2 : ORDER=nom_etablissement:DESC;id:ASC&
                    
  • LIMIT=     (facultatif)

    Limite le nombre de résultats retournés. Par défaut, aucune limite, sinon, indiquez un nombre maximum de résultats.

    Defaut : ALL

  •  SRS=       (facultatif)
  • SRID=      (facultatif)
  •  CRS=       (facultatif)

    Projection EPSG des coordonnées renvoyées

    Défaut : 3857 (4326 pour les format KML et GPX)
  • MODE_GEO=     (facultatif  - hors norme OGC)

    Mode de rendu de la données retournées. Permet de transformer une couche de polygone en point (centroid décalé sur l'objet si centroid hors du polygone)

    Valeurs : POINT | LIGNE | POLYGONE

    Défaut : null (pas de transformation de la géométrie)

  • ALIAS=     (facultatif - hors norme OGC)
Permet de spécifier le mode de rendu des noms de champs : nom des champs bruts tels que dans la base, nom de champs aliasé tels que défini dans le catalogue ou nom de champ normalisé selon le grand type de donné représenté (ID, ADRESSE, TEL, ...).
Valeurs : 0 (champ brut) | 1 (alias) | 2 (type de champ)

Défaut : 0


  • MODE=     (facultatif - hors norme OGC)
Permet de choisir si le rendu des données sera en mode flux (MODE=1) ou en mode téléchargement (MODE=2).
          Valeurs : 1 (flux) | 2 (téléchargement)

          Défaut : 1


Exemples :


pour récupérer une liste CSV des sites Départementaux reliés au réseau trés haut débit (THD) :

http://geoportail93.fr/SERV/DATA/?LAYERS=1112&FORMAT=csv&SERVICE=wfs

pour récupérer une liste JSON des zone en travaux sur la voierie Départementale :

http://geoportail93.fr/SERV/DATA/?LAYERS=1296&FORMAT=json&SERVICE=wfs

 pour récupérer les nom et prénom des élus du Conseil Départemental :

http://geoportail93.fr/SERV/DATA/?LAYERS=1014&COL=nom;prenom&FORMAT=csv&SERVICE=wfs


Les commentaires sont fermés.