pyVigicrues, un module python pour collecter les data des cours d’eau en France

Voici mon premier package en Python. Quelque chose de simple, mais qui s’étoffera avec le temps.

https://github.com/Mickaelh51/pyVigicrues

Ce module permet de collecter les data de hauteur et le débit de l’eau sur la grande majorité des cours d’eau français. Il faudra l’identifiant de la station pour le lancer.

Retrouver l’identifiant de votre station:

• Rendez-vous sur https://www.vigicrues.gouv.fr/

• Sélectionnez votre région sur la carte de France:

• Cliquez sur une des stations (la plus proche de chez vous):

Installer le module:

Avec PIP

pip install pyvigicrue

Avec les sources

cd /path/to/pyvigicrues/
python setup.py install

Utiliser le module:

pyvigicrues -s <STATIONID> -t <TYPE OF DATA>

Exemple pour obtenir le niveau de l’eau (en mètre):

 pyvigicrues -s L621000201 -t H

Résultats:

{
"VersionFlux": "Beta 0.4b",
"Serie": {
"CdStationHydro": "L621000201",
"Link": "https://www.vigicrues.gouv.fr/services/station.json?CdStationHydro=L621000201",
"GrdSerie": "H",
"LbStationHydro": "Grand Pressigny",
"ObssHydro": [
{
"DtObsHydro": 1545293400000,
"ResObsHydro": 0.23
},
{
"DtObsHydro": 1545296400000,
"ResObsHydro": 0.23
},
...

• DtObsHydro: La date du relevé, attention le format est erroné, il faut enlever les 3 derniers zéros pour avoir une date au format unixtime:
  • 1545293400000 –> 1545293400 –> 20/12/2018 à 09:10:00
• ResObsHydro: le niveau en mètre (par rapport au niveau « normal »), ici 0.23m au dessus du niveau normal.

Exemple pour obtenir les débits (m³/s)

pyvigicrues -s L621000201 -t Q

Résultats:

{
"VersionFlux": "Beta 0.4b",
"Serie": {
"CdStationHydro": "L621000201",
"LbStationHydro": "Grand Pressigny",
"Link": "https://www.vigicrues.gouv.fr/services/station.json?CdStationHydro=L621000201",
"ObssHydro": [
{
"ResObsHydro": 1.62,
"DtObsHydro": 1545293400000
},
...
    ],
    "GrdSerie": "Q"
  }
}

• ResObsHydro: le débit en m³/s

Prochaines étapes:

• Utiliser dans un module Home Assistant
• Améliorer le script pour corriger le format de la date