Announcing OpenWeatherMap binding for Eclipse SmartHome / openHAB

Tags: #<Tag:0x00007f1e4ed261d0> #<Tag:0x00007f1e4ed26068>
(Christoph Weitkamp) #1

A new weather binding for ESH / OH2 is in the pipe. You can add it to your system via the Eclipse IoT Marketplace or manually. Requires OH2 2.3+ (see post 116).

The binding supports current weather, 5 day / 3 hour forecast (currently for 24h) and 16 day / daily forecast (currently for 5 days / paid accounts).

Have a look at the documentation finalized documentation.

I need a lot of volunteers for testing. Any kind of feedback will be very much appreciated.


[SOLVED] Can't retrieve OpenWeatherMap data. Invalid API key
Weather binding with OpenWeatherMap API
Weather API's
OpenWeatherMap Extension - Support for UV Index API
[SOLVED] Netatmo Binding refactoring
Weather + Rules + Adding Snapshot
Dark Sky - Yawb4oH2 (Yet another weather binding for openHAB 2)
Weather OpenWeatherMap
Weather Underground widget with forecast
Weather Widget - Side, Top and Block
Weather Binding: Invalid API key
Which weather binding to use
[Bounty] Custom Widget for OWM
[SOLVED] OpenWeatherMap Binding
OpenWeatherMap PaperUI minimum and maximum temperatures
[SOLVED] Weather binding with OH2 - does it work?
Which weather binding to use
Weather binding with OpenWeatherMap API
Wunderground question
(Christoph Weitkamp) #2

Tips & Tricks


  • [ ] Add configuration for cityId instead of geographic coordinates
  • [x] Add UV Index API
  • [x] Store / cache icon file in a local folder
  • [x] Add channel for gust-speed
  • [x] Add configuration for number of forecasted hours / days
  • [x] Refactor polling job strategy
    • Deactivate polling job if no thing is configured
    • Activate polling job if first thing has been added
    • Refresh immediately if a new thing has been added

New features

Scale transformation for wind speed expressed in Beaufort scala

Scale transformation for wind direction


(Vincent Regaud) #3

Hi Christoph,
Looks good,
Could you change the items examples to English, please?
I’ll do some testing over the week-end


(Jürgen Baginski) #4


Are you sure about the two text-parts for different forecasts in your post? (your first string/link:

correponds with the data from OWM, the second however:

is named “16 days/daily forecast” by OWM)


(Sergi Suarez) #5

Looks great. I will take a look and see how it works. Thanks for the work.


(Christoph Weitkamp) #6

@vzorglub Yes, of course. The documentation status is in progress. I guess I have to add a lot more information to it.

@opus Thanks for reading carefully. I have changed the description of the second link in my initial post.


(Danny mullen) #7

@vzorglub can you let me know if you get something setup? This might work for me also. Love to see an example in english


(Vincent Regaud) #8

I had signed up for openWeathermap a long time ago and forgot about it.
I logged in and my api key was there.

Installed the binding from the market place
Bridge thing appeared and I put the API key - Online straight away
2 more things appear - Local weather and 3 hour forecast
I createad an item in PAperUI for the current temperature and I have a value
I will compare with the current weather provider I am using (DarkSky) I don’t think their current weather is vary good but I like their forecasts so I may end up using openweathermap binding for the current conditions and darksky for the forecasts only.

1 Like

(Christoph Weitkamp) #9

@vzorglub @Thedannymullen a preview for the English examples:


DateTime owmLastMeasurement "Timestamp of last measurement [%1$tY-%1$tm-%1$tdT%1$tH:%1$tM:%1$tS]" <time> { channel="openweathermap:weather:api:local:current#time-stamp" }
String owmCurrentCondition "Current condition [%s]" <sun_clouds> { channel="openweathermap:weather:api:local:current#condition" }
Number:Temperature owmCurrentTemperature "Current temperature [%.1f %unit%]" <temperature> { channel="openweathermap:weather:api:local:current#temperature" }
Number:Temperature owmCurrentMinTemperature "Minimum temperature of today [%.1f %unit%]" <temperature> { channel="openweathermap:daily-openweathermap:weather:api:local:current#min-temperature" }
Number:Temperature owmCurrentMaxTemperature "Maximum temperature of today [%.1f %unit%]" <temperature> { channel="openweathermap:daily-openweathermap:weather:api:local:current#max-temperature" }
Number:Pressure owmCurrentPressure "Current barometric pressure [%.1f %unit%]" <pressure> { channel="openweathermap:weather:api:local:current#pressure" }
Number:Dimensionless owmCurrentHumidity "Current atmospheric humidity [%d %unit%]" <humidity> { channel="openweathermap:weather:api:local:current#humidity" }
Number:Speed owmCurrentWindSpeed "Current wind speed [%.1f km/h]" <wind> { channel="openweathermap:weather:api:local:current#wind-speed" }
Number:Angle owmCurrentWindDirection "Current wind direction [%d %unit%]" <wind> { channel="openweathermap:weather:api:local:current#wind-direction" }
Number:Dimensionless owmCurrentCloudiness "Current cloudiness [%d %unit%]" <clouds> { channel="openweathermap:weather:api:local:current#cloudiness" }
Number:Length owmCurrentRainVolume "Current rain volume [%.1f %unit%]" <rain> { channel="openweathermap:weather:api:local:current#rain" }
Number:Length owmCurrentSnowVolume "Current rain volume [%.1f %unit%]" <snow> { channel="openweathermap:weather:api:local:current#snow" }

