ioBroker.open-meteo-weather

Wichtige Information:

Open Meteo Weather und Open Meteo PV Forecast wurden in diesen Adapter integriert. Open Meteo PV Forecast wird nicht mehr weiterentwickelt.

Dieser Adapter nutzt die Sentry-Bibliotheken, um Ausnahmen und Codefehler automatisch an die Entwickler zu melden. Weitere Informationen und Anweisungen zum Deaktivieren der Fehlerberichterstattung finden Sie in der Sentry-Plugin-Dokumentation . Die Sentry-Berichterstattung wird ab js-controller 3.0 unterstützt.

Ich nutze meinen eigenen Sentry-Server, der auf Glitchtip basiert.

Der Open-Meteo Wetter- und PV-Vorhersagedienst-Adapter für ioBroker.

Dieser Adapter liefert präzise Wetterdaten, Vorhersagen, Informationen zur Luftqualität sowie Pollen- und Photovoltaik-Vorhersagen von Open-Meteo.com . Er ist für nicht-kommerzielle Zwecke (bis zu 10.000 API-Aufrufe pro Tag) kostenlos und erfordert keine API-Schlüsselregistrierung, wodurch die Einrichtung extrem einfach ist.

Sollten beim Adapter Probleme wie Timeouts oder Serverfehler auftreten, können Sie den Open-Meteo-Serverstatus überprüfen.

Wettermerkmale

• Aktuelle Wetterdaten: Echtzeitabruf von Temperatur-, Feuchtigkeits-, Luftdruck- und Winddaten.
• 15-Minuten-Vorhersage mit maximal 16 Datensätzen für die nächsten 4 Stunden.
• Flexible Prognosen: Konfigurierbare Anzahl an Prognosetagen und stündliche Auflösung.
• Luftqualität & Pollen: Optionale Daten zu Feinstaub (PM2,5, PM10) sowie zu verschiedenen Pollenarten (Erle, Birke, Gras usw.).
• Automatische Bereinigung: Der Adapter bereinigt die Objektstruktur automatisch, wenn Prognosezeiträume verkürzt oder in der Konfiguration geändert werden.
• Mehrsprachige Unterstützung: Unterstützt 11 Sprachen (darunter Englisch, Deutsch, Polnisch, Russisch, Französisch, Chinesisch usw.).
• Einheitensystem: Nahtloses Umschalten zwischen metrischen (°C, km/h) und imperialen (°F, mph) Systemen.
• Mehrere Standorte: Mehrere Standorte hinzufügen.
• Nachtsymbole: Sie können zwischen zwei Nachtsymbolsets wählen, „Hell“ und „Dunkel“. Dadurch wird es einfacher, das Symbol an Ihren Hintergrund anzupassen.

Windrichtungssymbole

In den Adaptereinstellungen können Sie zwischen zwei verschiedenen Visualisierungsstilen für die Windrichtung wählen:

• Windrichtung (wohin der Wind weht): Dies ist die Standardeinstellung. Der Pfeil zeigt in die Richtung, aus der der Wind kommt. (Beispiel: Bei Nordwind zeigt der Pfeil nach Süden).

• Windherkunft (woher der Wind kommt): Dieser Stil verwendet Symbole aus dem Unterordner direct_2. Der Pfeil zeigt die Windquelle an. (Beispiel: Ein Nordwind wird durch einen nach Norden zeigenden Pfeil oder ein spezifisches „Herkunfts“-Symbol dargestellt).

Daten zur Luftqualität

Der Adapter liefert aktuelle Luftqualitätsdaten und eine tägliche Vorhersage für die kommenden Tage (konfigurierbar für 1, 3 oder 6 Tage).

Effiziente Datenverarbeitung: Während die Open-Meteo-API lediglich stündliche Rohdaten liefert, aggregiert dieser Adapter diese Werte intelligent. Er berechnet automatisch die Tageshöchstwerte für alle Schadstoffe und Pollenkonzentrationen. So erhalten Sie die relevantesten Daten (Spitzenwerte der Belastung), ohne Ihre Datenbank mit Hunderten von stündlichen Datenpunkten zu überladen.

Merkmale:

• Tägliche Spitzenwerte: Ermitteln Sie den höchsten erwarteten Wert für PM2,5, PM10, Ozon und verschiedene Pollenarten.

