eolab:weather_station:kamp-lintfort:start
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
eolab:weather_station:kamp-lintfort:start [2024/03/23 18:57] – removed - external edit (Unknown date) 127.0.0.1 | eolab:weather_station:kamp-lintfort:start [2024/03/23 18:57] (current) – ↷ Links adapted because of a move operation rolf.becker | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ~~NOTOC~~ | ||
+ | ====== HSRW Weather Station at Campus Kamp-Lintfort ====== | ||
+ | |||
+ | |||
+ | | {{ eolab: | ||
+ | | //Fig.: HSRW Weather Station, Campus Kamp-Lintfort// | ||
+ | |||
+ | |||
+ | ===== Interactive Grafana Dashboard of Real-Time Weather Data ===== | ||
+ | |||
+ | | [[http:// | ||
+ | | Fig.: Interactive real-time data plots. **Click on the image** or **[[http:// | ||
+ | |||
+ | /* | ||
+ | :!: The the real-time data graphs are provided on our ** [[http:// | ||
+ | */ | ||
+ | |||
+ | |||
+ | /* | ||
+ | ===== Description ===== | ||
+ | ... | ||
+ | */ | ||
+ | |||
+ | |||
+ | ===== The Sensors of the Weather Station ===== | ||
+ | |||
+ | |||
+ | ^ Measurement | ||
+ | | Temperature | ||
+ | | Temperature / Humidity | ||
+ | | Wind Speed | Cup anemometer, TF type 4035 | {{ eolab: | ||
+ | | Wind Direction | ||
+ | | Barometer | ||
+ | | Precipitation | ||
+ | | Soil Moisture | ||
+ | | Photosynthetically Active Radiation | ||
+ | | Solar Radiation | ||
+ | |||
+ | ====== Accessing the Real-Time Online Data ====== | ||
+ | |||
+ | |||
+ | The data of our weather station is **freely available**! \\ We provide two main channels to access the data: | ||
+ | |||
+ | - MQTT (through our own broker !!Currently offline due to server maintenance!! ), | ||
+ | - RESTful API | ||
+ | |||
+ | The accessible variables: | ||
+ | |||
+ | ^ Key ^ Unit ^ Comment | ||
+ | | wind_speed | ||
+ | | wind_direction | ||
+ | | air_temperture | ||
+ | | air_relhumidity | ||
+ | | smp10 | W/m2 | | | ||
+ | | pqsl | µmol/ | ||
+ | | soil_moisture | ||
+ | | soil_tempblue | ||
+ | | soil_tempred | ||
+ | | air_pressure | ||
+ | | precipitation | ||
+ | | created_at | ||
+ | |||
+ | ===== MQTT Broker and Topic for Subscribing to Real-Time Online Data ===== | ||
+ | |||
+ | We also publish our data on our own MQTT Server which doesn' | ||
+ | |||
+ | ^ MQTT Broker and Topic || | ||
+ | ^ URL | eolab.de | ||
+ | ^ PORT | 1883 | | ||
+ | ^ TOPIC | weather/ | ||
+ | |||
+ | |||
+ | ===== RESTful API to Request Real-Time Online Data ===== | ||
+ | |||
+ | The RESTful Application Programming Interface (API) is used to download data or retrieve data e.g. in own programs or scripts. \\ The data is provided in a JSON-format. | ||
+ | |||
+ | |||
+ | |||
+ | ==== Examples (response takes some time) ===== | ||
+ | |||
+ | Get the recent 20 measurements: | ||
+ | '' | ||
+ | |||
+ | Retrieve the last 20 sensor data from all sensors since 12th Nov. 2021, 14:55:32, Central European Time (CET, Germany): \\ '' | ||
+ | |||
+ | Retrieve every fifth measurement from all sensors between two timestamps (date + time): \\ | ||
+ | '' | ||
+ | |||
+ | Second timestamp in milliseconds since 1970-01-01 00:00:00 UTC (Universal Time Coordinates ~ Greenwich Mean Time) \\ | ||
+ | '' | ||
+ | |||
+ | |||
+ | ==== API Documentation ==== | ||
+ | |||
+ | The API is now available under '' | ||
+ | The API server source code can be found on Github: [[https:// | ||
+ | |||
+ | Two different **timestamp (date + time) types** are supported: | ||
+ | * time in ms since 1970-01-01 00:00:00 UTC | ||
+ | * [[https:// | ||
+ | |||
+ | The ISO8601 date-time standards can have different formats. A common one is: '' | ||
+ | Z is the offset from the UTC timezone, e.g. '' | ||
+ | The same timestamp in UTC: '' | ||
+ | |||
+ | |||
+ | The routes of the API: | ||
+ | |||
+ | * **''/'' | ||
+ | * **''/ | ||
+ | * **''/ | ||
+ | * **''/ | ||
+ | * :!:do not misuse this route:!: | ||
+ | * / | ||
+ | * Get every nth measurement between begin and end | ||
+ | * :begin and :end have to be replaced by the time in ms since 01.01.1970 00:00:00 UTC | ||
+ | * :n has to be replaced with a number (ex.: get every 3rd measurement) | ||
+ | |||
+ | Example to retrieve every 5th data set between 627650252438 ms and 1627650855553 ms since 1970-01-01, i.e. from the Fri Jul 30 2021 15:04:12 GMT+0200 to Fri Jul 30 2021 15:14:15 GMT+0200: | ||
+ | '' | ||
+ | |||
+ | <WRAP center round tip 60%> | ||
+ | API Requests are limited to 100 requests per 15 minutes per IP | ||
+ | </ | ||
+ | |||
+ | |||