Weather Underground (Wunderground) direkt in Loxone einbinden



Wunderground, Übernahme durch IBM und Developer keys

Nach der Übernahme von Weather Underground durch IBM bietet WU keine kostenlosen Developer Keys zur Abfrage von Daten mehr an. Zuvor registrierte API Keys bleiben (vorläufig) funktionsfähig. Wenn du keinen API Key hast, funktioniert das Plugin nicht. Als Alternative siehe Dark Sky direkt in Loxone einbinden.

After IBM has taken over Weather Underground, WU does not provide free developer API keys anymore. Already issued keys stay working (for the moment). If you don't have an API key, the plugin won't work. Look at Dark Sky direkt in Loxone einbinden as alternative solution.



Version 1.1 (11.04.2016) - Ältere Versionen findest du ganz unten.

Mit diesem Template können Daten direkt von Weather Underground in den Miniserver geholt werden. Dies funktioniert ohne Umweg über einen PC, und auch ohne PicoC, anhand des virtuellen HTTP Eingangs.

Enthalten sind 78 Datenfelder: 

  • Die aktuellen Wetterdaten

  • Die Vorschau für heute, morgen und übermorgen

  • Die Stundendaten der nächsten vier Stunden

Die Eingänge können selbst erweitert werden.

Fragen zu diesem Artikel bitte in folgendem Forums-Thread: https://www.loxforum.com/forum/faqs-tutorials-howto-s/65220-wunderground-weather-underground-als-template-einbinden

Template

Template herunterladen: VI_Wunderground.xml (Version 1.1)

Das Einbinden des Templates funktioniert so: Templates in Loxone Config einbinden

Enthaltene Daten

Eingang

Einheit und Beschreibung

Template Version

Eingang

Einheit und Beschreibung

Template Version

Aktuelle Wetterdaten

wu_current_observation_epoch

Unixtime - Epochzeit der Abfrage

Siehe epochtime (Unix-Zeit) zum Prüfen auf Datenaktualität nutzen

1.0

wu_current_temp

°C - Aktuelle Temperatur

1.0

wu_current_feelslike

°C - Gefühlte Temperatur

1.0

wu_current_humidity

% - Relative Luftfeuchtigkeit

1.0 - Korrektur in 1.1

wu_current_dewpoint

°C - Taupunkt

1.0

wu_current_wind

km/h - Windgeschwindigkeit

1.0

wu_current_wind_gust

km/h - Maximale Windböen

1.0

wu_current_wind_degrees

° - Windrichtung

1.0

wu_current_pressure_mb

mbar - Luftdruck

1.0

wu_current_precip_today

mm - Regenmenge dieses Tages

1.0

wu_current_precip_1hr

mm - Regenmenge letzte Stunde

1.0

wu_current_visibility_km

km - Sichtweite

1.0

wu_current_solarradiation

W/m² - Solareinstrahlung

1.0

wu_current_UV

? - UV-Einstrahlung

1.0

wu_current_icon_B3

Wetter-Icon 3. Byte (siehe Iconcodes unten)

1.1

wu_current_icon_B4

Wetter-Icon 4. Byte (siehe Iconcodes unten)

1.1

wu_current_icon_B9

Wetter-Icon 9. Byte (siehe Iconcodes unten)

1.1

Tagesvorschauen (fcday0 = heute, fcday1 = morgen, fcday2 = übermorgen)

wu_fcday0_temp_low

°C - Tagestiefstwert

1.0

wu_fcday0_temp_high

°C - Tageshöchstwert

1.0

wu_fcday0_wind_avg

km/h - Durchschnittliche Windgeschwindigkeit

1.0

wu_fcday0_wind_max

km/h - Maximale Windgeschwindigkeit

1.0

wu_fcday0_rain_allday

mm - Niederschlag des Tages

1.0

wu_fcday0_snow_allday

cm - Schneefallmenge des Tages

1.0

wu_fcday0_rain_pos

% - Regenwahrscheinlichkeit

1.0

wu_fcday0_icon_B3

Wetter-Icon 3. Byte (siehe Iconcodes unten)

1.1

wu_fcday0_icon_B4

Wetter-Icon 4. Byte (siehe Iconcodes unten)

1.1

wu_fcday0_icon_B9

Wetter-Icon 9. Byte (siehe Iconcodes unten)

1.1

Stundenvorhersage (hr1 = nächste volle Stunde, hr2, hr3, hr4)

wu_hr1_hour

Std. - Stunde der Vorschau

1.0

wu_hr1_temp

°C - Temperatur

1.0

wu_hr1_feelslike

°C - Gefühlte Temperatur

1.0

wu_hr1_wind

km/h - Windgeschwindigkeit

