iobroker.swiss-weather-api

ioBroker.swiss-weather-api

Tests::

swiss-weather-api adapter for ioBroker

Connects to the great SRG-SSR weather API (https://developer.srgssr.ch/apis/srgssr-weather).

The SRG-SSR Weather REST API allows you to get weather forecasts and reports from more than 25.000 locations across Switzerland.

Icons

Weather-Icons are reused from https://erikflowers.github.io/weather-icons/

Since Version 0.1.8 SRG-SSR even provides their own icons. So you can choose which Icons-Set you want to use.

Be aware that this adapter only supports locations within Switzerland.

Getting started

1. Get a free accout on https://developer.srgssr.ch/
2. Make sure using the product "SRG-SSR-PUBLIC-API-V2" since this is their free product
3. Go to "My Apps" and create a new App. This will create a specific ConsumerKey and ConsumerSecret
4. Find out Longitude / Latitude (decimal degrees) of the chosen location for which forecast is needed
5. Install this Adapter on ioBroker => This can take several minutes (~7min on a Raspberry Pi 3)
6. On Adapter Configuration fill in
   1. Name of App
   2. ConsumerKey of App
   3. ConsumerSecret of App
   4. Longitude / Latitude of the chosen swiss location for which forecast is needed. => Please use decimal degrees (for example Zürich: 47.36667 / 8.5)
   5. Poll Interval in Minutes (By default 30 minutes)

The first query is made 10s after the adapter was started. After the first start, the query will be executed regularly according to the conifugation parameter (Poll Interval in Minutes)

Changelog

0.3.2

• (baerengraben) Fix for https://github.com/baerengraben/iobroker.swiss-weather-api/issues/13.

0.3.1

• (baerengraben) Adapter-Config attributes longitude & latitude is optional now. If no longitude/latitude is set, the adpater is getting the longitude/latitude from ioBroker System-Attributes (https://github.com/baerengraben/iobroker.swiss-weather-api/issues/6).

0.3.0

• (baerengraben) Change from Scheduled Adapter to Deamon Adapter(https://github.com/baerengraben/iobroker.swiss-weather-api/issues/11). The query interval is now configurable by parameter. The first query is made 10s after the adapter was started. Attention: For installing this version, please delete the older adapter version completely and install it again.

0.2.3

• (baerengraben) Update Dependencies

0.2.2

• (baerengraben) Some bug fixing
• (baerengraben) Enhancement https://github.com/baerengraben/iobroker.swiss-weather-api/issues/10

0.2.0

• (baerengraben) Updates in order to commit to iobroker stable

0.1.9

• (baerengraben) Dependency- and Vulnerabilites-Updates

0.1.8

• (baerengraben) Added Icons provided by SRGSSR => Thank you!! :)
• (baerengraben) Added new Object icon-url-srgssr => Contains the url-link to the srgssr Icon

0.1.7

Attention: If you have already installed a previous Version of swiss-weather-api (<= 0.1.6) please remove the adapter and install it completely new. This makes shure you get the new Unit-Names for "fff" and "ffx3" which where corrected by SRG.

• (baerengraben) Added Icon-Codes -17 to -30 => These are not yet confirmed by srf - but I beleave these are correct.
• (baerengraben) SRG is now providing the correct unit-names for "fff" and "ffx3". Adaptet this in the swiss-weather-adapter. Attention: You have to reinstall the swiss-weather-api (remove and install new Version) to make shure the Object-Name gets this Update.

0.1.6

• (baerengraben) Some fixes based on Feedback of forum.iobroker.net

0.1.5

• (baerengraben) Some fixes based on Feedback of forum.iobroker.net

0.1.4

• (baerengraben) Added Travis CI testing

0.1.3

• (baerengraben) Role-Definitions updated and added attribute 'icon-name'.

0.1.2

• (baerengraben) Some fixes.

0.1.0

• (baerengraben) Running version. Reads the complete weather forecast from https://api.srgssr.ch

0.0.2

• (baerengraben) first running version. Reads Current Forecast (https://api.srgssr.ch/forecasts/v1.0/weather/current)

0.0.1

• (baerengraben) initial release

License

MIT License

Copyright (c) 2020 baerengraben [e-mail]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.