Beschreibung
Gira X1 - Logikbaustein | Open Weather Map
API Zugang und Registrierung:
Der API-Schlüssel (API Key) kann unter OpenWeather Map API generiert werden.
Die aktuelle “FREE” Konto-Einschränkung bietet:
- 60 Anfragen pro Minute
- 1,000,000 Anfragen pro Monat
API 2.5 und API 3.0 Unterschiede
OpenWeather bietet zwei Versionen ihrer API: 2.5 und 3.0. Die API 2.5 umfasst grundlegende Wetterabfragen und ist für viele private Anwendungen ausreichend. Die API 3.0 hingegen erfordert einen kostenpflichtigen Plan und bietet erweiterte und detailliertere Wetterinformationen.
Die 3.0 API nutzt das Modell „Pay as you call“:
- 1,000 API-Aufrufe pro Tag sind kostenlos.
- Kosten von 0,0014 EUR pro API-Aufruf fallen erst an, wenn das Tageslimit von 1.000 Aufrufen überschritten wird.
- In den Einstellungen lässt sich eine Grenze festlegen, sodass der Baustein die 1.000 täglichen Anfragen nicht überschreitet und damit zusätzliche Kosten verhindert werden können.
- Wettervorhersagen: Wetterdaten von +3 Stunden bis +48 Stunden, einschließlich Niederschlagswahrscheinlichkeit in %.
- Wetterwarnungen: Daten zu Wetterwarnungen aus nationalen Wetterwarnsystemen.
| Bezeichnung | Porttyp | Beschreibung |
|---|---|---|
| Trigger | Binary | Über den Trigger kann festgelegt werden, wann die Werte abgefragt werden.Vor dem Trigger einen Oszillator (z.B. alle 10m, 1s).10 Minuten Intervall ist die Empfehlung von Openweather. |
| Bezeichnung | Porttyp | Als Eingang zuschaltbar? | Beschreibung |
|---|---|---|---|
| IP-Adresse | string | nein | IPv4 Adresse im Format: z.B. 192.168.0.100 |
| Sprache | Enum | nein | Sie können den Parameter verwenden, um die Ausgabe aus OWM in Ihrer Sprache zu erhalten. |
| Maßeinheit | Enum | nein | Standard-, metrische und imperiale Einheiten sind verfügbar. |
| API key | String | nein | Openweather Map, API Key Referenz: https://openweathermap.org/api |
| Modus | String | nein | Abfrage der Wetterdaten über 2 API Call Varianten. |
| Vorhersage | Enum | nein | Wettervorhersage über +3h,6h,9h,12h,24h,48h |
| Bezeichnung | Porttyp | Beschreibung |
|---|---|---|
| Temperatur | Double | derzeitige Tagestemperatur (gerundet auf 1 Kommastelle) |
| gefühlte Temperatur | Double | derzeitige gefühlte Tagestemperatur (gerundet auf 1 Kommastelle) |
| Temperatur (min.) | Double | Mindest-Tagestemperatur (gerundet auf 1 Kommastelle) |
| Temperatur (max.) | Double | |
| Temperatur Morgens | Double | |
| Temperatur abends | Double | |
| Temperatur Nacht | Double | |
| Sonnenaufgang | Time | |
| Sonnenuntergang | Time | |
| Mondaufgang | Time | |
| Monduntergang | Time | |
| Luftdruck | Integer | in hPa |
| Luftfeuchtigkeit | Integer | in % |
| Bewölkung | Integer | Bewölkung in % |
| Wind (m/s) | float | Windgeschwindigkeit in m/s |
| Wind (km/h) | float | Windgeschwindigkeit in km/h |
| Windrichtung | Integer | Windrichtung in ° |
| Windböen | float | Windböen im m/s |
| Niederschlag Wahrscheinlichkeit | double | Niederschlagswahrscheinlichkeit |
| Regen | double | Regen Niederschlagsmenger in mm + Wahrscheinlichkeit in mm. |
| Schnee | double | Schnee, Niederschlagsmenge in mm + Wahrscheinlichkeit in mm. |
| Regenalarm | bool | bei Regen, steht Ihnen dieses Flag zur Verfügung, um weitere Logiken als Trigger anzusteuern. |
| Schneealarm | bool | bei Schnee, steht Ihnen dieses Flag zur Verfügung, um weitere Logiken als Trigger anzusteuern. |
| UV-Index | double | Der maximale Wert des UV-Index für den Tag |
| Vorhersage +3h | string | Wettervorschau +3h Ausgabeformat: Niederschlagswahrscheinlichkeit-Temperatur-Windgeschwindigkeit |
| ☂40% - 29,6°c - 🌬7,5km/h | ||
| wenn die Niederschlagsmenge Regen > 0, dann steht zusätzlich die Menge in mm hinter der Niederwahrscheinlichkeit. |