FHEMWiki - Benutzerbeiträge [de]

UWZ

2016-08-05T09:26:12Z

Tdoe:

{{Infobox Modul
|ModPurpose=Daten von Unwetterzentrale.de holen
|ModType=d
|ModForumArea=Unterstützende Dienste/Wettermodule
|ModTechName=77_UWZ.pm
|ModOwner=Tdoe, CoolTux ([https://forum.fhem.de/index.php/topic,51233.0.html Forum])
}}

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

'''Achtung: Diese Anleitung ist etwas in die Tage gekommen, es hat viele Änderungen/Neuerungen gegeben. Die Commandref ist up2date 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 upzudaten. So bleibt uns (den Entwicklern) mehr Zeit um uns um das Modul zu kümmern und dies zu verbessern/erweitern.'''

== Voraussetzungen ==

== Installation ==
Das Modul wird als offizielles Modul per [[update]] verteilt.

== 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 {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.

 
[[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 {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 {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 {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}}

UWZ

2016-08-05T09:23:35Z

Tdoe:

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

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

'''Achtung: Diese Anleitung ist etwas in die Tage gekommen, es hat viele Änderungen/Neuerungen gegeben. Die Commandref ist up2date 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 upzudaten. So bleibt uns (den Entwicklern) mehr Zeit um uns um das Modul zu kümmern und dies zu verbessern/erweitern.'''

== Voraussetzungen ==

== Installation ==
Das Modul wird als offizielles Modul per [[update]] verteilt.

== 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 {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.

 
[[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 {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 {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 {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}}

UWZ

2016-08-05T09:19:20Z

Tdoe:

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

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

== Voraussetzungen ==

== Installation ==
Das Modul wird als offizielles Modul per [[update]] verteilt.

== 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 {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.

 
[[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 {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 {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 {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}}

UWZ

2016-08-02T22:47:27Z

Tdoe: /* Download von Unwetterkarten */

{{Infobox Modul
|ModPurpose=Daten von Unwetterzentrale.de holen
|ModType=d
|ModForumArea=Unterstützende Dienste/Wettermodule
|ModTechName=77_UWZ.pm
|ModOwner=CoolTux ({{Link2FU|13684|Forum}}/[[Benutzer Diskussion:CoolTux|Wiki]])
}}

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

== Voraussetzungen ==

== Installation ==
Das Modul wird als offizielles Modul per [[update]] verteilt.

== 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 {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.

 
[[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 {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 {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 {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}}

UWZ

2016-08-02T22:36:42Z

Tdoe: /* Unwetterkarten */

{{Infobox Modul
|ModPurpose=Daten von Unwetterzentrale.de holen
|ModType=d
|ModForumArea=Unterstützende Dienste/Wettermodule
|ModTechName=77_UWZ.pm
|ModOwner=CoolTux ({{Link2FU|13684|Forum}}/[[Benutzer Diskussion:CoolTux|Wiki]])
}}

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

== Voraussetzungen ==

== Installation ==
Das Modul wird als offizielles Modul per [[update]] verteilt.

== 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 {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.

 
[[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 {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 {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.

== 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}}

UWZ

2016-04-02T19:06:16Z

Tdoe:

{{Infobox Modul
|ModPurpose=Daten von Unwetterzentrale.de holen
|ModType=contrib
|ModFTopic=33549
|ModCmdRef=ContribModul
|ModForumArea=Unterstützende Dienste
|ModTechName=77_UWZ.pm
|ModOwner=Tobias ({{Link2FU|11054|tdoe}})
}}

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

== Voraussetzungen ==

== Installation ==
Das Modul ist derzeit noch inoffiziell und kann / muss
* aus dem zugehörigen Forenthread (Siehe Zeile "Dokumentation" in der Infobox) geladen werden
* oder über den Befehl <code><nowiki>update 77_UWZ.pm https://raw.githubusercontent.com/tobias-d-oe/fhem-uwz/master/controls_uwz.txt</nowiki></code> installiert / aktualisiert werden.
Nach der Installation ist ein Restart von FHEM erforderlich.

== 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 {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.

 
[[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 {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
*isobaren1
*isobaren2

==== Anzeige von Unwetterkarten ====
Dies erfolgt ebenfalls durch einem weblink.
:<code>define ''UnwetterKarteDeutschland'' weblink htmlCode {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.

== 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

Yowsup

2015-08-06T23:16:18Z

Tdoe: /* Links */

{{SEITENTITEL:yowsup}}
{{Infobox Modul
|ModPurpose=Schnittstelle, um WhatsApp-Nachrichten empfangen und senden zu können.
|ModType=d
|ModCmdRef=yowsup
|ModFTopic=27543
|ModForumArea=Unterstuetzende Dienste
|ModTechName=32_yowsup.pm
|ModOwner=André / justme1968 ({{Link2FU|430|Forum}} / [[Benutzer Diskussion:justme|Wiki]])
}}

Das Modul [[yowsup]] dient dazu, WhatsApp-Nachrichten zu empfangen und zu senden.

== Voraussetzungen ==
* Die Funktionalität ist vermutlich auf Linux/Unix Systeme beschränkt.
* Nach der Erstinstallation/-einrichtung '''muss''' zwingend das ''cmd'' Attribut korrekt gesetzt werden.

== Installation ==
Die ursprüngliche Einrichtung wurde hier {{Link2Forum|Topic=27543|Message=204426|LinkText=hier beschrieben}}, jedoch sind noch einige wichtige Dinge zu setzen.

=== Yowsup Installation ===
Bevor man loslegt sollte man wie immer sicherstellen, dass Debian auf dem aktuellen Stand ist:
<code>sudo apt-get update
sudo apt-get upgrade
sudo apt-get dist-upgrade</code>

Los gehts mit den Paketen:
<code>sudo apt-get install python-soappy python-dateutil python-pip python-dev build-essential</code>

Nun erstmal pip updaten:
<code>sudo pip install --upgrade pip</code>

Und dann axolotl installieren (das dauert ne Weile):
<code>sudo pip install python-axolotl</code>

Will man Bilder verarbeiten, so braucht man noch ein paar Pakete mehr:
* Paketinstallationen:
** Unter Debian Wheezy: <code>sudo apt-get install libtiff4-dev libjpeg8-dev zlib1g-dev libfreetype6-dev liblcms2-dev libwebp-dev tcl8.5-dev tk8.5-dev python-tk</code>
** Unter Debian Jessie: <code>sudo apt-get install libtiff5-dev libjpeg-dev zlib1g-dev libfreetype6-dev liblcms2-dev libwebp-dev tcl8.5-dev tk8.5-dev python-tk</code>
* PIP:<code>sudo pip install pillow</code>

Vor den weiteren Schritten sollte geprüft werden, ob dem User fhem eine Loginshell zugewiesen ist:
:<code>getent passwd fhem</code>
Wird hier am Ende /bin/false ausgegeben, so muss dies angepasst werden:
:<code>sudo chsh -s /bin/bash fhem</code>

Mittels ''getent passwd fhem'' kann auch bereits das Home-Verzeichnis ausgelesen werden, dies steht in der ausgegebenen Doppelpunkt-separierten Liste an vorletzter Stelle.

Nun loggt man sich unter dem User ein, unter dem fhem läuft (in den folgenden Beispielen werden die vom fhem-Setup-Script generierten Defaults verwendet: User=fhem , home=/opt/fhem Gruppe=dialout) und liest dort die $HOME-Variable aus und prüft das Home-Verzeichnis:
<pre>sudo su - fhem
echo $HOME
cd $HOME
logout</pre>
Diesen Wert braucht man später - gut merken. Sollte hier ein Fehler auftreten (z.B. das home nicht vorhanden), so muss dies zuerst korrigiert werden.

Desweiteren muss man nun yowsup installieren, was wie folgt vonstatten geht:
<pre>cd /opt
sudo mkdir yowsup-config
sudo wget https://github.com/tgalal/yowsup/archive/master.zip
sudo unzip master.zip
rm master.zip
cd yowsup-config
sudo nano yowsup.config</pre>

Wie bemerkt, ist man nun im Editor für die yowsup.config gelandet. Diese wird nun wie folgt gefüllt:
<pre>## Actual config starts below ##

#cc ist wichtig ansonsten funktioniert es nicht aus dem Script
cc=49
phone=498912345678
id=0000000000
password=</pre>
Ersetze die Nummer 498912345678 gegen eine Festnetz oder Handynummer welche derzeit nicht mit WhatsApp verwendet wird. Mittels STRG+o wird die Datei nun gespeichert und mittels STRG+x verlässt man den Editor.

Vor den weiteren Schritten sollte man nun erstmal die yowsup Verzeichnisse dem fhem-user zugängig machen:
<pre>sudo chown -R fhem:dialout /opt/yowsup-master /opt/yowsup-config</pre>

Für die folgenden Schritte würde ich auf den FHEM-Nutzer wechseln:
<pre>sudo su - fhem
cd /opt/yowsup-master</pre>

Nun erfolgt die Anmeldung am WhatsApp-Server. Dies kann man nun via <code>voice</code> oder <code>sms</code> machen. Bei einem Handy bietet sich SMS an, bei Festnetzanschlüssen sollte voice gewählt werden, wenn man sich nicht sicher ist, dass der Anschluss die Funktion 'SMS im Festnetz' unterstützt. Dann wird der Bestätigungscode zwar auf Englisch vorgelesen, dafür ist die Zuverlässigkeit des Registrierungsvorganges zuverlässiger. Bei Festnetznummern sollte man unbedingt etwas zum schreiben bereit halten!
<pre>python yowsup-cli registration -c /opt/yowsup-config/yowsup.config -r sms</pre>

Die Rückmeldung ist nun entscheidend. Wenn man diese zurückbekommt:
<pre>de sms
status: fail
retry_after: 3600
reason: no_routes</pre>
Dann ist die Nummer so nicht kompatibel. Was man dann noch probieren kann, ist die registration via voice - meistens ist das aber vergebene Liebesmüh'.

Wenn man folgende Rückmeldung bekommt:
<pre>Detected cc: 49
status: sent
retry_after: 1805
length: 6
method: sms</pre>

So ist alles gut gelaufen und man sollte kurz später eine SMS bekommen. Darin ist ein Text, der am Ende z.B. 123-456 lautet. Diesen fügt man ohne Bindestrich am Ende des folgenden Befehls ein:
<pre>python yowsup-cli registration -c /opt/yowsup-config/yowsup.config -R 123456</pre>

Dann kommt ein Text der etwa so aussehen sollte:
<pre>status: ok
kind: free
pw: bfGA9wPWWNeHcSBxxxxxxxxxxxxxxxxx
price: 0,89 €
price_expiration: 1432127524
currency: EUR
cost: 0.89
login: 498912345678
type: existing
expiration: 1460832553</pre>
Den Text hinter dem Zeilenanfang <code>pw: </code> benötigt man nun für die Konfigurationsdatei, wo dieser eingefügt werden muss:
<pre>nano /opt/yowsup-config/yowsup.config</pre>
Sodass die Datei beispielhaft dann so aussieht:
<pre>## Actual config starts below ##

#cc ist wichtig ansonsten funktioniert es nicht aus dem Script
cc=49
phone=498912345678
id=0000000000
password=bfGA9wPWWNeHcSBxxxxxxxxxxxxxxxxx</pre>

Wie man schon gesehen hat, ist der Account nur begrenzt gültig - die Gültigkeit kann man anhand der als <code>expiration: </code> bezeichneten Zeile ablesen, welche einen Unix-Timestamp beinhaltet. Diese kann man [http://elmar-eigner.de/tstamps.html?zeichen=1444570276&timeformat=2 HIER] umrechnen lassen.

Nun mal ein schneller test an die eigene Nummer (im Beispiel 491751234567):
<pre>python yowsup-cli demos -c /opt/yowsup-config/yowsup.config -s 491751234567 "Das ist ein Test"</pre>

Das sollte dir eine Nachricht einbringen. Wenn du darauf antwortest, kommt diese allerdings noch nicht an - der Client hat sich nach dem Befehl sofort beendet. Damit dieser dauerhaft im Hintergrund läuft legen wir nun in FHEM ein Gerät an, welches dies steuert.

=== FHEM Define ===
* Fhem Device anlegen: <code> define <name> yowsup</code>, also z.B. <code>define WhatsApp yowsup</code>
* Nun muss man den Pfad zu yowsup anpassen: <code>attr WhatsApp cmd /opt/yowsup-master/yowsup-cli demos -c /opt/yowsup-config/yowsup.config --yowsup</code>
* Und das Home directory mit dem Pfad zum Home des fhem users: <code>attr WhatsApp home PWD</code>
* Wenn alles gut geht, gibt es danach im Device ein internal PID und das Reading ''state''
* Im Whatsapp Client auf dem Handy sollte man sehen, dass Fhem online ist
* Zum Senden aus Fhem kann man das Kommando <code>set WhatsApp send <nummer> <text></code> verwenden

== Attribute ==
Bitte sehe immer in der [[http://fhem.de/commandref.html#yowsup Commandref]] nach - diese hier könnten veraltet sein.

* <code>cmd</code> komplettes Kommando, um den yowsup Client zu starten. z.B.: <code>attr WhatsApp cmd /opt/local/bin/yowsup-cli demos -c /root/config.yowsup --yowsup</code>
* <code>accept_from</code> kommagetrennte Liste von Kontakten (Nummern), von denen Nachrichten akzeptiert werden. Ist das Attribut nicht gesetzt, so werden die Nachrichten von jedem akzeptiert.
* <code>commandPrefix</code> nicht gesetzt -> es werden keine Befehle akzeptiert. 0 -> es werden keine Befehle akzeptiert. 1 -> erlaubt Befehle, jede Nachricht wird als Fhem-Befehl interpretiert. alles andere -> Wenn die Nachricht mit diesem Prefix startet, wird alles weitere als Befehle interpretiert.
{{Randnotiz|RNTyp=Warn|RNText='''allowedCommands''' should work as intended, but no guarantee can be given, that there is no way to circumvent it.}}
* <code>allowedCommands</code> Eine Komma-getrennte Liste von zulässigen Befehlen für diesen Kontakt. Wenn die Liste leer ist (z.B. nur ein Komma), dann werden keine Befehle akzeptiert.
* <code>home</code> Setzt das Home-directory welches für yowsup verwendet werden soll.

== Befehle ==
* image -> Über diesen Befehl können Bilder gesendet werden.

* raw -> Status ändern :
<code>set WhatsApp raw /profile setStatus 'mein Status' <--- die ' ' müssen bleiben</code>

Name der angezeigt werden soll, wenn eine Nachricht z.B. ans iPhone geschickt wird:

<code>set WhatsApp raw /presence name <DeinNick></code>

Anzeige online :

<code>set WhatsApp raw /presence available</code>

Profilbild ändern :

<code>set WhatsApp raw /profile setPicture '/opt/fhem/fhem_logo.png'</code>
<--- der gesamte Pfad zum Bild muss angegeben werden und Rechte müssen ggfs. bei fhem liegen

Falls es nicht funktioniert disconnect/connect probieren.

== Anwendungsbeispiele ==
=== Beispielnachricht ===
Beim Empfang einer Nachricht wird automatisch ein Fhem Device für diesen Kontakt angelegt. In diesem Device gibt es das Reading '''message''' für die empfangene Nachricht und ab der ersten Nachricht auch das Reading '''chatstate''', in dem zu sehen ist, ob gerade getippt wird.
Nachdem ein Device für einen Kontakt angelegt ist, lässt sich auch direkt dieses Device zum Senden verwenden:
:<code>set <device> send <text></code>,
d.h., man spart sich die Angabe der Nummer.

=== Gruppen ===
Gruppennachrichten werden von yowsup mit Sonderzeichen im Absender empfangen:
: 49yyyyyyyyyyyy/49xxxxxxxxxxx-1234567890
: absender/gründer-timestamp
Aufgrund der Sonderzeichen schlägt das automatische Anlegen einer yowsup Instanz fehl. Es kann aber zum Versenden direkt die JID der Gruppe genutzt werden, oder manuell die yowsup Instanz ohne Sonderzeichen gemacht werden.
: erst kommt die Nummer des Gruppenerstellers, dann die Uhrzeit im Unix Zeitformat.
: 49xxxxxxxxxxx-1234567890
: gründer-timestamp
:<code>define whatsapp.gruppe yowsup 49xxxxxxxxxxx-1234567890</code>
==== JID der Gruppe ermitteln ====
Am einfachsten ist es, eine Nachricht an die Gruppe zu senden und aus der Fehlermeldung von Fhem die JID herauszusuchen.
Etwas gezielter geht es mit der Auflistungsfunktion von yowsup direkt.
:<code>set WhatsApp raw /groups list</code>

Um die Ergebnisse eines raw Befehls im Log zu sehen, muss noch [[verbose]] 4 gesetzt werden:
:<code>attr WhatsApp verbose 4</code>
Dieses Attribut sollte, wenn nicht mehr benötigt, wieder gelöscht werden, um unnötige Logeinträge zu vermeiden.

== Links ==
* {{Link2Forum|Topic=27543|LinkText=Forenthread}}, in dem die Whatsapp Anwendung beschrieben wird
* {{Link2Forum|Topic=27543|Message=299292|LinkText=Foreneintrag}}, ab dem das yowsup Modul beschrieben wird
* Die Python Whatsapp Library auf [https://github.com/tgalal/yowsup github]
* Imagehandling Bugfix [https://github.com/tgalal/yowsup/issues/901 github]

Yowsup

2015-08-03T14:54:40Z

Tdoe: /* Installation */

UWZ

2015-07-25T20:32:55Z

Tdoe: /* Download von Unwetterkarten */

{{Infobox Modul
|ModPurpose=Daten von Unwetterzentrale.de holen
|ModType=contrib
|ModFTopic=33549
|ModCmdRef=ContribModul
|ModForumArea=Unterstützende Dienste
|ModTechName=77_UWZ.pm
|ModOwner=Tobias ({{Link2FU|11054|tdoe}})
}}

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

== Voraussetzungen ==

== Installation ==
Das Modul ist derzeit noch inoffiziell und kann / muss
* aus dem zugehörigen Forenthread (Siehe Zeile "Dokumentation" in der Infobox) geladen werden
* oder über den Befehl <code><nowiki>update 77_UWZ.pm https://raw.githubusercontent.com/tobias-d-oe/fhem-uwz/master/control-uwz.txt</nowiki></code> installiert / aktualisiert werden.

== 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 {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.

 
[[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 {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
*isobaren1
*isobaren2

==== Anzeige von Unwetterkarten ====
Dies erfolgt ebenfalls durch einem weblink.
:<code>define ''UnwetterKarteDeutschland'' weblink htmlCode {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.

== 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

UWZ

2015-07-25T20:29:26Z

Tdoe: /* Download von Unwetterkarten */

{{Infobox Modul
|ModPurpose=Daten von Unwetterzentrale.de holen
|ModType=contrib
|ModFTopic=33549
|ModCmdRef=ContribModul
|ModForumArea=Unterstützende Dienste
|ModTechName=77_UWZ.pm
|ModOwner=Tobias ({{Link2FU|11054|tdoe}})
}}

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

== Voraussetzungen ==

== Installation ==
Das Modul ist derzeit noch inoffiziell und kann / muss
* aus dem zugehörigen Forenthread (Siehe Zeile "Dokumentation" in der Infobox) geladen werden
* oder über den Befehl <code><nowiki>update 77_UWZ.pm https://raw.githubusercontent.com/tobias-d-oe/fhem-uwz/master/control-uwz.txt</nowiki></code> installiert / aktualisiert werden.

== 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 {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.

 
[[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 {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
*isobaren1
*isobaren2

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

==== Download von Unwetterkarten ====
Um die Karten herunterzuladen 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.

== 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

UWZ

2015-07-25T20:28:52Z

Tdoe: /* Anzeige von Unwetterkarten */

{{Infobox Modul
|ModPurpose=Daten von Unwetterzentrale.de holen
|ModType=contrib
|ModFTopic=33549
|ModCmdRef=ContribModul
|ModForumArea=Unterstützende Dienste
|ModTechName=77_UWZ.pm
|ModOwner=Tobias ({{Link2FU|11054|tdoe}})
}}

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

== Voraussetzungen ==

== Installation ==
Das Modul ist derzeit noch inoffiziell und kann / muss
* aus dem zugehörigen Forenthread (Siehe Zeile "Dokumentation" in der Infobox) geladen werden
* oder über den Befehl <code><nowiki>update 77_UWZ.pm https://raw.githubusercontent.com/tobias-d-oe/fhem-uwz/master/control-uwz.txt</nowiki></code> installiert / aktualisiert werden.

== 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 {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.

 
[[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 {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
*isobaren1
*isobaren2

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

=== Download von Unwetterkarten ===
Um die Karten herunterzuladen 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.

== 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

UWZ

2015-07-25T20:26:05Z

Tdoe: /* Download von Unwetterkarten */

{{Infobox Modul
|ModPurpose=Daten von Unwetterzentrale.de holen
|ModType=contrib
|ModFTopic=33549
|ModCmdRef=ContribModul
|ModForumArea=Unterstützende Dienste
|ModTechName=77_UWZ.pm
|ModOwner=Tobias ({{Link2FU|11054|tdoe}})
}}

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

== Voraussetzungen ==

== Installation ==
Das Modul ist derzeit noch inoffiziell und kann / muss
* aus dem zugehörigen Forenthread (Siehe Zeile "Dokumentation" in der Infobox) geladen werden
* oder über den Befehl <code><nowiki>update 77_UWZ.pm https://raw.githubusercontent.com/tobias-d-oe/fhem-uwz/master/control-uwz.txt</nowiki></code> installiert / aktualisiert werden.

== 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 {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.

 
[[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 {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
*isobaren1
*isobaren2

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

=== Download von Unwetterkarten ===
Um die Karten herunterzuladen 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.

== 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

UWZ

2015-07-24T22:18:16Z

Tdoe: /* Anwendungsbeispiele */

{{Infobox Modul
|ModPurpose=Daten von Unwetterzentrale.de holen
|ModType=contrib
|ModFTopic=33549
|ModCmdRef=ContribModul
|ModForumArea=Unterstützende Dienste
|ModTechName=77_UWZ.pm
|ModOwner=Tobias ({{Link2FU|11054|tdoe}})
}}

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

== Voraussetzungen ==

== Installation ==
Das Modul ist derzeit noch inoffiziell und kann / muss
* aus dem zugehörigen Forenthread (Siehe Zeile "Dokumentation" in der Infobox) geladen werden
* oder über den Befehl <code><nowiki>update 77_UWZ.pm https://raw.githubusercontent.com/tobias-d-oe/fhem-uwz/master/control-uwz.txt</nowiki></code> installiert / aktualisiert werden.

== 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 {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.

 
[[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 {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
*isobaren1
*isobaren2

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

=== Download von Unwetterkarten ===
Um die Karten herunterzuladen 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 jedem Lauf erneut heruntergeladen und überschreiben das alte File.

== 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

UWZ

2015-07-22T22:09:45Z

Tdoe: /* 2. AREA_ID abfragen */

UWZ

2015-07-22T22:09:13Z

Tdoe: /* Define */

UWZ

2015-07-22T22:07:38Z

Tdoe: /* 1. Geokoordinaten ermitteln */

UWZ

2015-07-22T22:06:44Z

Tdoe: /* 1. Geokoordinaten ermitteln */

UWZ

2015-07-22T22:05:37Z

Tdoe: /* Define */