This page is part of archived documentation for openHAB 3.3. Go to the current stable version
# VigiCrues Binding
This binding allows you to get data regarding water flow and water height on major French rivers. These data are made public through OpenDataSoft website.
# Supported Things
There is exactly one supported thing type, which represents a river level measurement station.
It is identified by the id.
To get your station id :
Select your region on the France map
Select the station nearest to your location
In the 'Info Station' tab you'll get the id just near the station name (e.g. X9999999299)
Of course, you can add multiple Things, e.g. for getting measures for different locations.
# Discovery
You can discover stations based upon the system location. Select Vigicrues binding and click scan in order to discover new stations. The first scan will proceed with stations located in a radius of 10 km. This radius will increase by 10 km at each new scan.
# Binding Configuration
The binding has no configuration options, all configuration is done at Thing level.
# Thing Configuration
The thing has a few configuration parameters:
| Parameter | Description |
|---|---|
| id | Id of the station. |
| refresh | Refresh interval in minutes. Optional, the default value is 30 minutes. |
# Channels
Once created, at first initialization, the thing will discover its capabilities (available data) using the webservices apis. Channels will be presented depending upon actual available data.
The VigiCrues information that retrieved are made available with these channels:
| Channel ID | Item Type | Description |
|---|---|---|
| observation-time | DateTime | Date and time of measurement |
| flow | Number:VolumetricFlowRate | Volume of water per time unit |
| height | Number:Length | Water height of the river |
| relative-height | Number:Dimensionless | Current water level toward lowest historical flood |
| relative-flow | Number:Dimensionless | Current water flow tower lowest historical flood |
| alert (*) | Number | Flooding alert level of the portion related to the station |
| alert-icon | Image | Pictogram associated to the alert level |
| short-comment | String | Description of the alert level |
| comment | String | Detailed informations regarding the ongoing event |
(*) Each alert level is described by a color :
| Code | Color | Description |
|---|---|---|
| 0 | Green | No particular vigilance |
| 1 | Yellow | Be attentive to the flooding situation |
| 2 | Orange | Be "very vigilant" in the concerned areas |
| 3 | Red | Absolute vigilance required |
# Full Example
vigicrues.things:
Thing vigicrues:station:poissy "Station Poissy" @ "VigiCrues" [id="H300000201", refresh=30]
Thing vigicrues:station:vernon "Station Vernon" @ "VigiCrues" [id="H320000104", refresh=30]
vigicrues.items:
Group gVigiCrues "VigiCrues" <flow>
Number:Length VC_hauteur "Hauteur Eau Poissy [%.2f %unit%]" <none> (gVigiCrues) {channel="vigicrues:station:poissy:height"}
Number:VolumetricFlowRate VC_debit "Débit Eau Poissy [%.2f %unit%]" <flow> (gVigiCrues) {channel="vigicrues:station:poissy:flow"}
DateTime VC_ObservationPTS "Timestamp [%1$tH:%1$tM]" <time> (gVigiCrues) {channel="vigicrues:station:poissy:observation-time" }
vigicrues.sitemap:
sitemap vigicrues label="VigiCrues" {
Frame {
Default item=VC_hauteur
Default item=VC_debit
Default item=VC_ObservationPTS
}
}