|
4 | 4 | [](https://www.npmjs.com/package/iobroker.open-meteo-weather) |
5 | 5 |  |
6 | 6 |
|
7 | | -**Der Open-Meteo Wetterdienst Adapter für ioBroker.** |
| 7 | +**The Open-Meteo Weather Service Adapter for ioBroker.** |
8 | 8 |
|
9 | | -Dieser Adapter liefert präzise Wetterdaten, Vorhersagen, Luftqualität und Pollenflug-Informationen von [Open-Meteo.com](https://open-meteo.com/). Die Nutzung ist für den nicht-kommerziellen Gebrauch und weniger als 10.000 tägliche API-Aufrufe ohne Registration für einen API-Key möglich, was die Einrichtung extrem vereinfacht. |
| 9 | +This adapter provides precise weather data, forecasts, air quality, and pollen information powered by [Open-Meteo.com](https://open-meteo.com/). It is free for non-commercial use (under 10,000 daily API calls) and requires no API key registration, making the setup process extremely simple. |
10 | 10 |
|
11 | 11 | --- |
12 | 12 |
|
13 | | -## Funktionen |
| 13 | +## Features |
14 | 14 |
|
15 | | -* **Aktuelle Wetterdaten:** Echtzeit-Abruf von Temperatur, Feuchtigkeit, Luftdruck und Winddaten. |
16 | | -* **Flexible Vorhersage:** Konfigurierbare Anzahl an Vorhersagetagen und stündlicher Auflösung. |
17 | | -* **Luftqualität & Pollenflug:** Optionale Daten für Feinstaub (PM2.5, PM10) sowie verschiedene Pollenarten (Erle, Birke, Gräser, etc.). |
18 | | -* **Automatisches Cleanup:** Der Adapter bereinigt die Objektstruktur selbstständig, wenn die Vorhersage-Zeiträume in der Konfiguration verkürzt oder geändert werden. |
19 | | -* **Multi-Language:** Unterstützung für 11 Sprachen (u.a. Deutsch, Englisch, Polnisch, Russisch, Französisch, Chinesisch). |
20 | | -* **Einheiten-System:** Nahtloser Wechsel zwischen Metrisch (°C, km/h) und Imperial (°F, mph). |
| 15 | +* **Current Weather Data:** Real-time retrieval of temperature, humidity, air pressure, and wind data. |
| 16 | +* **Flexible Forecasts:** Configurable number of forecast days and hourly resolution. |
| 17 | +* **Air Quality & Pollen:** Optional data for particulate matter (PM2.5, PM10) as well as various pollen types (alder, birch, grass, etc.). |
| 18 | +* **Automatic Cleanup:** The adapter automatically cleans up the object structure if forecast periods are shortened or changed in the configuration. |
| 19 | +* **Multi-Language Support:** Supports 11 languages (including English, German, Polish, Russian, French, Chinese, etc.). |
| 20 | +* **Unit System:** Seamless switching between Metric (°C, km/h) and Imperial (°F, mph) systems. |
21 | 21 |
|
22 | 22 | --- |
23 | 23 |
|
24 | | -## Konfiguration |
| 24 | +## Configuration |
25 | 25 |
|
26 | | -Nach der Installation müssen folgende Felder in den Instanz-Einstellungen ausgefüllt werden: |
| 26 | +After installation, configure the following fields in the instance settings: |
27 | 27 |
|
28 | | -1. **Koordinaten (Breitengrad & Längengrad):** Bestimmen Sie den Ort für die Wetterabfrage auf openstreatmap.org. |
29 | | -2. **Abfrageintervall:** Zeitabstand in Minuten (Standard: 30 Min). |
30 | | -3. **Vorhersage-Tage:** Anzahl der Tage für die tägliche Übersicht (0-16 Tage). |
31 | | -4. **Stündliche Vorhersage:** Aktivierung und Anzahl der Stunden pro Tag (z.B. die nächsten 24 Stunden). |
32 | | -5. **Optionale Daten:** Checkboxen für Pollenflug und Luftqualität. |
33 | | -6. **Einheiten:** Auswahl zwischen Metrisch und Imperial. |
| 28 | +1. **Coordinates (Latitude & Longitude):** Determine your location (you can find these on openstreetmap.org). |
| 29 | +2. **Update Interval:** Time interval in minutes (Default: 30 min). |
| 30 | +3. **Forecast Days:** Number of days for the daily overview (0–16 days). |
| 31 | +4. **Hourly Forecast:** Toggle and set the number of hours per day (e.g., the next 24 hours). |
| 32 | +5. **Optional Data:** Checkboxes for pollen and air quality data. |
| 33 | +6. **Units:** Choose between Metric and Imperial. |
34 | 34 |
|
35 | 35 | --- |
36 | 36 |
|
37 | | -## Icons & Visualisierung |
| 37 | +## Icons & Visualization |
38 | 38 |
|
39 | | -Der Adapter stellt dynamische Pfade zu Icons bereit, die direkt in Visualisierungen (vis, iQontrol, Jarvis) genutzt werden können. |
| 39 | +The adapter provides dynamic icon paths that can be used directly in visualizations such as **vis, iQontrol, or Jarvis**. |
40 | 40 |
|
41 | | -* **Wetter-Icons:** Zu finden unter `weather.current.icon_url`. Der Adapter unterscheidet automatisch zwischen Tag und Nacht (z.B. Sonne vs. Mond). |
42 | | -* **Windrichtung:** Statische Pfade unter `wind_direction_icon` zeigen einen Kompass-Pfeil passend zur Gradzahl. |
43 | | -* **Windböen-Warnung:** Unter `wind_gust_icon` wird ab einer Windgeschwindigkeit von ca. 39 km/h (Bft 6) ein Warn-Icon eingeblendet (Stufen 0-4). |
| 41 | +* **Weather Icons:** Found under `weather.current.icon_url`. The adapter automatically distinguishes between day and night (e.g., Sun vs. Moon). |
| 42 | +* **Wind Direction:** Static paths under `wind_direction_icon` display a compass arrow corresponding to the degree value. |
| 43 | +* **Wind Gust Warning:** A warning icon is displayed under `wind_gust_icon` for wind speeds above approx. 39 km/h (Bft 6), featuring levels 0–4. |
44 | 44 |
|
45 | 45 | --- |
46 | 46 |
|
47 | | -## Datenpunkte (Auszug) |
| 47 | +## Data Points (Excerpt) |
48 | 48 |
|
49 | | -| Ordner | Beschreibung | |
| 49 | +| Folder | Description | |
50 | 50 | |:---|:---| |
51 | | -| `weather.current` | Aktuelle Messwerte (Temp, Taupunkt, Wind, etc.) | |
52 | | -| `weather.forecast.dayX` | Tägliche Vorhersage für den Tag X | |
53 | | -| `weather.forecast.hourly.dayX.hourY` | Stündliche Details pro Tag | |
54 | | -| `air.current` | Luftqualität und Pollenbelastung als Text und Wert | |
| 51 | +| `weather.current` | Current measurements (Temp, Dew point, Wind, etc.) | |
| 52 | +| `weather.forecast.dayX` | Daily forecast for Day X | |
| 53 | +| `weather.forecast.hourly.dayX.hourY` | Hourly details per day | |
| 54 | +| `air.current` | Air quality and pollen levels as text and value | |
55 | 55 |
|
56 | 56 | --- |
57 | 57 |
|
58 | | -## Rechtliches & Copyright |
| 58 | +## Legal & Copyright |
59 | 59 |
|
60 | | -### Icons & Bilder |
61 | | -Die im Adapter enthaltenen Wetter-Icons sowie Windrichtungs-Icons unterliegen dem Urheberrecht des Erstellers. |
62 | | -* **Nutzung:** Die Icons sind für die Verwendung innerhalb des ioBroakers lizenziert. Eine kommerzielle Weiterverbreitung oder Nutzung außerhalb dieses Adapters bedarf der Zustimmung des Autors h5n1@iknox.de. |
63 | | -* **Wetterdaten:** Alle Wetterdaten werden von [Open-Meteo.com](https://open-meteo.com/) bereitgestellt. Bitte beachten Sie deren Nutzungsbedingungen für kommerzielle Zwecke. |
| 60 | +### Icons & Images |
| 61 | +The weather and wind direction icons included in this adapter are subject to the creator's copyright. |
| 62 | +* **Usage:** These icons are licensed for use within ioBroker. Commercial redistribution or use outside of this adapter requires the explicit consent of the author: h5n1@iknox.de. |
| 63 | +* **Weather Data:** All weather data is provided by [Open-Meteo.com](https://open-meteo.com/). Please review their terms of use for commercial purposes. |
64 | 64 |
|
65 | | -### Lizenz |
66 | | -Dieses Projekt ist unter der **MIT Lizenz** lizenziert - siehe die `LICENSE` Datei für Details. |
| 65 | +### License |
| 66 | +This project is licensed under the **MIT License** - see the `LICENSE` file for details. |
67 | 67 |
|
68 | 68 | Copyright (c) 2026 H5N1v2 <h5n1@iknox.de> |
0 commit comments