swiss-weather-api-Adapter für ioBroker

Verbindet sich mit der leistungsstarken SRF-Wetter-API – Version 2 ( https://developer.srgssr.ch/api-catalog/srf-weather/srf-weather-description ). Die SRF-Wetter-REST-API ermöglicht den Abruf von Wettervorhersagen und -berichten für über 25.000 Standorte in der ganzen Schweiz. Mit einem „Freemium“-Abonnement erhalten Sie 50 Anfragen pro Tag.

Bitte beachten Sie:

1. Dieser Adapter ist nur für Standorte innerhalb der Schweiz geeignet.
2. Dieser Adapter unterstützt die SRF Weather API V2.

Aktualisierungsverfahren von Version 1.xx auf 2.0.x

• Entfernen Sie den Adapter (löschen Sie alle Adapter-Objekte in ioBroker!).
• Adapter komplett neu installieren => Neue Objekte werden generiert
• Da SRF die Pfadnamen geändert hat, aktualisieren Sie Ihre Visu: Importieren Sie die Ansichten einfach erneut .

Erste Schritte

1. Erstelle ein kostenloses Konto auf https://developer.srgssr.ch/
2. Gehen Sie zu „Apps“ und fügen Sie eine neue App hinzu. Hier können Sie ein API-Produkt auswählen. „SRF-MeteoProductFreemium“ ist das kostenlose Produkt. Wenn Sie nur eine Vorhersage für einen Standort benötigen und lediglich 50 Anfragen pro Tag (alle 30 Minuten) erhalten möchten und/oder nicht für mehr Anfragen pro Tag bezahlen möchten, ist „SRF-MeteoProductFreemium“ die richtige Wahl. Dadurch werden ein spezifischer ConsumerKey und ein ConsumerSecret erstellt.
3. Ermitteln Sie Längen- und Breitengrad (Dezimalgrad) des ausgewählten Standorts, für den eine Vorhersage benötigt wird. Diese Angabe ist optional, wenn Sie Ihren Standort in den ioBroker-Einstellungen (Haupteinstellungen) (über die Karte) festgelegt haben. In diesem Fall können Sie die Felder für Längen- und Breitengrad leer lassen. Der Adapter verwendet dann die Einstellungen des ioBrokers. Die in der Adapterkonfiguration eingegebenen Längen- und Breitengrade überschreiben die ioBroker-Einstellungen.
4. Freemium-Nutzer: Bitte beachten Sie, dass die SRG-API den verwendeten Standort speichert. Ab der ersten Anfrage und für einen bestimmten Zeitraum kann das verwendete Abonnement nur Anfragen für diesen einen Standort bearbeiten.
5. Installieren Sie diesen Adapter auf ioBroker => Dies kann mehrere Minuten dauern (ca. 7 Minuten auf einem Raspberry Pi 3).
6. Füllen Sie im Feld „Adapterkonfiguration“ die folgenden Felder aus:
   1. Name der App
   2. ConsumerKey der App
   3. ConsumerSecret der App
   4. Längengrad/Breitengrad des gewählten Schweizer Standorts, für den eine Vorhersage benötigt wird. => Bitte verwenden Sie Dezimalgrad (z. B. Zürich: 47,36667 / 8,5).
   5. Abfrageintervall in Minuten (Standardmäßig 60 Minuten – 25 Anfragen/Tag)

Die erste Abfrage erfolgt 10 Sekunden nach dem Start des Adapters. Nach dem ersten Start wird die Abfrage regelmäßig gemäß dem Konfigurationsparameter (Abfrageintervall in Minuten) ausgeführt. Die Objekte in `forecast.current_hour` werden 30 Sekunden nach dem ersten Start erstellt und stündlich aktualisiert, indem die entsprechenden Werte aus `forecast.hours` kopiert werden.

Visualisierungsbeispiel

Voraussetzung:

• Adapter Material Design Widgets >= 0.5.7
• Adapter Vis
• Ansichten in Vis importieren

Beispiel

Einfaches Beispiel:

Erweitertes Beispiel:

Beispiel für eine Wochenübersicht:

Changelog

2.2.2 (2024-11-01)

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

2.2.1 (2024-11-01)

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

2.2.0 (2024-10-30)

• (baerengraben) Wochensicht_reduziert neu als View und mit Legende

2.1.1 (2024-10-29)

• (baerengraben) Fix for https://github.com/baerengraben/ioBroker.swiss-weather-api/issues/124
• (baerengraben) Fix for https://github.com/baerengraben/ioBroker.swiss-weather-api/issues/123
• (baerengraben) Fix for https://github.com/baerengraben/ioBroker.swiss-weather-api/issues/122
• (baerengraben) Fix for https://github.com/baerengraben/ioBroker.swiss-weather-api/issues/121

2.1.0 (2024-01-10)

• (baerengraben) Added additional Week-View. Credits goes to https://github.com/pingus01

License

MIT License

Copyright (c) 2024 baerengraben baerengraben@intelli.ch

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.