• Für Menschen lesbar: Die Pollenkonzentrationen werden automatisch beschreibenden Kategorien zugeordnet (z. B. „Keine“, „Niedrig“, „Mittel“, „Hoch“).

• Intelligente Bereinigung: Objekte für Vorhersagetage werden basierend auf Ihren Einstellungen automatisch erstellt oder entfernt, um Ihre Objektstruktur übersichtlich zu halten.

Konfiguration

Konfigurieren Sie nach der Installation die folgenden Felder in den Instanzeinstellungen:

1. Ort: Geben Sie Ihren Ort oder einen gewünschten Namen ein.
2. Koordinaten (Breitengrad & Längengrad): Geben Sie Ihre Koordinaten ein. Sie finden diese, indem Sie auf die Schaltfläche „Koordinaten mit OpenStreetMap finden“ klicken, oder lassen Sie die Felder leer, um die Systemkoordinaten zu verwenden.
3. Zeitzone: Stellen Sie die Zeitzone im Dropdown-Menü ein. Standardmäßig ist „Auto“ eingestellt, was bedeutet, dass die Zeitzone automatisch anhand Ihrer Koordinaten angepasst wird.
4. Aktualisierungsintervall: Zeitintervall in Minuten (Standard: 30 min).
5. Vorhersagetage: Anzahl der Tage für die tägliche Übersicht (0–16 Tage).
6. Stündliche Vorhersage: Aktivieren oder deaktivieren Sie diese Option und legen Sie die Anzahl der Stunden fest (z. B. die nächsten 24 Stunden). Beispielsweise ist Stunde 0 die aktuelle Stunde, Stunde 1 die nächste Stunde usw.
7. Optionale Daten: Kontrollkästchen für Pollen- und Luftqualitätsdaten.
8. Einheiten: Wählen Sie zwischen metrischen und imperialen Einheiten.

Wetter-Widget

Dieser Adapter bietet zwei Möglichkeiten zur Darstellung von Wetterdaten in Ihrer Visualisierung:

1. Integriertes Widget (Standard)

Seit Version 3.1.0 kann der Adapter automatisch ein vorkonfiguriertes HTML-Widget für jeden Standort generieren.

Anwendung:

1. Aktivieren: Aktivieren Sie das Kontrollkästchen „Widget erstellen“ in den Instanzeinstellungen für Ihren Standort.
2. Zustand finden: Der Adapter erstellt einen Zustand namenshtmlWidget (unteropen-meteo-weather.0.yourLocation.htmlWidget ).
3. In VIS/VIS2: * Ziehen Sie ein Standard- „HTML“-Widget in Ihre Ansicht.
   • Weisen Sie der "HTML"-Eigenschaft dieses Widgets die Bindung Ihres Zustands zu:{open-meteo-weather.0.yourLocation.htmlWidget} Die
   • Passen Sie Breite und Höhe des Widget-Containers an den Inhalt an.

Anpassung: In der Adapterkonfiguration können Sie lediglich grundlegende Einstellungen wie Schriftgrößen, Vorhersagestunden und -tage direkt anpassen.

Ideal für: Anwender, die ein schnelles, ansprechendes und wartungsfreies Display wünschen.

Hinweis: Für eine optimale Darstellung in Desktop-Browsern sollten Sie in den VIS-Editor-Einstellungen keine zusätzlichen CSS-Rahmen oder Schatten verwenden. Das Widget verfügt über ein eigenes, optimiertes Styling.

2. Erweitertes Widget-Skript (Vollständige Anpassungsmöglichkeiten)

Wenn Sie tiefgreifende Änderungen am Design vornehmen möchten, fügen Sie Ihr eigenes CSS hinzu oder erweitern Sie die Logik:

• Link: Verwenden Sie das VIS2-Widget-Skript-om-weather .
• Ideal für: Fortgeschrittene Benutzer, die die volle Kontrolle über jedes HTML-Tag und jede CSS-Eigenschaft wünschen.

Symbole & Visualisierung

Der Adapter stellt dynamische Symbolpfade bereit, die direkt in Visualisierungen wie vis, iQontrol oder Jarvis verwendet werden können.

