Difference between revisions of "Add-On Services/de"

From meteoplug
Jump to: navigation, search
(Created page with "<br />Der in Meteobridge enthaltene Web-Server kann neben der Realisierung des Administrationsinterfaces auch Anfragen zu den aktuell vorliegenden Wetterdaten beantworten. Es ...")
(Created page with "Jedes Sensordatenpaket enthält immer die Felder "date" und "id". Die anderen Parameter sind sensorspezifisch. Die beudtung der Parameter ist wie folgt: * '''date''': UTC Zeit...")
Line 13: Line 13:
 
</logger></pre>
 
</logger></pre>
  
Each sensor data record has a mandatory "date" and "id" parameter. The other parameters are sensor specific. Meaning of parameters is:
+
Jedes Sensordatenpaket enthält immer die Felder "date" und "id". Die anderen Parameter sind sensorspezifisch. Die beudtung der Parameter ist wie folgt:
* '''date''': UTC timestamp of reception of sensor data in format "YYYYMMDDhhmmss"
+
* '''date''': UTC Zeitstempel der Sensordaten im Format "JJJJMMTThhmmss"
* '''id''': Unique ID of sensor, consists of a sensor type description shortcut followed by a number, which is always "0" in Meteobridge, as additional sensors are not supported
+
* '''id''': ID des Sensors, die aus einem Sensorkurzbezeichnung gefolgt von einer Zahl ("0") besteht.
* '''temp''': temperature in degrees Celsius (with one decimal)
+
* '''temp''': Temperatur in Grad Celsius (mit einer Nachkommastelle)
* '''hum''': relative humidity in percent (no decimals)
+
* '''hum''': Relative Luftfeuchte in Prozent (keine Nachkommastellen)
* '''dew''': dew point temperature in degrees Celsius (with one decimal)
+
* '''dew''': Taupunkttemperatur in Grad Celsius (mit einer Nachkommastelle)
* '''press''': station pressure (without altitude correction) in hPa (with one decimal)
+
* '''press''': Luftdruck auf Stationshöhe ohne Höhenkorrektur in hPa (mit einer Nachkommastelle)
* '''seapress''': normalized pressure with altitude correction (also called sea level pressure) in hPa (with one decimal)
+
* '''seapress''': Luftdruck auf Meeresspiegelhöhe zurückgerechnet in hPa (mit einer Nachkommastelle)
* '''fc''': stations forecast code, if provided. As this has low evidence and also largely varies between stations, meteobridge does not recommend to make use of this data.
+
* '''fc''': Vorhersage, sofern von der Wetterstation bereitgestellt. Da dieser Wert wenig zuverlässig ist, raten wir davon ab, diesen zu verwenden.
* '''rate''': measured rain rate in mm per hour (with one decimal).
+
* '''rate''': Regenrate in mm pro Stunde (mit einer Nachkommastelle).
* '''total''': current value of rain bucket counter, converted to mm (with one decimal).
+
* '''total''': Aaktueller Wert des Regenwippenzählers umgerechnet auf mm (mit einer Nachkommastelle).
* '''delta''': additional rain fall in mm since previous readout of this data (with one decimal).
+
* '''delta''': Hinzugekommene Regenmenge in mm seit dem letzten Auslesen (mit einer Nachkommastelle).
* '''wind''': current average wind speed im m/s (with one decimal).
+
* '''wind''': Aktuelle gemittelte Windgeschwindigkeit im m/s (mit einer Nachkommastelle).
* '''gust''': curent not avergaed wind speed in m/s (with one decimal).
+
* '''gust''': Aktuelle, nicht gemittelte Windgeschwindigkeit in m/s (mit einer Nachkommastelle).
* '''dir''': wind direction in degrees (0-359, no decimals).
+
* '''dir''': Windrichtung in Grad (0-359, keine Nachkommastellen).
* '''chill''': wind chill temperature in degrees Celsius (with one decimal).
+
* '''chill''': Windchill-Temperatur in Grad Celsius (mit einer Nachkommastelle).
 
* more to come...
 
* more to come...
  

Revision as of 23:17, 25 February 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 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 gelieferte Antwort beginnt mit "<logger>" und endet mit "</logger>". Die Wrte 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 beudtung 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: Aaktueller 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).
  • more to come...

Live Data as Plain Text

By sending the meteobridge a HTTP request like "http://ip-of-meteobridge/cgi-bin/livedata.cgi" (where "ip-of-meteobridge" must be replaced by the IP itself) meteobridge returns current weather data as plain text. Each reply consists of a series of lines, where each line represnets a sensor. Lines do start with a time stamp and a unique sensor id followed by sensor specific parameters. Example below illustrates the format:

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