Difference between pages "Weather Networks" and "Add-On Services/de"

From meteoplug
(Difference between pages)
Jump to: navigation, search
 
(Updating to match new version of source page)
 
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
−
<languages /><translate>
+
<languages /><br />Der in Meteobridge enthaltene Web-Server kann neben der Realisierung des Administrationsinterfaces auch Anfragen zu den aktuell vorliegenden Wetterdaten beantworten. Es sind zwei URLs definiert, unter denen man diese Daten abrufen kann, entweder als Textdatei oder als XML-Datenstrom. Auch wenn es aus Sicherheitsgründen nicht empfehlenswert ist, diesen Zugang für einen Zugriff von außerhalb des LANs zu öffnen, könnte man beim Aufschalten der Firewall des LANs diese Art der Abfragemöglichkeit für Anfragen von Außen zugänglich machen. Für die Anlieferung von Daten ins Internet empfehlen sich die die unter [[Push_Services/de|Sendedienste]] aufgeführten Methoden.
−
<!--T:1-->
+
−
<br />On this page you define which weather networks will be updated in which intervals with weather data from your weather station. The picture shows upload configuration for Weather Underground as an example.
+
===Live-Daten als XML===
−
<br />
+
Mit dem Meteobridge HTTP-Request wie "http://ip-of-meteobridge/cgi-bin/livedataxml.cgi", wobei "ip-of-meteobridge" durch die korrekte IP der Meteobridge ersetzt werden muss, liefert Meteobridge Wetterdaten in XML-Notation aus. Die von Meteobridge erzeugte Ausgabe beginnt mit "<logger>" und endet mit "</logger>". Die Werte der Sensoren werden mit den sensorspezifischen Tags "THB", "TH", "WIND", "RAIN", "UV", "SOLAR" berichtet. Das anhängende Beispiel illustriert das XML-Format:
  
−
<!--T:2-->
+
<pre><logger>
−
[[File:page2.png]]
+
  <THB date="20121227224318" id="thb0" temp="26.0" hum="37" dew="10.2"
 +
      press="1008.8" seapress="1010.1" fc="2"/>
 +
  <TH date="20130104141909" id="th0" temp="9.1" hum="95" dew="8.3"/>
 +
  <RAIN date="20130104141856" id="rain0" rate="0.0" total="3.0" delta="0.0"/>
 +
  <WIND date="20130104141916" id="wind0" dir="109" gust="0.9" wind="2.2" chill="9.1"/>
 +
</logger></pre>
  
−
==Upload Interval== <!--T:3-->
+
Jedes Sensordatenpaket enthält immer die Felder "date" und "id". Die anderen Parameter sind sensorspezifisch. Die Bedeutung der Parameter ist wie folgt:
−
You can specify upload intervals from every 5 seconds of up to every hour, when you want to keep your outgoing traffic low. Meteobridge makes use of "rapid fire mode" of Weather Underground when data is sent more than once a minute.  
+
* '''date''': UTC Zeitstempel der Sensordaten im Format "JJJJMMTThhmmss"
 +
* '''id''': ID des Sensors, die aus einem Sensorkurzbezeichnung gefolgt von einer Zahl ("0") besteht.
 +
* '''temp''': Temperatur in Grad Celsius (mit einer Nachkommastelle)
 +
* '''hum''': Relative Luftfeuchte in Prozent (keine Nachkommastellen)
 +
* '''dew''': Taupunkttemperatur in Grad Celsius (mit einer Nachkommastelle)
 +
* '''press''': Luftdruck auf Stationshöhe ohne Höhenkorrektur in hPa (mit einer Nachkommastelle)
 +
* '''seapress''': Luftdruck auf Meeresspiegelhöhe zurückgerechnet in hPa (mit einer Nachkommastelle)
 +
* '''fc''': Vorhersage, sofern von der Wetterstation bereitgestellt. Da dieser Wert wenig zuverlässig ist, raten wir davon ab, diesen zu verwenden.
 +
* '''rate''': Regenrate in mm pro Stunde (mit einer Nachkommastelle).
 +
* '''total''': Aktueller Wert des Regenwippenzählers umgerechnet auf mm (mit einer Nachkommastelle).
 +
* '''delta''': Hinzugekommene Regenmenge in mm seit dem letzten Auslesen (mit einer Nachkommastelle).
 +
* '''wind''': Aktuelle gemittelte Windgeschwindigkeit im m/s (mit einer Nachkommastelle).
 +
* '''gust''': Aktuelle, nicht gemittelte Windgeschwindigkeit in m/s (mit einer Nachkommastelle).
 +
* '''dir''': Windrichtung in Grad (0-359, keine Nachkommastellen).
 +
* '''chill''': Windchill-Temperatur in Grad Celsius (mit einer Nachkommastelle).
 +
* ...
  
−
<!--T:4-->
+
===Live-Daten als Textdatei===
−
Drop-down list on the right allows you to specify how many retries should be processed, when upload of a record does fail.
+
Mit dem HTTP-Request "http://ip-of-meteobridge/cgi-bin/livedata.cgi", wobei "ip-of-meteobridge" durch die IP der Meteobridge zu ersetzen ist, gibt Meteobridge die aktuellen Sensorwerte als Textdatei aus. Das Ergebnis besteht aus einer Reiehe von Zeilen, die jeweils einen Sensor mit seinen Werten repräsentieren. Die Struktur ist gleich der XML-Daten im vorangegangenen Abschnitt, jedoch ohne die umgebende XML-Struktur:
  
−
==ID and Password== <!--T:5-->
+
<pre>20130104142614 thb0 26.9 38 11.4 1020.4 1021.7 2
−
When you selected an upload interval Meteobridge also needs your weather networks user ID and password, as most weather networks do need this to autehnticate your data uplaod.
+
20130104142610 rain0 0.0 3.0 0.0
−
Please don't use special characters in the password as this is known to be error-prone when used in URLs and/or web input fields.
+
20130104142636 th0 9.1 95 8.3
 +
20130104142652 wind0 160 2.2 1.8 8.0</pre>
  
−
<!--T:6-->
+
===Data via Socket Connection===
−
The Weather network icon on the right is clickable and does bring you to the weather network's home page where you can assign for an account and when you are already listed there the link might directly lead to your account and display of data you have uploaded so far.
+
Methods introduced above do need HTTP authentification like all elements of Meteobridge web interface. A look at the script "livedataxml.cgi" shows that this just reads data from socket 5557, gives it a suitable HTTP header and returns that to the requesting browser:
  
−
==Submit Changes== <!--T:7-->
+
<pre>#!/bin/sh
−
When you press "Save" your settings are stored permanently and Meteobridge does test for all weather networks with valid upload intervals, if the weather network accepts your credentials a green mark will be displayed beside user ID and password of the corresponding weather network. If credentials are not accepted, weather network will be marked with red crosses beside user ID and password.
+
echo -ne "Content-type: text/xml; charset=UTF-8\n\n"
 +
nc 127.0.0.1 5557 2>/dev/null
 +
</pre>
  
−
==Additional Weather Networks== <!--T:8-->
+
Therefore, reading data from socket 5557 is equivalent to calling "livedataxml.cgi" and socket 5556 reports same data as delivered by "livedata.cgi".
−
Beside the weather network that is displayed as default you can select from the following list of weather networks presented by the drop-down menu "Add more Weather Networks":
+
−
* '''Weather Underground'''
+
−
* '''AWEKAS'''
+
−
* '''WeatherBug Backyard'''
+
−
* '''WeatherForYou (also known as PWSweather)'''
+
−
* '''UK MetOffice WOW'''
+
−
* '''Windfinder'''
+
−
* '''Citizen Weather Observer Program (CWOP)'''
+
−
* '''Open Weather Map'''
+
−
 
+
−
<!--T:9-->
+
−
Additionally selected networks will remain visible inside the web interface as long as they have a upload schema defined. When upload is disabled the network will disappear from the web interface and needs to be selected by the drop-down box again, when you want to use it. This helps to keep not needed entries away from the web interface and prevents you from scrolling long list with items you don't need.  
+
−
</translate>
+

Revision as of 09:54, 20 April 2013


Der in Meteobridge enthaltene Web-Server kann neben der Realisierung des Administrationsinterfaces auch Anfragen zu den aktuell vorliegenden Wetterdaten beantworten. Es sind zwei URLs definiert, unter denen man diese Daten abrufen kann, entweder als Textdatei oder als XML-Datenstrom. Auch wenn es aus Sicherheitsgründen nicht empfehlenswert ist, diesen Zugang für einen Zugriff von außerhalb des LANs zu öffnen, könnte man beim Aufschalten der Firewall des LANs diese Art der Abfragemöglichkeit für Anfragen von Außen zugänglich machen. Für die Anlieferung von Daten ins Internet empfehlen sich die die unter Sendedienste aufgeführten Methoden.

Live-Daten als XML