• Wettersymbole: Zu finden unterweather.current.icon_url Der Adapter unterscheidet automatisch zwischen Tag und Nacht (z. B. Sonne vs. Mond).
• Windrichtung: Statische Pfade unterwind_direction_icon Zeigt einen Kompasspfeil entsprechend dem Gradwert an (Anzeigerichtung wählbar).
• Windböenwarnung: Ein Warnsymbol wird angezeigt unterwind_gust_icon für Windgeschwindigkeiten über ca. 39 km/h (Bft 6), mit Stufen 0–4.
• Mondphasen-Symbole: Mond-Symbole finden Sie untermoon_phase_icon Sie zeigen die Mondphasen an.
• Mehrere Symbole: Sie können zwischen statischen und animierten Symbolen (von basmilius ) wählen.

Datenpunkte (Auszug)

Wenn Sie die Wettervorhersagen nicht benötigen, lassen Sie das Feld „Ort“ leer; es werden keine Bundesstaaten eingegeben.

Funktionen PV-Prognose (falls aktiviert)

• Mehrere Standorte: Unterstützung für mehrere PV-Systeme/Standorte, z. B. für Ost-/West-Ausrichtung.
• Stündliche Vorhersage: Detaillierte Prognose von Stromerzeugung, Temperatur, Bewölkung und Sonnenscheindauer.
• Tagesprognose: Zusammenfassung des erwarteten Energieverbrauchs (Wh) für bis zu 14 Tage.
• 15-Minuten-Vorhersage: 15-Minuten-Vorhersage für den heutigen Tag, 24 Stunden.
• Physikalische Simulation:
  • Neigung & Azimut: Berechnung der Bestrahlungsstärke basierend auf der Paneelausrichtung.
  • PV-Modultemperatur: Schätzung der Zelltemperatur unter Berücksichtigung der Umgebungstemperatur, der Strahlungsintensität und der Windgeschwindigkeit (Faiman-Modell).
  • Sonnenscheindauer: Umrechnung der Sonnenscheindauer in Minuten pro Stunde.
• Aggregation: Automatische Summierung aller Standorte (Gesamtprognose) auf täglicher, stündlicher und 15-minütiger Basis.
• Systemintegration: Automatische Erfassung der Standortkoordinaten aus der ioBroker-Systemkonfiguration, sofern diese nicht manuell festgelegt wurden.
• PV-Modultemperatur: Geschätzte PV-Modultemperatur basierend auf dem Faiman-Modell.

Datenpunkte (Objekte)

Für jeden konfigurierten Standort wird ein Kanal mit den folgenden Datenpunkten erstellt:

15-Minuten-Vorhersage (15-min-forecast.0 - 95 ), (24 Stunden des aktuellen Tages), falls aktiviert

Hinweis: Zur Berechnung der PV-Modultemperatur werden temperature_2m und wind_spread_10m benötigt.

Bei Bedarf optional auswählbar, ansonsten sind die DP in den Wetterdaten enthalten.

Tagesvorhersage (daily-forecast.dayX )

Prognose JSON (location_folder ) falls aktiviert

Stündliche Vorhersage (hourly-forecast.hourX )

Hinweis: Zur Berechnung der PV-Modultemperatur werden temperature_2m und wind_spread_10m benötigt.

Bei Bedarf optional auswählbar, ansonsten sind die DP in den Wetterdaten enthalten.

sum_peak_locations_15_Minutely (0-95 ) falls aktiviert

sum_peak_locations_Daily (dayX ) falls aktiviert

sum_peak_locations_Hourly (HourX ) falls aktiviert

JSON-Datenpunkte, falls aktiviert

Konfiguration

Grundeinstellungen

• Vorhersagezeitraum: Zeitraum für die stündliche Ansicht (3 bis 48 Stunden).
• Vorhersagetage: Dauer der täglichen Vorhersage (3 bis 14 Tage).
• Aktualisierungsintervall: Häufigkeit der Datenaktualisierungen (15, 30, 60 Minuten oder einmal vor Sonnenaufgang).

Datenpunkteinstellungen

• Gleitende oder feste Stunden: Bei Auswahl von „Gleitende Stunden“ zeigt die stündliche Vorhersage immer die nächsten Stunden ab der aktuellen Stunde an. Bei Auswahl von „Feste Stunden“ zeigt die stündliche Vorhersage feste Zeitintervalle (z. B. 00:00–23:00 Uhr) unabhängig von der aktuellen Uhrzeit an.
• 15-Minuten-Vorhersage: Falls aktiviert, werden zusätzliche Bundesstaaten für eine 15-Minuten-Vorhersage erstellt (bis zu 24 Stunden für den aktuellen Tag). Bitte beachten Sie, dass die Verfügbarkeit der 15-Minuten-Daten von der OpenMeteo-API abhängt und je nach Standort und Uhrzeit variieren kann.

