UWZ

2022-05-27T07:36:42Z

Obi-Wan: Randnotiz überarbeitet ( falschen Hinweis entfernt das der UWZ Dienst nicht mehr arbeitet und damit das Modul obsolet ist )

{{Infobox Modul
|ModPurpose=Daten von Unwetterzentrale.de holen
|ModType=d
|ModForumArea=Unterstützende Dienste/Wettermodule
|ModTechName=77_UWZ.pm
|ModOwner=Tdoe, CoolTux ({{Link2Forum|Topic=51233|LinkText=Forum}})
}}

Das Modul [[UWZ]] holt Informationen für eine zu spezifizierende Postleitzahl von der Seite [http://unwetterzentrale.de/ Unwetterzentrale.de] und bereitet sie für die Darstellung in FHEM auf.

== Voraussetzungen ==
{{Randnotiz|RNTyp=Fehl|RNText=Diese Anleitung ist etwas in die Tage gekommen. Es hat viele Änderungen und Neuerungen gegeben. Die {{Link2CmdRef|Anker=UWZ}} ist aktuell und sollte eine gute Hilfestellung geben. Ansonsten bitte ins Forum schauen, ob hier bereits Lösungen zum Problem bestehen.

Die Wikiseite wird nach und nach aktualisiert. Wenn du dies liest und du dich mit dem Modul auskennst, bist du recht herzlich eingeladen, den Artikel zu aktualisieren. So bleibt uns (Entwicklern) mehr Zeit, um uns um das Modul zu kümmern und dies zu verbessern/erweitern.}}
Standardinstallation und eine Internetverbindung werden für das Funktionieren des Moduls benötigt.

== Installation ==
Das Modul wird als offizielles Modul per [[update]] verteilt und muss nicht extra installiert werden.

Falls nach dem "define" der Fehler "unable..." kommt und im Log "...Can't locate XML/Simple.pm in @INC (you may need to install the XML::Simple module)..." steht, so kommt man auf der Konsole mit der folgenden Installation weiter:

<code>cpan install XML::Simple</code>

Es geht auf der Konsole aber auch mit:

<code>apt-get install libxml-simple-perl</code>

== Anwendung ==
=== Define ===
Abhängig davon, ob man Unwetterwarnungen aus Deutschland oder einem anderen Land abfragen möchte, muss für das Attribut PLZ entweder die Postleitzahl (Deutschland) oder die AREA_ID (Rest der Welt) verwendet werden.

==== Deutschland ====
:<code><nowiki>define <name> UWZ <Ländercode> <PLZ> <INTERVAL> </nowiki></code>

==== Rest der Welt ====
:<code><nowiki>define <name> UWZ <Ländercode> <AREA_ID> <INTERVAL> </nowiki></code>

Die AREA_ID kann folgendermaßen ermittelt werden:

===== Geokoordinaten ermitteln =====
Dazu wird folgende URL aufgerufen, und am Ende der URL bei dem ''search'' Parameter der Name des Ortes eingegeben. Im Fall von Oberwaltersdorf AT:
:<code><nowiki>http://alertspro.geoservice.meteogroup.de/weatherpro/SearchFeed.php?search=oberwalt</nowiki></code>

Als Antwort bekommt man eine XML Struktur mit gefundenen Orten:
<pre>
<result>
<cities previousOffset="-1" nextOffset="-1">
<city country="49" city="8512" id="18226609" country-name="Germany" province-name="Bavaria" continent="6" inhabitants="7500" longitude="12.17092" latitude="48.57422" name="Oberwaltenkofen (Ergolding)" timezone="Europe/Berlin"/>
<city country="49" city="8671" id="18226768" country-name="Germany" province-name="Bavaria" continent="6" inhabitants="4000" longitude="12.51418" latitude="48.77301" name="Oberwalting (Leiblfing)" timezone="Europe/Berlin"/>
<city country="43" city="1161" id="18134912" country-name="Austria" province-name="Niederösterreich" continent="6" inhabitants="2500" longitude="16.3203" latitude="47.9756" name="Oberwaltersdorf" timezone="Europe/Vienna"/>
<city country="43" city="1305915" id="182199490" country-name="Austria" province-name="Niederösterreich" continent="6" inhabitants="150" longitude="15.0844" latitude="48.5394" name="Oberwaltenreith" timezone="Europe/Vienna"/>
</cities>
</result>
</pre>

Dort sucht man sich die beiden Attribute ''latitude'' und ''longitude'' für den passenden Ort heraus. Im verwendeten Beispiel wäre es für Oberwaltersdorf in Österreich:
:<code>latitude="47.9756" </code>
:<code>longitude="16.3203" </code>

===== AREA_ID abfragen =====
Mit diesen Werten wird nun die nächste URL zusammengebaut (Parameter ''lat'' + ''lon''):
:<code><nowiki> http://feed.alertspro.meteogroup.com/AlertsPro/AlertsProPollService.php?method=lookupCoord&lat=47.9756&lon=16.3203 </nowiki></code>

Das Resultat:
:<code><nowiki>[{"AREA_TYPE":"UWZ","AREA_ID":"UWZAT00234","CENTER_ID":"2"}] </nowiki></code>

Nun wissen wir, dass die AREA_ID für Oberwaltersdorf:
:<code>UWZAT00234 </code>
ist. Bei der Definition wird nun die Nummer ''00234'' anstelle der PLZ, und ''AT'' beim Ländercode verwendet:
:<code>define Unwetterzentrale UWZ AT 00234 3600 </code>

=== Attribute ===
Siehe Dokumentation.

== Anwendungsbeispiele ==
Zur Anzeige der Warnhinweise bietet das Modul vordefinierte Funktionen an, die in [[weblink|Weblinks]] benutzt werden können.


[[Datei:UWZAsHtmlFP.png|mini|right|400px|Warnmeldungen als reine Icons (Format ''UWZAsHtmlFP'') mit Teilen der Objektdetails]]
=== Anzeige der Warnhinweise nur als Icon ===
Die UWZ-Warnhinweise können über die Definition
:<code>define ''UnwetterFloorplan'' weblink htmlCode {FHEM::UWZ::UWZAsHtmlFP("''Unwetterzentrale''")}</code>
als reine Icons angezeigt werden. Diese Darstellung eignet sich besonders für die Einbindung in einen [[FLOORPLAN]].

Im gezeigten Beispiel ist ''Unwetterzentrale'' der Name des UWZ-Objekts und ''UnwetterDetailliert'' der Name des erzeugten weblink-Objekts.

<br clear=all>
[[Datei:UWZAsHtml.png|mini|right|400px|Warnmeldungen im Format ''UWZAsHtml'']]
=== Detaillierte Anzeige der Warnhinweise ===
Zur Anzeige der Warnhinweise in der ausführlichsten Form kann mit
:<code>define ''UnwetterDetailliert'' weblink htmlCode {FHEM::UWZ::UWZAsHtml("''Unwetterzentrale''")}</code>
ein weblink definiert werden.

Im gezeigten Beispiel ist ''Unwetterzentrale'' der Name des UWZ-Objekts und ''UnwetterDetailliert'' der Name des erzeugten weblink-Objekts.

=== Unwetterkarten ===
Auch diverse Unwetterkarten können eingebunden und gedownloadet werden.
Hierfür stehen eine Reihe von Karten zur Verfügung.
Mögliche Karten sind:
*europa

*deutschland
*deutschland-small
*bayern
*bremen
*baden-wuerttemberg
*brandenburg
*berlin
*hessen
*niedersachsen
*rheinland-pfalz
*saarland
*sachsen
*sachsen-anhalt
*thueringen
*nordrhein-westfalen
*mecklenburg-vorpommern
*schleswig-holstein
*hamburg

*oesterreich
*burgenland
*kaernten
*niederoesterreich
*oberoesterreich
*salzburg
*steiermark
*tirol
*vorarlberg
*wien

*schweiz
*aargau
*appenzell_ausserrhoden
*appenzell_innerrhoden
*basel_landschaft
*basel_stadt
*bern
*fribourg
*geneve
*glarus
*graubuenden
*jura
*luzern
*neuchatel
*nidwalden
*obwalden
*schaffhausen
*schwyz
*solothurn
*stgallen
*ticino
*thurgau
*uri
*waadt
*wallis
*zug
*zuerich

*liechtenstein

*belgique

*denmark

*finnland

*france

*letzebuerg

*nederland

*norwegen

*portugal

*sverige

*espana

*unitedkingdom
*eastofengland
*eastmidlands
*london
*northeastengland
*northernireland
*northwestengland
*scotland
*southeastengland
*southwestengland
*wales
*westmidlands
*yorkshireandthehumber

*isobaren1
*isobaren2
*isobaren3

==== Anzeige von Unwetterkarten ====
Dies erfolgt ebenfalls durch einem weblink.
:<code>define ''UnwetterKarteDeutschland'' weblink htmlCode {FHEM::UWZ::UWZAsHtmlKarteLand("''Unwetterzentrale''","''Deutschland''")}</code>

==== Download von Unwetterkarten ====
Um die Karten herunterzuladen um sie beispielsweise mit dem RSS Modul zu nutzen, muss dies am UWZ Device via Attribute konfiguriert werden.
Hierfür stehen folgende Attribute zur Verfügung:
*download [0|1]
*savepath (default:"/tmp/")
*maps (leerzeichen separierte Liste der zu speichernden Unwetterkarten)

:<code>attr ''Unwetterzentrale'' download 1</code>
:<code>attr ''Unwetterzentrale'' savepath /tmp/</code>
:<code>attr ''Unwetterzentrale'' maps deutschland europa bayern</code>

Die angegebenen Karten werden bei jedem Lauf erneut heruntergeladen und überschreiben das alte File.

==== Wetteranimation ====
Ab der Version 1.4.1 bietet das Modul auch die Möglichkeit diverse Wetteranimationen zu integrieren. Diese können ebenfalls mittels weblink genutzt werden.

Beispiel:
:<code>define ''UnwetterKarteMovie'' weblink htmlCode {FHEM::UWZ::UWZAsHtmlMovie("Unwetterzentrale","stroemung")}</code>

Der erste Parameter definiert das zugehörige UWZ Device.

Der zweite Parameter kann einer der folgenden sein:

*niederschlag-wolken
*stroemung
*temperatur

*niederschlag-wolken-de
*stroemung-de

*niederschlag-wolken-ch
*stroemung-ch

*niederschlag-wolken-at
*stroemung-at

*niederschlag-wolken-uk
*stroemung-uk

== Links ==
* [http://www.unwetterzentrale.de Unwetterzentrale] (für Deutschland)
* [http://unwetter.wetteralarm.at wetteralarm] (für Österreich)
* Geoservice [http://alertspro.geoservice.meteogroup.de/] zur Bestimmung von Geokoordinaten und Areacode
* Modulthread im Forum: {{Link2Forum|Topic=51233}}

FHEMWiki - Benutzerbeiträge [de]

UWZ