UWZ: Unterschied zwischen den Versionen

ContribModul
Zweck / Funktion
	Daten von Unwetterzentrale.de holen
Allgemein
Typ	Contrib
Details
Dokumentation	Thema
Support (Forum)	Unterstützende Dienste
Modulname	77_UWZ.pm
Ersteller	Tobias (tdoe )
	Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

Version vom 24. Juli 2015, 10:56 Uhr

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 update 77_UWZ.pm https://raw.githubusercontent.com/tobias-d-oe/fhem-uwz/master/control-uwz.txt 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

define <name> UWZ <Ländercode> <PLZ> <INTERVAL>

Rest der Welt

define <name> UWZ <Ländercode> <AREA_ID> <INTERVAL>

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:

http://alertspro.geoservice.meteogroup.de/weatherpro/SearchFeed.php?search=oberwalt

Als Antwort bekommt man eine XML Struktur mit gefundenen Orten:

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

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:

latitude="47.9756"

longitude="16.3203"

AREA_ID abfragen

Mit diesen Werten wird nun die nächste URL zusammengebaut (Parameter lat + lon):

http://feed.alertspro.meteogroup.com/AlertsPro/AlertsProPollService.php?method=lookupCoord&lat=47.9756&lon=16.3203

Das Resultat:

[{"AREA_TYPE":"UWZ","AREA_ID":"UWZAT00234","CENTER_ID":"2"}]

Nun wissen wir, dass die AREA_ID für Oberwaltersdorf:

UWZAT00234

ist. Bei der Definition wird nun die Nummer 00234 anstelle der PLZ, und AT beim Ländercode verwendet:

define Unwetterzentrale UWZ AT 00234 3600

Attribute

Siehe Dokumentation.

Anwendungsbeispiele

Zur Anzeige der Warnhinweise bietet das Modul vordefinierte Funktionen an, die in Weblinks benutzt werden können.

Warnmeldungen als reine Icons (Format UWZAsHtmlFP) mit Teilen der Objektdetails

Anzeige der Warnhinweise nur als Icon

Die UWZ-Warnhinweise können über die Definition

define UnwetterFloorplan weblink htmlCode {UWZAsHtmlFP("Unwetterzentrale")}

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.

Warnmeldungen im Format UWZAsHtml

Detaillierte Anzeige der Warnhinweise

Zur Anzeige der Warnhinweise in der ausführlichsten Form kann mit

define UnwetterDetailliert weblink htmlCode {UWZAsHtml("Unwetterzentrale")}

ein weblink definiert werden.

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

Links

Unwetterzentrale (für Deutschland)
wetteralarm (für Österreich)
Geoservice [1] zur Bestimmung von Geokoordinaten und Areacode

@@ Zeile 66: / Zeile 66: @@
 == Anwendungsbeispiele ==
+Zur Anzeige der Warnhinweise bietet das Modul vordefinierte Funktionen an, die in [[weblink|Weblinks]] benutzt werden können.
+<!-- Beispiele für UWZAsHtmlLite und UWZAsHtmlKarteLand werden ergänzt, sobald (zur Erhöhung der Variationen) andere/mehr/weniger Warnhinweise vorliegen -->
+[[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.
+<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 {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.
 == Links ==