Standorte (Tabelle)

Für jeden Standort müssen folgende Werte definiert werden:

1. Name: Eindeutiger Bezeichner (bereinigt um die Objekt-ID).
2. Breitengrad/Längengrad: GPS-Position (optional; andernfalls werden die Systemwerte verwendet).
3. Neigung: Winkel der Module (0° = flach, 90° = vertikal).
4. Azimut: Ausrichtung (-180° bis 180°, 0° = Süden, -90° = Osten, 90° = Westen).
5. Leistung (kWp): Installierte Spitzenleistung des Systems.
6. Zeitzone: Auswahl der lokalen Zeitzone (Standard: Auto).

Globale Optionen, nur anpassbar, wenn Sie mehrere Standorte haben!

• Gesamtsumme (täglich): Erstellt den Kanalsum_peak_locations_Daily , indem die Erträge aller Systeme addiert werden.
• Gesamtsumme (stündlich): Erstellt den Kanalsum_peak_locations_Hourly für die gesamte Stundenleistung.
• Gesamtsumme (15-Minuten-Takt): Erstellt den Kanalsum_peak_locations_15_Minutely für die gesamte 15-Minuten-Vorhersage.

Technische Details & Berechnung

PV-Temperaturmodell

Der Adapter verwendet das Faiman-Modell zur Schätzung der Modultemperatur. Dieses Modell berücksichtigt die Windkühlung, die sich direkt auf den Wirkungsgrad auswirkt:pvTemp = Ambient Temperature + Irradiance / (25 + 6.84 * Wind Speed) Die

Aktualisierungshinweis

Nach einem neuen Adapter-Update wird empfohlen, den gesamten Verzeichnisbaum zu löschen und ihn neu erstellen zu lassen.

Rechtliches & Urheberrecht

Symbole & Bilder

Animierte Wettersymbole von Bas Milius

Die in diesem Adapter enthaltenen statischen Wetter- und Windrichtungssymbole unterliegen dem Urheberrecht des Urhebers.

• Nutzung: Diese Icons sind für die Verwendung innerhalb von ioBroker lizenziert. Kommerzielle Weiterverbreitung oder Verwendung außerhalb dieses Adapters bedarf der ausdrücklichen Zustimmung des Autors: h5n1@iknox.de .
• Wetterdaten: Alle Wetterdaten werden von Open-Meteo.com bereitgestellt. Bitte beachten Sie deren Nutzungsbedingungen für kommerzielle Zwecke.

Changelog

3.2.1 (2026-09-12)

• (H5N1v2) add 'diffuse_radiation' to 15 min weather forecast.
• (H5N1v2) add node.js 26.x testmatrix
• (H5N1v2) Update dependencies

3.2.0 (2026-09-06)

• (H5N1v2) Adding configurable 15 minute weather forecast with max. 16 Datasets for the next 4 hours.
• (H5N1v2) Update dependencies

3.1.4 (2026-07-18)

• (@GermanBluefox) upscaled the logo
• (@GermanBluefox) Updated TS to 6
• (@GermanBluefox) Corrected image in JsonConfig
• (H5N1v2) Resize logo to 512x512
• (pk68) fix: info.lastUpdate_PV_Forecast is no longer updated if all API calls failed or returned empty data.
• (H5N1v2) fix: PV Forecast sunrise mode now retries automatically after 30 minutes if the API call fails (e.g. HTTP 500 overload). The next day's schedule is only planned after a successful update.
• (H5N1v2) add open-meteo status link in adapter description and README.
• (H5N1v2) fix: made OpenStreetMap link clickable in the admin area.
• (H5N1v2) Update dependencie.

3.1.3 (2026-06-20)

• (H5N1v2) Fixed an issue with object creation caused by an accidental change.

3.1.2 (2026-06-20)

• (mcuiobroker) fix: after adapter update, automatically adjust type and role if they have been changed in new versions.
• (H5N1v2) Update dependencies

License

This project is licensed under the MIT License - see the LICENSE file for details.

Copyright (c) 2026 H5N1v2 h5n1@iknox.de