INF - Information
Documentation of the Elvis Package “Wunderground”
https://www.wunderground.com/weather/api offers a Web service that you may use after registration to access weather data and forecasts – in a certain amount (as of July 2016: max. 500 requests per day, max. 10 per minute) even free of charge.
Update November 2018 – The Weather Company announces:
“The WU API has been around since 2010 to help you develop apps and websites as well as manage your Personal Weather Station data. During that time, we’ve watched you build amazing products and visualize weather data with creativity and purpose.
Over the years, our infrastructure has been unable to keep up with the growing numbers of users coming to us for API data. This has led to higher costs as we worked to keep the service stable and dependable. Eventually, we realized we’d need to make drastic changes or risk serious problems for our API.
As a result, we’ve made the difficult decision to retire the Weather Underground API. The Weather Company, which acquired WU back in 2012, offers a powerful suite of enterprise-grade APIs that might be better suited to meet your scale and performance needs while offering a broader range of weather data. You can see these products here .
Here’s what you need to know going forward:
We are grateful for your commitment to Weather Underground and appreciate your understanding and support as we work through this process. These changes will allow us to continually improve our services and develop new features to keep WU a thriving place for you for many years to come.”
Please contact our support if you need assistance with the change to another weather service.
Update August 2018 – It is no longer possible to create new API keys free of charge. Existing keys still work, however. A possible alternative is darksky.net; please ask our support if you need help on this.
Please read about the exact conditions at the Web address given above.
After adding the package via the package manager (since Elvis 3.3.31) to the server project, the configuration file WOL.xml is available (hint for earlier Elvis versions below).
Next, a new datapoint port has to be created in the server project: Right-click on the server project -> Add -> Add Server data -> Port with Datapoints. Name the new elvissc File e.g. “Weather.elvissc”.
Then add a new port in this file (name it e.g. “Wunderground”) and select „GenericWebClient“ as driver type. Configure it further in the properties window:
|Password:||…||please enter the API key received during registration here|
Now you can create datapoints using this port for the individual data transferred. The configurations file already extracts the element current_observation from the response; the data contained there are documented at https://www.wunderground.com/weather/api/d/docs?d=data/conditions#response_fields:
Useful datapoints are e.g.:
|temp_c||Real32||Temperature in °C|
|wind_degrees||Real32||Wind direction in °|
|wind_kph||Real32||Wind speed in km/h|
In Elvis versions before 3.3.31, please use the following procedure instead of the package manager: