Weather: Unterschied zwischen den Versionen

Weather
Zweck / Funktion
	Wettervorhersagen von Yahoo abfragen.
Allgemein
Typ	Gerätemodul
Details
Dokumentation	EN / DE
Support (Forum)	Unterstützende Dienste/Wettermodule
Modulname	59_Weather.pm
Ersteller	Dr. Boris Neubert
	Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

Aktuelle Version vom 23. September 2020, 16:40 Uhr

Mit dem Modul Weather können aktuelle Wetterdaten und Wettervorhersagen für einen bestimmten Ort von verschiedenen Wetter-APIs wie

DarkSky
OpenWeatherMap
Wunderground

abgefragt werden. Es ist in der Regel ein "APIkey" erforderlich, eine Anmeldung bei dem entsprechenden Dienst folglich notwendig.

Anwendung

End of Live der Yahoo Weather API
Da die Yahoo Weather API zum 03.01.2019 abgeschaltet wurde, kann Weather keine Wetterdaten von Yahoo mehr beziehen!

Define

siehe commandref/Weatherdefine.

Attribute

siehe commandref/Weatherattr.

API Besonderheiten

Das Openweathermap API liefert nur stundenweise Daten für drei Tage. Daher funktioniert dass Attribut forecast daily nicht.

Todo: September 2020 - Die folgenden Anwendungsbeispiele müssen noch auf die geänderte Situation aufgrund des Wegfalls der Yahoo Wetter API und der daraufhin nötigen Umstellungen angepasst werden.

Anwendungsbeispiele

Beispiel zur Modul-Einrichtung

Zuerst einmal besuchen wir die Yahoo Wetterseite und öffnen den Wetterbericht für die jeweilige Stadt (z.B. Berlin). In der URL des Wetterberichtes findet sich dann die sogenannte WOEID (WHERE-ON-EARTH-ID). Sie identifiziert die Wetterinfos, die FHEM abfragen soll. Für Berlin ist dies die Nummer 638242.

In der Konfiguration richten wir dann folgendes ein:

# – Wetterdaten erfassen -
define MeinWetter Weather 638242 3600 de
attr MeinWetter room Wettervorhersage

# - Logfile für alle Wetter Daten (monatsweise getrennt) —
define FileLog_MeinWetter FileLog ./log/meinwetter-%Y-%m.log MeinWetter
attr FileLog_MeinWetter logtype text
attr FileLog_MeinWetter room Wettervorhersage

# — Wetter Icons in vertikaler Ansicht hinzufügen —
define weblink_meinwetter weblink htmlCode {WeatherAsHtml("MeinWetter",7)}
attr weblink_meinwetter room Wettervorhersage

Das hat zur Folge, dass FHEM nun die Wetterdaten für Berlin (638242) jede Stunde (3600) neu abholt. Zudem wird eine vertikale Ansicht der Wetterdaten der nächsten 7 Tage erstellt. Die Anzeige erfolgt im Raum "Wettervorhersage".

Konfigurationsschwierigkeiten

Nebenstehende Beschreibung ist hinfällig, da der Yahoo Dienst nicht mehr verfügbar ist.

Da Yahoo momentan auf mehreren Browsern Darstellungs-Schwierigkeiten hat, ist es schwer bis unmöglich, nach bestimmten Städten zu suchen (Search Box ist nicht erreichbar).

Für diesen Fall gibt es aber noch die Möglichkeit, die WOEID auf Yahoo WOEID: So bekommt man die "Where on Earth" ID einer Stadt! zu erhalten. Erfolgreich gefunden habe ich diese Seite übrigens über den Trick einer Internet-Suche nach mehreren dominant bekannten Städte-IDs (oder vielleicht einfach Internet-Suche nach "WOEID").

Links

Forenthema zur grundlegenden Umstellung (Weather, DarkSky und OpenWeather API)
Weblink mit Stadtangabe für Wetter-Icons-Anzeige definieren: Beitrag
Einrichtung einer automatische Aktualisierung der Wetter-Anzeige-Seite (Weblinks): Beitrag
Anzahl der Icons definieren: Beitrag

@@ Zeile 6: / Zeile 6: @@
 <!-- |ModCategory= (noch?) nicht verwendet -->
 |ModCmdRef=Weather
-|ModForumArea=Unterstuetzende Dienste
+|ModForumArea=Unterstützende Dienste/Wettermodule
 |ModTechName=59_Weather.pm
 |ModOwner=Dr. Boris Neubert
 }}
-Mit dem Modul [[Weather]] können aktuelle Wetterdaten und Wettervorhersagen für einen bestimmten Ort von der Yahoo-Wetter-API regelmäßig abgefragt werden.
+Mit dem Modul [[Weather]] können aktuelle Wetterdaten und Wettervorhersagen für einen bestimmten Ort von verschiedenen Wetter-APIs wie
+* DarkSky
+* OpenWeatherMap
+* Wunderground
+abgefragt werden. Es ist in der Regel ein "APIkey" erforderlich, eine Anmeldung bei dem entsprechenden Dienst folglich notwendig.
 == Anwendung ==
+{{Randnotiz|RNTyp=y|RNText='''End of Live der Yahoo Weather API'''<br />
+Da die Yahoo Weather API zum 03.01.2019 abgeschaltet wurde, kann '''Weather''' keine Wetterdaten von Yahoo mehr beziehen!}}
 === Define ===
-siehe commandref.
+siehe {{Link2CmdRef|Lang=de|Anker=Weatherdefine}}.
 === Attribute ===
-siehe commandref.
+siehe {{Link2CmdRef|Lang=de|Anker=Weatherattr}}.
+=== API Besonderheiten ===
+Das Openweathermap API liefert nur stundenweise Daten für drei Tage.
+Daher funktioniert dass Attribut forecast daily nicht.
+{{Todo|'''September 2020''' - Die folgenden Anwendungsbeispiele müssen noch auf die geänderte Situation aufgrund des Wegfalls der Yahoo Wetter API und der daraufhin nötigen Umstellungen angepasst werden.}}
 == Anwendungsbeispiele ==
 === Beispiel zur Modul-Einrichtung ===
@@ Zeile 37: / Zeile 48: @@
 # — Wetter Icons in vertikaler Ansicht hinzufügen —
-define weblink_meinwetter weblink htmlCode {WeatherAsHtml("MeinWetter")}
+define weblink_meinwetter weblink htmlCode {WeatherAsHtml("MeinWetter",7)}
 attr weblink_meinwetter room Wettervorhersage
 </pre>
-Das hat zur Folge, dass FHEM nun die Wetterdaten für Berlin (638242) jede Stunde (3600) neu abholt. Zudem wird eine vertikale Ansicht der Wetterdaten erstellt. Die Anzeige erfolgt im Raum "Wettervorhersage".
+Das hat zur Folge, dass FHEM nun die Wetterdaten für Berlin (638242) jede Stunde (3600) neu abholt. Zudem wird eine vertikale Ansicht der Wetterdaten der nächsten 7 Tage erstellt. Die Anzeige erfolgt im Raum "Wettervorhersage".
+=== Konfigurationsschwierigkeiten ===
+{{Randnotiz|RNTyp=r|RNText=Nebenstehende Beschreibung ist hinfällig, da der Yahoo Dienst nicht mehr verfügbar ist.}}
+Da Yahoo momentan auf mehreren Browsern Darstellungs-Schwierigkeiten hat, ist es schwer bis unmöglich, nach bestimmten Städten zu suchen (Search Box ist nicht erreichbar).
+Für diesen Fall gibt es aber noch die Möglichkeit, die WOEID auf [https://www.computerhilfen.de/hilfen-64-422419-0.html Yahoo WOEID: So bekommt man die "Where on Earth" ID einer Stadt!] zu erhalten.
+Erfolgreich gefunden habe ich diese Seite übrigens über den Trick einer Internet-Suche nach ''mehreren'' dominant bekannten Städte-IDs (oder vielleicht einfach Internet-Suche nach "WOEID").
 == Links ==
+* Forenthema zur grundlegenden Umstellung ({{Link2Forum|Topic=95823|LinkText=Weather, DarkSky und OpenWeather API }})
 * Weblink mit Stadtangabe für Wetter-Icons-Anzeige definieren: {{Link2Forum|Topic=31428|Message=267555}}
+* Einrichtung einer automatische Aktualisierung der Wetter-Anzeige-Seite (Weblinks): {{Link2Forum|Topic=34581|Message=268957}}
+* Anzahl der Icons definieren: {{Link2Forum|Topic=20481|Message=253464}}