DateTime owmForecastTodayTimestamp "Timestamp of forecast [%1$tY-%1$tm-%1$tdT%1$tH:%1$tM:%1$tS]" <time> { channel="openweathermap:daily-forecast:api:local:forecastToday#time-stamp" }
String owmForecastTodayCondition "Condition for today [%s]" <sun_clouds> { channel="openweathermap:daily-forecast:api:local:forecastToday#condition" }
Number:Temperature owmForecastTodayMinTemperature "Minimum temperature for today [%.1f %unit%]" <temperature> { channel="openweathermap:daily-forecast:api:local:forecastToday#min-temperature" }
Number:Temperature owmForecastTodayMaxTemperature "Maximum temperature for today [%.1f %unit%]" <temperature> { channel="openweathermap:daily-forecast:api:local:forecastToday#max-temperature" }
Number:Pressure owmForecastTodayPressure "Barometric pressure for today [%.1f %unit%]" <pressure> { channel="openweathermap:daily-forecast:api:local:forecastToday#pressure" }
Number:Dimensionless owmForecastTodayHumidity "Atmospheric humidity for today [%d %unit%]" <humidity> { channel="openweathermap:daily-forecast:api:local:forecastToday#humidity" }
Number:Speed owmForecastTodayWindSpeed "Wind speed for today [%.1f km/h]" <wind> { channel="openweathermap:daily-forecast:api:local:forecastToday#wind-speed" }
Number:Angle owmForecastTodayWindDirection "Wind direction for today [%d %unit%]" <wind> { channel="openweathermap:daily-forecast:api:local:forecastToday#wind-direction" }
Number:Dimensionless owmForecastTodaytCloudiness "Cloudiness for today [%d %unit%]" <clouds> { channel="openweathermap:daily-forecast:api:local:forecastToday#cloudiness" }
Number:Length owmForecastTodayRainVolume "Rain volume for today [%.1f %unit%]" <rain> { channel="openweathermap:daily-forecast:api:local:forecastToday#rain" }
Number:Length owmForecastTodaySnowVolume "Snow volume for today [%.1f %unit%]" <snow> { channel="openweathermap:daily-forecast:api:local:forecastToday#snow" }

String owmForecastTomorrowCondition "Condition for tomorrow [%s]" <sun_clouds> { channel="openweathermap:daily-forecast:api:local:forecastTomorrow#condition" }
Number:Temperature owmForecastTomorrowMinTemperature "Minimum temperature for tomorrow [%.1f %unit%]" <temperature> { channel="openweathermap:daily-forecast:api:local:forecastTomorrow#min-temperature" }
Number:Temperature owmForecastTomorrowMaxTemperature "Maximum temperature for tomorrow [%.1f %unit%]" <temperature> { channel="openweathermap:daily-forecast:api:local:forecastTomorrow#max-temperature" }

String owmForecastDay2Condition "Condition in 2 days [%s]" <sun_clouds> { channel="openweathermap:daily-forecast:api:local:forecastDay2#condition" }
Number:Temperature owmForecastDay2MinTemperature "Minimum temperature in 2 days [%.1f %unit%]" <temperature> { channel="openweathermap:daily-forecast:api:local:forecastDay2#min-temperature" }
Number:Temperature owmForecastDay2MaxTemperature "Maximum temperature in 2 days [%.1f %unit%]" <temperature> { channel="openweathermap:daily-forecast:api:local:forecastDay2#max-temperature" }

String owmCurrentConditionMiami "Current condition in Miami [%s]" <sun_clouds> { channel="openweathermap:weather:api:miami:current#condition" }
Number:Temperature owmCurrentTemperatureMiami "Current temperature in Miami [%.1f %unit%]" <temperature> { channel="openweathermap:weather:api:miami:current#temperature" }


