Skip to content

meteoblue Binding ​

The meteoblue binding uses the meteoblue weather service to provide weather information.

Supported Things ​

The binding has two Thing types.

The first Thing type is the weather Thing. Each weather Thing has the ID weather and retrieves weather data for one location. The second Thing type is the bridge Thing. The bridge Thing, which has the ID bridge, holds the API key to be used for all of its child Things.

Thing Configuration ​

Bridge Thing Configuration ​

PropertyDefault ValueRequired?Description
apiKeyYesThe api key to be used with the meteoblue service

Weather Thing Configuration ​

PropertyDefault ValueRequired?Description
locationYesThe latitude, longitude, and optionally altitude of the location, separated by commas (e.g. 45.6,45.7,45.8). Altitude, if given, should be in meters.
refresh240NoThe time between calls to refresh the weather data, in minutes
serviceTypeNonCommercialNoThe service type to be used. Either 'Commercial' or 'NonCommercial'
timeZoneNoThe time zone to use for the location. Optional, but the service recommends it be specified. The service gets the time zone from a database if not specified.

Channels ​

Channel Groups ​

Group NameDescription
forecastTodayToday's forecast
forecastTomorrowTomorrow's forecast
forecastDay2Forecast 2 days out
forecastDay3Forecast 3 days out
forecastDay4Forecast 4 days out
forecastDay5Forecast 5 days out
forecastDay6Forecast 6 days out

Channels ​

Each of the following channels is supported in all of the channel groups.

ChannelItem TypeDescription
heightNumber:LengthAltitude above sea-level of the location (in meters)
forecastDateDateTimeForecast date
UVIndexNumberUltraViolet radiation index at ground level (0-16)
minTemperatureNumber:TemperatureLow temperature
maxTemperatureNumber:TemperatureHigh temperature
meanTemperatureNumber:TemperatureMean temperature
feltTemperatureMinNumber:TemperatureLow "feels like" temperature
feltTemperatureMaxNumber:TemperatureHigh "feels like" temperature
relativeHumidityMinNumberLow relative humidity
relativeHumidityMaxNumberHigh relative humidity
relativeHumidityMeanNumberMean relative humidity
precipitationProbabilityNumberPercentage probability of precipitation
precipitationNumber:LengthTotal precipitation (water amount)
convectivePrecipitationNumber:LengthTotal rainfall (water amount)
rainSpotStringPrecipitation distribution around the location
rainAreaImageColor-coded image generated from rainSpot
snowFractionNumberPercentage of precipitation falling as snow
snowFallNumber:LengthTotal snowfall (calculated)
cardinalWindDirectionStringName of the wind direction (eg. N, S, E, W, etc.)
windDirectionNumberWind direction (in degrees)
minWindSpeedNumber:SpeedLow wind speed
maxWindSpeedNumber:SpeedHigh wind speed
meanWindSpeedNumber:SpeedMean wind speed
minSeaLevelPressureNumber:PressureLow sea level pressure
maxSeaLevelPressureNumber:PressureHigh sea level pressure
meanSeaLevelPressureNumber:PressureMean sea level pressure
conditionStringA brief description of the forecast weather condition (e.g. 'Overcast')
Valid values range from 1 - 17 (see the meteoblue docs)
iconImageImage used to represent the forecast (calculated)
see Image icons below
predictabilityNumberEstimated certainty of the forecast (percentage)
predictabilityClassNumberRange 0-5 (0=very low, 5=very high)
precipitationHoursNumberTotal hours of the day with precipitation
humidityGreater90HoursNumberTotal hours of the day with relative humidity greater than 90%

Image Icons ​

To show the weather image icons in the UI, the image files need to be downloaded and installed in the conf/icons/classic folder.

In the "Downloads" section at the bottom of the page, download the file named meteoblue_weather_pictograms_<date>.zip.

The files to extract from the zip file and install in the folder will be named "iday*.png" or "iday*.svg".

Full Example ​

demo.things:

dsl
Bridge meteoblue:bridge:metBridge "metBridge" [ apiKey="XXXXXXXXXXXX" ] {
 Thing weather A51 "Area 51" [ serviceType="NonCommercial", location="37.23,-115.5,1360", timeZone="America/Los_Angeles", refresh=240 ] {
 }
}

demo.items:

