Skip to content

maodch/ioBroker.swiss-weather-api

 
 

Repository files navigation

Logo

ioBroker.swiss-weather-api

NPM version Downloads Number of Installations (latest) Number of Installations (stable) Dependency Status Known Vulnerabilities

NPM

Tests:: Travis-CI

swiss-weather-api adapter for ioBroker

Connects to the great SRG-SSR weather API (https://developer.srgssr.ch/apis/srgssr-weather).
Weather-Icons are reused from https://erikflowers.github.io/weather-icons/

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

Be aware that this adapter only supports locations within Switzerland.

Getting started

  1. Get a free accout on https://developer.srgssr.ch/
  2. Go to "My Apps" and create a new App. This will create a specific ConsumerKey and ConsumerSecret
  3. Find out Longitude / Latitude (decimal degrees) of the chosen location for which forecast is needed
  4. Install this Adapter on ioBroker => This can take several minutes (~7min on a Raspberry Pi 3)
  5. On Adapter Configuration fill in
    1. ConsumerKey of App
    2. ConsumerSecret of App
    3. Longitude / Latitude of the chosen swiss location for which forecast is needed. => Please use decimal degrees (for example Zürich: 47.36667 / 8.5)

This is a scheduled Adapter. It is scheduled every 30 minutes and reads the forecast API of SRG-SSR. You could change this intervall in instance-view (Schedule). A lower intervall is not recomented, since the minimal forecast is 1 hour. So please keep in mind that, after installation, it will take 30 minutes until the forecast data is delivered the frist time and the data-objects in data view are created.

On first installation you might want to check if everything works fine and don't want to wait for 30min. In this case you can change the scheduler to 1min. => If everything is working properly, please change it back to 30min.

Changelog

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

0.0.2

0.0.1

  • (baerengraben) initial release

License

MIT License

Copyright (c) 2020 baerengraben [email protected]

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.

About

Add Free SRG-SSR Weather API to ioBroker

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 97.6%
  • HTML 2.3%
  • CSS 0.1%