sitemap demo label="OpenWeatherMap" {
    Frame label="Local weather" {
        Text item=owmLastMeasurement
        Text item=owmCurrentCondition
        Text item=owmCurrentTemperature
        Text item=owmCurrentMinTemperature
        Text item=owmCurrentMaxTemperature
        Text item=owmCurrentPressure
        Text item=owmCurrentHumidity
        Text item=owmCurrentWindSpeed
        Text item=owmCurrentWindDirection
        Text item=owmCurrentCloudiness
        Text item=owmCurrentRainVolume
        Text item=owmCurrentSnowVolume
    Frame label="Forecast for today" {
        Text item=owmForecastTodayTimestamp
        Text item=owmForecastTodayCondition
        Text item=owmForecastTodayMinTemperature
        Text item=owmForecastTodayMaxTemperature
        Text item=owmForecastTodayPressure
        Text item=owmForecastTodayHumidity
        Text item=owmForecastTodayWindSpeed
        Text item=owmForecastTodayWindDirection
        Text item=owmForecastTodayCloudiness
        Text item=owmForecastTodayRainVolume
        Text item=owmForecastTodaySnowVolume
    Frame label="Forecast for tomorrow" {
        Text item=owmForecastTomorrowCondition
        Text item=owmForecastTomorrowMinTemperature
        Text item=owmForecastTomorrowMaxTemperature
    Frame label="Forecast in 2 days" {
        Text item=owmForecastDay2Condition
        Text item=owmForecastDay2MinTemperature
        Text item=owmForecastDay2MaxTemperature
    Frame label="Weather in Miami" {
        Text item=owmCurrentConditionMiami
        Text item=owmCurrentTemperatureMiami
1 Like

(Vincent Regaud) #10

Looks good, just one left behind

Frame label="Weather in Miami" {


(Christoph Weitkamp) #11

I have changed it. Thanks.


(Danny mullen) #12

Thanks @vzorglub and @cweitkamp. I am still trying to connect to google, before I even worry about weather…


(SiHui) #13

Thanks a lot for that binding. :+1:

I think I’ve found one issue, though: I’ve set the refresh interval to 10 minutes, but still do only get values every 60 minutes:

2018-06-17 10:43:52.746 [vent.ItemStateChangedEvent] - owmCurrentWind changed from 5.1 m/s to 5.7 m/s
2018-06-17 11:43:58.611 [vent.ItemStateChangedEvent] - owmCurrentWind changed from 5.7 m/s to 5.1 m/s
2018-06-17 12:44:01.313 [vent.ItemStateChangedEvent] - owmCurrentWind changed from 5.1 m/s to 5.7 m/s
2018-06-17 13:44:04.043 [vent.ItemStateChangedEvent] - owmCurrentWind changed from 5.7 m/s to 5.1 m/s
2018-06-17 14:44:07.044 [vent.ItemStateChangedEvent] - owmCurrentWind changed from 5.1 m/s to 4.6 m/s
2018-06-17 15:44:11.814 [vent.ItemStateChangedEvent] - owmCurrentWind changed from 4.6 m/s to 5.1 m/s

Thing is set via PaperUI:

  "openweathermap:weather-api:api": {
    "class": "org.eclipse.smarthome.core.thing.internal.BridgeImpl",
    "value": {
      "label": "OpenWeatherMap API",
      "channels": [],
      "configuration": {
        "properties": {
          "apikey": "yxyxyxyxyxyxyxyx",
          "refreshInterval": 10,
          "language": "de",
          "hourlyForecast": true,
          "dailyForecast": false

(Christoph Weitkamp) #14

@sihui Thanks for the feedback. I am happy that it works for you.

Can you please watch the time-stamp channel in the same way? Or enable DEBUG logging to track the requests? I have the slight feeling that the data of OWM itself is refreshed only once - maybe twice - per hour.


(SiHui) #15

I already did :grinning:

2018-06-17 10:13:50.735 [vent.ItemStateChangedEvent] - owmCurrentTime changed from 2018-06-17T09:20:00.000+0200 to 2018-06-17T09:37:00.000+0200
2018-06-17 10:43:52.728 [vent.ItemStateChangedEvent] - owmCurrentTime changed from 2018-06-17T09:37:00.000+0200 to 2018-06-17T10:20:00.000+0200
2018-06-17 11:43:58.603 [vent.ItemStateChangedEvent] - owmCurrentTime changed from 2018-06-17T10:20:00.000+0200 to 2018-06-17T11:20:00.000+0200
2018-06-17 12:44:01.309 [vent.ItemStateChangedEvent] - owmCurrentTime changed from 2018-06-17T11:20:00.000+0200 to 2018-06-17T12:20:00.000+0200
2018-06-17 13:44:04.027 [vent.ItemStateChangedEvent] - owmCurrentTime changed from 2018-06-17T12:20:00.000+0200 to 2018-06-17T13:20:00.000+0200
2018-06-17 14:44:07.040 [vent.ItemStateChangedEvent] - owmCurrentTime changed from 2018-06-17T13:20:00.000+0200 to 2018-06-17T14:20:00.000+0200
2018-06-17 15:44:11.811 [vent.ItemStateChangedEvent] - owmCurrentTime changed from 2018-06-17T14:20:00.000+0200 to 2018-06-17T15:20:00.000+0200

(Vincent Regaud) #16

Quick question, what binding name do I need to put in the addons.cfg, please?


(SiHui) #17

market = binding-4126092


(Vincent Regaud) #18

Is that the whole string: “market=binding-4126092” or just “binding-4126092”



(SiHui) #19

Did not try it myself, I was just referring to that post I’ve found.
But it looks like it is the whole string :sunglasses:


(Vincent Regaud) #20

Got it.Had to add another line to the file just for market binding. Working.

1 Like