1.0

wu_hr1_rain

mm - Regenmenge der Stunde

1.0

wu_hr1_snow

cm - Schneefallmenge der Stunde

1.0

wu_hr1_rain_pos

% - Regenwahrscheinlichkeit

1.0

wu_hr1_iconcode

Iconcode

1.0

 

Token und Ort

http://api.wunderground.com/api/*TOKEN*/alerts/conditions/forecast/hourly/lang%3ADL/pws%3A1/bestfct%3A1/q/*LOCATION*.json

In der URL des Templates musst du die Felder *TOKEN* und *LOCATION* durch deine Angaben ersetzen. Beachte, dass das Ende der Abfrage weiterhin .json lauten muss.

Für die Nutzung ist ein Token bei Wunderground erforderlich. Diesen kannst du auf https://www.wunderground.com/weather/api/ als Developer-Key kostenlos anfordern. *TOKEN* durch deinen Token ersetzen (die Sterne entfernen).

Für den Ort *LOCATION* kannst du den Namen deines Ortes verwenden, oder die Koordinaten:

  • bei Wunderground suchen und den Ort übernehmen, also ..../q/Linz%2C+OS.json

  • direkt eine angegebene Wetterstation übernehmen: .../q/pws:IOBERSTE120.json (der Doppelpunkt muss als %3A URLencoded angegeben werden, danach die ID der Wetterstation, also pws%3AIOBERSTE120.json)

  • deine Koordinaten angeben: .../q/48.3,14.2.json, auch hier muss das Komma urlencoded werden: /q/48.3%2C14.2.json Koordinaten finden z.B. hier: http://www.latlong.net/

image2016-4-8 7:30:22.png

Bild: Abfrage eines Ortes

 

Abfragelimit

Die Abfrageanzahl in der kostenlosen Version sind limitiert. Für die Wetterdaten ist es ausreichend, diese alle 20-30 Minuten zu aktualisieren.

Bei einem Miniserver-Neustart werden die Daten immer sofort aktualisiert.

Aufbau der virtuellen Eingänge des Templates

Alle Eingänge beginnen mit wu (Weather Underground).

  • wu_current_* sind die aktuellen Wetterdaten

  • wu_fcday*_* sind die Tages-Vorhersagen (fcday0 ist heute, fcday1 ist morgen, fcday2 ist übermorgen)

  • wu_hr*_* sind die Vorhersagen für die nächsten Stunden (hr1 ist die kommende, volle Stunde, hr2, hr3, hr4 die zweite, dritte und vierte Stunde)

Im Template sind nicht alle Daten enthalten, die Wunderground zurückliefert. Du kannst die Eingänge ergänzen, wenn du weitere Daten benötigst.

Bitte beachte: Für jeden einzelnen Eingangsbefehl wird vom Miniserver eine Suche durchgeführt. Diese Suchen benötigen Leistung des Miniservers. Daher empfehle ich, Eingänge, die du absolut nicht benötigst, aus deiner Programmierung zu löschen.

Iconcodes für aktuelles Wetter und Vorschau

Wunderground liefert in der API nur für die stundenweise Vorhersage einen Iconcode. Für die aktuellen Bedingungen und tageweise Vorschau wird nur ein String zurückgeliefert, den Loxone (Stand 7.3.1.5) nicht verarbeiten kann.

Mit den Eingängen *_icon_B3, *_icon_B4, *_icon_B9 (beim aktuellen Wetter und der Tagesvorschau - ab Template V1.1) werden einzelne Bytes des Strings ausgelesen. Mit dem Statusbaustein aus dieser Loxone-Config werden diese in die Icon-Codes 1 bis 20 umgesetzt:

Download Beispielprogramm Wettericons: WU_Wettericons.Loxone

Auf Wunderground gibt es dazu Iconsets, außerdem gibt es in diesem Artikel bereits Icons, die in Loxone verwendet werden können: Symbole und Icons - klein.

Als Info/Referenz, hier die Auswertung der Strings und der ASCII-Codes: Auswertung Strings in ASCII.xlsx

Windrichtung

Um die Windrichtung von wu_current_wind_degrees (in Grad) in eine Himmelsrichtung umzuwandeln, kann direkt die Beschreibung der Windrose von Wetterstation WH2600 / WH2600 SE / WH2601 direkt in Loxone einbinden verwendet werden.

Template-Versionen

Version

Download

Beschreibung

Version

Download

Beschreibung

1.0 (07.04.2016)

VI_Wunderground.xml

Initiales Template, 36 virtuelle Eingänge (current, forecast für 3 Tage, 4 Stunden)

 

 

 

 

 

 

 

wu_current_icon_B9