WeatherUnderground Binding

The Weather Underground API is provided by The Weather Underground, LLC (WUL) free of charge but there is a daily limit and minute rate limit to the number of requests that can be made to the API for free.
WUL will monitor your daily usage of the API to determine if you have exceeded the free-use threshold by using an API key. You may exceed this threshold only if you are or become a fee paying subscriber.
By using this binding, you confirm that you agree with the Weather Underground API terms and conditions of use.

Supported Things

There are exactly two supported thing types. The first one is the bridge thing, which represents the connection to the Weather Underground service through the API key. It has the id bridge. The second one is the weather thing, which represents the weather information for an observed location. It has the id weather. Each weather thing uses a bridge thing ; it cannot be set online if no bridge thing is defined.

Discovery

If a system location is set, “Local Weather” will be automatically discovered for this location.

If the system location is changed, the background discovery updates the configuration of “Local Weather” automatically.

If a bridge is correctly configured, the discovered thing will automatically go online.

Binding Configuration

The binding has no configuration options, all configuration is done at Thing and Channel levels.

Thing Configuration

The bridge only has one configuration parameter:

Parameter

Description

apikey

API key to access the Weather Underground service. Mandatory.

The thing has a few configuration parameters:

Parameter

Description

location

Location to be considered by the Weather Underground service. Mandatory.

language

Language to be used by the Weather Underground service. Optional, the default is to use the language from the system locale.

refresh

Refresh interval in minutes. Optional, the default value is 30 minutes and the minimum value is 5 minutes.

For the location parameter, different syntaxes are possible:

Syntax

Example

US state/city

CA/San_Francisco

US zipcode

60290

country/city

Australia/Sydney

latitude,longitude

37.8,-122.4

airport code

KJFK

PWS id

pws:KCASANFR70

It can happen that the service is not able to determine the station to use, for example when you select as location a city in which several stations are registered. In this case, the thing configuration will fail because the service will not return the data expected by the binding. The best solution in this case is to use as location latitude and longitude, the service will automatically select a station from this position.

For the language parameter Weather Underground uses a special set of language codes which are different from ISO 639-1 standard, for example for German use DL or Swedish use SW. See Weather Underground language support documentation for a detailed list.

Channels

The weather information that is retrieved is available as these channels: