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:

screenshot-www.vigicrues.gouv.fr-2019.01.02-09-56-22

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

screenshot-www.vigicrues.gouv.fr-2019.01.02-09-58-19

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

screenshot-www.vigicrues.gouv.fr-2019.01.02-09-59-42(1)

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

2 Commentaires

  1. A noter qu’il est possible de chercher des infos sur les stations et les observations via les données récemment mises en Open Data sur http://hubeau.eaufrance.fr/page/api-hydrometrie

    1. Merci beaucoup pour l’info !

Répondre à Quentin DELANCE Annuler la réponse.

Entrez vos coordonnées ci-dessous ou cliquez sur une icône pour vous connecter:

Logo WordPress.com

Vous commentez à l'aide de votre compte WordPress.com. Déconnexion /  Changer )

Photo Google

Vous commentez à l'aide de votre compte Google. Déconnexion /  Changer )

Image Twitter

Vous commentez à l'aide de votre compte Twitter. Déconnexion /  Changer )

Photo Facebook

Vous commentez à l'aide de votre compte Facebook. Déconnexion /  Changer )

Connexion à %s

%d blogueurs aiment cette page :