.. _exemples:
Exemples et extraits de code
==============================
WMS avec OpenLayers
-------------------
Cet exemple montre l'utilisation du service WFS avec les bornes vélo'v en temps réel à travers la bibliothèque OpenLayers.
.. image:: _static/openlayers.png
Code source correspondant :
.. code-block:: html
Utilisation des services GrandLyon Data : OpenLayers
WFS avec Leaflet
----------------
Cet exemple montre l'utilisation du service WFS avec les bornes vélo'v en temps réel à travers la bibliothèque LeafLet.
.. image:: _static/leaflet.png
Code source correspondant :
.. code-block:: html
Utilisation des services GrandLyon Data : Leaflet
KML avec l'API Maps de Google
------------------------------------
Cet exemple montre l'utilisation du service KML avec les bornes vélo'v à travers l'API Google Maps v3. Nécessite une clé pour l'API.
.. image:: _static/google.png
Code source correspondant :
.. code-block:: html
Utilisation des services GrandLyon Data : Google API
Utilisation du WCS
-------------------
Cet exemple montre l'utilisation du service WCS pour obtenir les données brutes sur le NO2 en 2012.
Nous utiliserons dans ces exemples la version 2.0.1 qui est la plus récente. Il est encore possible d'utiliser aussi les versions 1.1.1 ou 1.0.0.
**Etape 1** : lecture des capacités du service
https://data.grandlyon.com/wcs/rdata?SERVICE=WCS&REQUEST=GetCapabilities&VERSION=2.0.1
.. image:: _static/wcs_GetCapabilities.png
Parmi les informations retournées, on peut consulter les formats de sortie disponibles. Le WCS est un service destiné à fournir de la donnée brute (raw data). Il est donc recommandé de l'utiliser avec un format comme **image/x-aaigrid** pour un raster monobande ou **image/tiff** pour un raster multibandes, plutôt qu'avec un des formats de sortie prévus pour la visualisation, comme **image/jpeg** ou **image/gif**.
Dans la dernière partie du XML renvoyé, on trouve la liste des couvertures disponibles pour ce service, dont la couverture **grandlyon:STFONS_Step_02cm_2018**, que nous utiliserons dans la suite de l'exemple.
**Etape 2** : détail d'une couverture
https://data.grandlyon.com/geoserver/wcs?SERVICE=WCS&REQUEST=DescribeCoverage&VERSION=2.0.1&COVERAGEID=grandlyon:STFONS_Step_02cm_2018
Attention, en version 2.0.1, le paramètre pour indiquer la couverture demandée est **COVERAGEID**, mais en version 1.0 c'est **IDENTIFIER** et en version 1.1, c'est **COVERAGE**.
Attention également à la casse dans le nom de la couverture demandée si vous testez manuellement les requêtes : le service WCS y est sensible. Ainsi la couverture *grandlyon:sTFONS_Step_02cm_2018* (avec un s minuscule ) ne sera pas trouvée.
.. image:: _static/wcs_DescribeCoverage.png
Cette requête permet d'obtenir tous les détails de la couverture comme son étendue géographique ou des informations sur les bandes. On voit ainsi dans notre cas qu'il s'agit d'images multi-canaux à 3 bandes.
**Etape 3** : obtention de la couverture
La requête suivante permet d'obtenir le raster au format TIFF :
https://data.grandlyon.com/geoserver/wcs?SERVICE=WCS&VERSION=2.0.1&REQUEST=GetCoverage&FORMAT=image/tiff&COVERAGEID=grandlyon:STFONS_Step_02cm_2018
Utilisation du service CSW
--------------------------
Cet exemple montre l'utilisation du service CSW pour obtenir des informations sur les métadonnées.
**Etape 1** : lecture des capacités du service
https://data.grandlyon.com/geonetwork/srv/fre/csw?version=2.0.2&request=GetCapabilities&service=CSW
Exemple de présentation du XML reçu (plugin CSW dans QGIS) :
.. image:: _static/csw_getCapabilities.png
**Etape 2** : recherche sur des mots clés (Réseaux de transport)
Requête POST : https://data.grandlyon.com/geonetwork/srv/fre/csw
avec dans le data du POST :
.. code-block:: xml
full
csw:AnyText
Réseaux de transport
Extrait du XML obtenu en retour :
.. code-block:: xml
Alertes accessibilité du réseau TCL
256900994
Réseaux de transport
Services d'utilité publique et services publics
Les alertes accessibilité recensent les ascenseurs et escaliers mécaniques actuellement indisponibles dans les stations de métro et de tramway équipées du réseau TCL.
SYTRAL
nonGeographicDataset
application/json
text/csv
csv (taille : 2 Ko)
Données provenant de la base géographique et topologique TCL SYTRAL.
fre
https://download.data.grandlyon.com/ws/rdata/tcl_sytral.tclalerteaccessibilite/all.json
https://download.data.grandlyon.com/files/rdata/tcl_sytral.tclalerteaccessibilite/alerte_accessibilite.csv
https://download.data.grandlyon.com/files/grandlyon/LicenceEngagee.pdf
North 45.917, South 45.55, East 5.067, West 4.681. GRAND LYON
Licence Engagée
Pas de restriction d'accès public selon INSPIRE
2014-12-04
2015-02-02
16a9a657-e938-484e-a067-5cdacd7a0419
Free access with registration
continuous
2015-11-06T00:02:26
4721ec9e-86c8-4687-8713-f406290949ad
45.55 4.681
45.917 5.067
58f93af3-a651-4cbd-bd9d-b4562f8d404d
2015-11-06T00:04:55
Lignes de métro et funiculaire du réseau TCL
dataset
Réseaux de transport
Services d'utilité publique et services publics
transportation
La représentation graphique des lignes de métro et de funiculaire du réseau TCL est un objet linéaire qui localise la ligne et son parcours de terminus à terminus.
La représentation graphique des lignes est caractérisée par des informations de gestion (identifiant, numéro de ligne et sens, libellé, unité de transport, couleur du tracé, famille de transport) et de tracés (polylignes de terminus à terminus).
La représentation graphique des lignes de métro et de funiculaire du réseau TCL est un objet linéaire qui localise la ligne et son parcours de terminus à terminus.
La représentation graphique des lignes est caractérisée par des informations de gestion (identifiant, numéro de ligne et sens, libellé, unité de transport, couleur du tracé, famille de transport) et de tracés (polylignes de terminus à terminus).
license
fre
Données provenant de la base géographique et topologique TCL SYTRAL.
16a9a657-e938-484e-a067-5cdacd7a0419
5.1410943067093 45.486705557736
4.629545313738 45.945335689366
jdbc:postgresql://postgis_tr:5432/grandlyon:$gl69@rdata
https://download.data.grandlyon.com/wms/rdata
https://download.data.grandlyon.com/wfs/rdata
https://download.data.grandlyon.com/ws/rdata/tcl_sytral.tcllignemf/all.json
https://download.data.grandlyon.com/files/grandlyon/LicenceOuverte.pdf
https://download.data.grandlyon.com/catalogue/srv/fre/resources.get?uuid=58f93af3-a651-4cbd-bd9d-b4562f8d404d&fname=funimetrotrac_s.png
https://download.data.grandlyon.com/catalogue/srv/fre/resources.get?uuid=58f93af3-a651-4cbd-bd9d-b4562f8d404d&fname=funimetrotrac.png
...
Exemple de présentation du résultat (plugin CSW dans QGIS) :
.. image:: _static/csw_getRecords1.png
**Etape 3** : recherche sur des mots clés (Transport, Bus) et une zone géographique
Requête POST : https://data.grandlyon.com/geonetwork/srv/fre/csw
avec dans le data du POST :
.. code-block:: xml
full
ows:BoundingBox
4.7027853 45.597999
4.7191596 45.609031
csw:AnyText
Transport, Bus
Exemple de présentation du résultat (plugin CSW dans QGIS) :
.. image:: _static/csw_getRecords2.png
**Etape 4** : chargement d'une metadata précise par son ID parmi les résultats obtenus
https://data.grandlyon.com/geonetwork/srv/fre/csw?outputFormat=application%2Fxml&service=CSW&outputSchema=http%3A%2F%2Fwww.opengis.net%2Fcat%2Fcsw%2F2.0.2&request=GetRecordById&version=2.0.2&elementsetname=full&id=f5b0fe8e-f9cf-4f3c-8684-6b55d6935f6f
XML obtenu en retour :
.. code-block:: xml
f5b0fe8e-f9cf-4f3c-8684-6b55d6935f6f
2015-11-06T00:06:17
Aménagement cyclable
dataset
Réseaux de transport
transportation
planningCadastre
L'aménagement cyclable est un objet linéaire décrivant une infrastructure dédiée à la circulation des vélos (piste cyclable, bande cyclable, couloir bus ouverte aux vélos, double-sens cyclable, voie verte, mixité en zone de circulation apaisée). Il est caractérisé par des informations de gestion (nom, description, type d'aménagement, année de réalisation ...)
L'aménagement cyclable est un objet linéaire décrivant une infrastructure dédiée à la circulation des vélos (piste cyclable, bande cyclable, couloir bus ouverte aux vélos, double-sens cyclable, voie verte, mixité en zone de circulation apaisée). Il est caractérisé par des informations de gestion (nom, description, type d'aménagement, année de réalisation ...)
license
fre
Mise à jour en continu : remontée d'informations travaux des services du Grand Lyon et des partenaires et vérification de la donnée sur le terrain.
5.067 45.55
4.681 45.917
https://download.data.grandlyon.com/wms/grandlyon
https://download.data.grandlyon.com/wfs/grandlyon
https://download.data.grandlyon.com/ws/grandlyon/pvo_patrimoine_voirie.pvoamenagementcyclable/all.json
https://download.data.grandlyon.com/files/grandlyon/LicenceOuverte.pdf
https://download.data.grandlyon.com/catalogue/srv/fre/resources.get?uuid=f5b0fe8e-f9cf-4f3c-8684-6b55d6935f6f&fname=DV_AC_s.png
https://download.data.grandlyon.com/catalogue/srv/fre/resources.get?uuid=f5b0fe8e-f9cf-4f3c-8684-6b55d6935f6f&fname=DV_AC.png
Exemple de présentation du résultat (plugin CSW dans QGIS) :
.. image:: _static/csw_getRecordByID.png