dsl
// ----------------- meteoblue GROUPS ------------------------------------------
Group weatherDay0 "Today's Weather"
Group weatherDay1 "Tomorrow's Weather"
Group weatherDay2 "Weather in 2 days"
Group weatherDay3 "Weather in 3 days"
Group weatherDay4 "Weather in 4 days"
Group weatherDay5 "Weather in 5 days"
Group weatherDay6 "Weather in 6 days"

// ----------------- meteoblue ITEMS -------------------------------------------
DateTime todayForecastDate  "Forecast for [%1$tY/%1$tm/%1$td]"  <calendar>  (weatherDay0)  {channel="meteoblue:weather:metBridge:A51:forecastToday#forecastDate"}
String todayPCode    "Pictocode [%d]"  <iday>  (weatherDay0)  {channel="meteoblue:weather:metBridge:A51:forecastToday#condition"}
String todayCond     "Condition [%s]"  <iday>  (weatherDay0)  {channel="meteoblue:weather:metBridge:A51:forecastToday#condition"}
Image todayIcon     "Icon [%s]"       (weatherDay0)  {channel="meteoblue:weather:metBridge:A51:forecastToday#icon"}
Number todayUV       "UV Index [%d]"  (weatherDay0)  {channel="meteoblue:weather:metBridge:A51:forecastToday#UVIndex"}
Number:Temperature  todayTempL  "Low Temp [%.2f °F]"   <temperature>  (weatherDay0)  {channel="meteoblue:weather:metBridge:A51:forecastToday#minTemperature"}
Number:Temperature  todayTempH  "High Temp [%.2f °F]"  <temperature>  (weatherDay0)  {channel="meteoblue:weather:metBridge:A51:forecastToday#maxTemperature"}
Number todayHumM     "Mean Humidity [%d %%]"  <humidity>  (weatherDay0)  {channel="meteoblue:weather:metBridge:A51:forecastToday#relativeHumidityMean"}
Number todayPrecPr   "Prec. Prob. [%d %%]"  (weatherDay0)  {channel="meteoblue:weather:metBridge:A51:forecastToday#precipitationProbability"}
Number:Length todayPrec     "Total Prec. [%.2f in]"  <rain>  (weatherDay0)  {channel="meteoblue:weather:metBridge:A51:forecastToday#precipitation"}
Number:Length todayRain     "Rainfall [%.2f in]"  <rain>  (weatherDay0)  {channel="meteoblue:weather:metBridge:A51:forecastToday#convectivePrecipitation"}
Image  todayRainArea "Rain area"   <rain>  (weatherDay0)  {channel="meteoblue:weather:metBridge:A51:forecastToday#rainArea"}
Number todaySnowF    "Snow fraction [%.2f]"  <climate>  (weatherDay0)  {channel="meteoblue:weather:metBridge:A51:forecastToday#snowFraction"}
Number:Length  todaySnow     "Snowfall [%.2f in]"  <rain>  (weatherDay0)  {channel="meteoblue:weather:metBridge:A51:forecastToday#snowFall"}
Number:Pressure  todayPressL   "Low Pressure [%d %unit%]"   <pressure>  (weatherDay0)  {channel="meteoblue:weather:metBridge:A51:forecastToday#minSeaLevelPressure"}
Number:Pressure  todayPressH   "High Pressure [%d %unit%]"  <pressure>  (weatherDay0)  {channel="meteoblue:weather:metBridge:A51:forecastToday#maxSeaLevelPressure"}
Number todayWindDir   "Wind Direction [%d]"  <wind>  (weatherDay0)  {channel="meteoblue:weather:metBridge:A51:forecastToday#windDirection"}
String todayCWindDir  "Cardinal Wind Direction [%s]"  <wind>  (weatherDay0)  {channel="meteoblue:weather:metBridge:A51:forecastToday#cardinalWindDirection"}
Number:Speed  todayWindSpL   "Low Wind Speed [%.2f mph]"   <wind>  (weatherDay0)  {channel="meteoblue:weather:metBridge:A51:forecastToday#minWindSpeed"}
Number:Speed  todayWindSpH   "High Wind Speed [%.2f mph]"  <wind>  (weatherDay0)  {channel="meteoblue:weather:metBridge:A51:forecastToday#maxWindSpeed"}

demo.sitemap:

dsl
sitemap weather label="Weather"
{
  Frame label="Weather" {
    Group item=weatherDay0
    Group item=weatherDay1
    Group item=weatherDay2
    Group item=weatherDay3
    Group item=weatherDay4
    Group item=weatherDay5
    Group item=weatherDay6
  }
}