Mit dem Meteobridge HTTP-Request wie "http://ip-of-meteobridge/cgi-bin/livedataxml.cgi", wobei "ip-of-meteobridge" durch die korrekte IP der Meteobridge ersetzt werden muss, liefert Meteobridge Wetterdaten in XML-Notation aus. Die von Meteobridge erzeugte Ausgabe beginnt mit "<logger>" und endet mit "</logger>". Die Werte der Sensoren werden mit den sensorspezifischen Tags "THB", "TH", "WIND", "RAIN", "UV", "SOLAR" berichtet. Das anhängende Beispiel illustriert das XML-Format: 

<logger>
  <THB date="20121227224318" id="thb0" temp="26.0" hum="37" dew="10.2" 
       press="1008.8" seapress="1010.1" fc="2"/>
  <TH date="20130104141909" id="th0" temp="9.1" hum="95" dew="8.3"/>
  <RAIN date="20130104141856" id="rain0" rate="0.0" total="3.0" delta="0.0"/>
  <WIND date="20130104141916" id="wind0" dir="109" gust="0.9" wind="2.2" chill="9.1"/>
</logger>

Jedes Sensordatenpaket enthält immer die Felder "date" und "id". Die anderen Parameter sind sensorspezifisch. Die Bedeutung der Parameter ist wie folgt:

  • date: UTC Zeitstempel der Sensordaten im Format "JJJJMMTThhmmss"
  • id: ID des Sensors, die aus einem Sensorkurzbezeichnung gefolgt von einer Zahl ("0") besteht.
  • temp: Temperatur in Grad Celsius (mit einer Nachkommastelle)
  • hum: Relative Luftfeuchte in Prozent (keine Nachkommastellen)
  • dew: Taupunkttemperatur in Grad Celsius (mit einer Nachkommastelle)
  • press: Luftdruck auf Stationshöhe ohne Höhenkorrektur in hPa (mit einer Nachkommastelle)
  • seapress: Luftdruck auf Meeresspiegelhöhe zurückgerechnet in hPa (mit einer Nachkommastelle)
  • fc: Vorhersage, sofern von der Wetterstation bereitgestellt. Da dieser Wert wenig zuverlässig ist, raten wir davon ab, diesen zu verwenden.
  • rate: Regenrate in mm pro Stunde (mit einer Nachkommastelle).
  • total: Aktueller Wert des Regenwippenzählers umgerechnet auf mm (mit einer Nachkommastelle).
  • delta: Hinzugekommene Regenmenge in mm seit dem letzten Auslesen (mit einer Nachkommastelle).
  • wind: Aktuelle gemittelte Windgeschwindigkeit im m/s (mit einer Nachkommastelle).
  • gust: Aktuelle, nicht gemittelte Windgeschwindigkeit in m/s (mit einer Nachkommastelle).
  • dir: Windrichtung in Grad (0-359, keine Nachkommastellen).
  • chill: Windchill-Temperatur in Grad Celsius (mit einer Nachkommastelle).
  • ...

Live-Daten als Textdatei

Mit dem HTTP-Request "http://ip-of-meteobridge/cgi-bin/livedata.cgi", wobei "ip-of-meteobridge" durch die IP der Meteobridge zu ersetzen ist, gibt Meteobridge die aktuellen Sensorwerte als Textdatei aus. Das Ergebnis besteht aus einer Reiehe von Zeilen, die jeweils einen Sensor mit seinen Werten repräsentieren. Die Struktur ist gleich der XML-Daten im vorangegangenen Abschnitt, jedoch ohne die umgebende XML-Struktur: 

20130104142614 thb0 26.9 38 11.4 1020.4 1021.7 2
20130104142610 rain0 0.0 3.0 0.0
20130104142636 th0 9.1 95 8.3
20130104142652 wind0 160 2.2 1.8 8.0

Data via Socket Connection

Methods introduced above do need HTTP authentification like all elements of Meteobridge web interface. A look at the script "livedataxml.cgi" shows that this just reads data from socket 5557, gives it a suitable HTTP header and returns that to the requesting browser: 

#!/bin/sh
echo -ne "Content-type: text/xml; charset=UTF-8\n\n"
nc 127.0.0.1 5557 2>/dev/null

Therefore, reading data from socket 5557 is equivalent to calling "livedataxml.cgi" and socket 5556 reports same data as delivered by "livedata.cgi".

Retrieved from "https://wiki.meteoplug.com/wiki/index.php?title=Weather_Networks&oldid=1950"