Utilisation de l'API CIGALE - airpaca/CIGALE GitHub Wiki

Cette page décrit différentes méthodes pour accéder aux données attributaires et géographiques proposées dans CIGALE.

Ces méthodes étant en cours de développement, aucune continuité de service n'est assurée et les URL présentées sont susceptibles d'évoluer.

Pour utiliser l'API, il est nécessaire de remplacer les symboles "[***]" par la ou les bonnes variables, séparées par une virgule le cas échéant.

Flux cartographiques WFS

Les requêtes ci-dessous décrivent comment récupérer les flux WFS format geojson des couches géographiques présentées dans l'application. Il est également possible de les récupérer directement dans un logiciel SIG desktop en WFS à partir de l'url du serveur http://geoservices.atmosud.org/geoserver/cigale/ows.

GetCapabilities:

http://geoservices.atmosud.org/geoserver/cigale/ows?service=wfs&version=2.0.0&request=GetCapabilities

Récupération du flux WFS à l'EPCI par polluant pour la dernière année d'inventaire disponible (geojson)

[polluant]: conso, prod, so2, nox, pm10, pm2.5, covnm, nh3, co, co2, ch4.co2e, n2o.co2e, prg100.3ges

http://geoservices.atmosud.org/geoserver/cigale/ows?service=wfs&version=2.0.0&REQUEST=GetFeature&TYPENAME=cigale:epci_poll&outputformat=application/json&CQL_FILTER=nom_abrege_polluant='[polluant]'

Récupération du flux WFS de données communales pour un EPCI et un polluant, dernière année d'inventaire (geojson)

[epci]: Code SIREN attribué par l'INSEE à l'EPCI. Ex: 200054807

http://geoservices.atmosud.org/geoserver/cigale/ows?service=wfs&version=2.0.0&REQUEST=GetFeature&TYPENAME=cigale:comm_poll&CQL_FILTER=nom_abrege_polluant='[polluant]'+AND+siren_epci='[epci]'&outputformat=application/json

API d'extraction des données communales au format JSON

Pour récupérer les données détaillées présentées dans la partie extraction, faire une demande d'accès au serveur à [email protected] puis utiliser les requêtes ci-dessous

http://[serveur]/cigale/scripts/tableau.php?query_ans=[Années]&query_entite=[Code_Insee_Commune]&query_sect=[SECTEN/Grandes_Filières]&query_ener=[Catégories_energétiques/Détail_Filières]&query_var=[id_Variable]&query_detail_comm=false

[Années]: Une ou plusieurs années séparées par une virgule. Les années disponibles sont 2007, 2010, 2012, 2013, 2014, 2015.

[Code_Insee_Commune]: Code INSEE de la commune (ex: 04049).

[id_Variable]: Identifiant d'une ou plusieurs variables à extraire, séparées par une virgule.

  • conso: 131
  • prod: 999
  • so2: 48
  • nox: 38
  • pm10: 65
  • pm2.5: 108
  • covnm: 16
  • nh3: 36
  • co: 11
  • co2: 15
  • ch4.co2e: 123
  • n2o.co2e: 124
  • prg100.3ges: 128

[SECTEN/Grandes_Filières]:

Pour les consommations et émissions de polluants et GES: Identifiant du ou des secteurs d'activités séparés par une virgule. Tous secteurs confondus si aucune valeur. Attention, format texte, bien laisser les guillemets.

  • '1' - Extraction, transformation et distribution d'énergie
  • '2' - Industrie manufacturière, traitement des déchets, construction
  • '3' - Résidentiel
  • '4' - Tertiaire, commercial et institutionnel
  • '5' - Agriculture, sylviculture et aquaculture hors UTCF
  • '6' - Transport routier
  • '7' - Modes de transports autres que routier
  • '8' - Emetteurs non inclus

Pour les productions d'énergie: Grandes filières de production d'énergie séparées par une virgule. Toutes confondues si aucune valeur.

  • 1 - ENR
  • 2 - Incinération
  • 3 - Thermique fossile
  • 4 - Cogénération

[Catégories_energétiques/Détail_Filières]:

Pour les consommations et émissions de polluants et GES: Identifiant de la ou des catégories d'énergie séparés par une virgule. Toutes catégories confondues si aucune valeur.

  • 0 - Aucune énergie
  • 1 - Gaz Naturel
  • 2 - Produits pétroliers
  • 3 - Combustibles Minéraux Solides (CMS)
  • 4 - Bois-énergie (EnR)
  • 5 - Autres énergies renouvelables (EnR)
  • 6 - Chaleur et froid issus de réseau (émissions indirectes)
  • 7 - Autres non renouvelables
  • 8 - Électricité (émissions indirectes)

Pour les productions d'énergie: Détail des filières de production d'énergie séparées par une virgule. Toutes confondues si aucune valeur.

  • 1 - Biogaz
  • 2 - Biomasse
  • 3 - Centrales thermiques
  • 4 - Cogénération
  • 5 - Eolien
  • 6 - Grande hydraulique
  • 7 - Incinération des déchets industriels
  • 8 - Incinération des ordures ménagères
  • 9 - Petite hydraulique
  • 10 - Pompes à chaleur
  • 11 - Réseaux de chaleur
  • 12 - Solaire photovoltaïque
  • 13 - Solaire thermique
  • 14 - Thermique fossile autre

Exemple d'extraction des consommations d'énergie du secteur résidentiel pour une commune et deux années:

http://[serveur]/cigale/scripts/tableau.php?query_ans=2012,2015&query_entite=4049&query_sect='3'&query_ener=&query_var=38&query_detail_comm=false

Exemple d'extraction des productions d'énergie par grande filière pour une commune et deux années:

http://[serveur]/cigale/scripts/tableau.php?query_ans=2012,2015&query_entite=4049&query_sect=1,2,3,4&query_ener=&query_var=999&query_detail_comm=false