# Wetter

![App schema](https://raw.githubusercontent.com/eliona-smart-building-assistant/weather-app2/refs/heads/develop/schema.png)

### Installation

1. Navigieren Sie zum Eliona App Store
2. Suchen Sie nach "Weather App"
3. Klicken Sie auf "Installieren" und bestätigen Sie die Installation
4. Warten Sie auf die Installationsbestätigung (normalerweise 1-2 Minuten)

### Konfiguration

#### OpenWeatherMap Registrierung

1. Besuchen Sie [OpenWeatherMap](https://openweathermap.org/) und erstellen Sie ein Konto
2. Abonnieren Sie den "One Call API 3.0" Service (kostenlose Version verfügbar)
3. Generieren Sie Ihren API-Schlüssel im Account Dashboard
4. Notieren Sie Ihren API-Schlüssel für die Eliona-Konfiguration

#### App-Konfigurationsparameter

| Parameter         | Beschreibung                               | Erforderlich | Standardwert |
| ----------------- | ------------------------------------------ | ------------ | ------------ |
| `apiKey`          | Ihr OpenWeatherMap API-Schlüssel           | Ja           | -            |
| `enable`          | Aktiviert/Deaktiviert die Konfiguration    | Ja           | true         |
| `refreshInterval` | Daten-Synchronisationsintervall (Sekunden) | Ja           | 300          |
| `requestTimeout`  | API-Anfrage-Timeout (Sekunden)             | Nein         | 120          |
| `projectIDs`      | Eliona Projekt-IDs für die Datenerfassung  | Ja           | -            |

#### Konfigurationsschritte

1. Navigieren Sie zu `Einstellungen > Apps > Weather` in Eliona
2. Greifen Sie auf die Generic Frontend-Schnittstelle zu
3. Verwenden Sie den Konfigurationsendpunkt mit der PUT-Methode
4. Geben Sie Ihre Konfiguration im JSON-Format ein:

```json
{
  "apiKey": "Ihr-API-Schlüssel",
  "enable": true,
  "refreshInterval": 300,
  "requestTimeout": 120,
  "projectIDs": [
    "10"
  ]
}
```

### Asset-Management

#### Asset-Typ

Die App erstellt einen `Weather`-Asset-Typ, der Wetterüberwachungsstandorte darstellt.

#### Erstellen von Wetter-Assets

1. Navigieren Sie zu Assets in Eliona
2. Klicken Sie auf "Neues Asset erstellen"
3. Wählen Sie "Weather" als Asset-Typ
4. Konfigurieren Sie die grundlegenden Asset-Eigenschaften
5. Speichern Sie das neue Asset

#### Standortkonfiguration

1. Öffnen Sie Ihr Wetter-Asset
2. Klicken Sie auf die Bearbeitungsschaltfläche
3. Im Abschnitt "Weitere Informationen":
   * Geben Sie den Standortnamen ein (z.B. "Zürich, Schweiz")
   * Für beste Ergebnisse verwenden Sie das Format: "Stadt, Land" oder "Stadt, Bundesland, Land"
4. Speichern Sie die Konfiguration
5. Aktualisieren Sie die Seite, um zu überprüfen:
   * Der Standortname erscheint mit zusätzlichen geografischen Details
   * Wetterdaten beginnen, die Asset-Attribute zu füllen

#### Standort-Fehlerbehebung

Wenn der Standort nicht gefunden wird:

1. Versuchen Sie spezifischere Standortnamen
2. Fügen Sie Länder- oder Bundeslandinformationen hinzu
3. Überprüfen Sie, ob der Standort in der OpenWeatherMap-Datenbank existiert
4. Überprüfen Sie auf Tippfehler im Standortnamen

### Wetterdaten-Attribute

Die App bietet diese Wettereigenschaften:

| Attribut    | Beschreibung                                                             | Einheit |
| ----------- | ------------------------------------------------------------------------ | ------- |
| temperature | Aktuelle Lufttemperatur                                                  | °C      |
| feels\_like | Gefühlte Temperatur unter Berücksichtigung von Wind und Luftfeuchtigkeit | °C      |
| pressure    | Luftdruck am Standort                                                    | hPa     |
| humidity    | Relative Luftfeuchtigkeit in Prozent                                     | %       |
| dew\_point  | Temperatur, bei der sich Tau bildet                                      | °C      |
| uvi         | Ultraviolett-Index, der das Sonnenbrandrisiko anzeigt                    | -       |
| clouds      | Prozentsatz der Bewölkung                                                | %       |
| wind\_speed | Aktuelle Windgeschwindigkeit                                             | m/s     |
| wind\_deg   | Windrichtung in Grad (0-360)                                             | °       |

### App-Statusüberwachung

Die App erstellt ein "Weather Root"-Asset, das Folgendes bereitstellt:

#### Statusindikatoren

* **Asset-Status**: Zeigt den aktiven/inaktiven Zustand an
* **Status-Attribut**: Aktueller Betriebsstatus mit möglichen Werten:

| Status         | Beschreibung                       | Empfohlene Aktion                                       |
| -------------- | ---------------------------------- | ------------------------------------------------------- |
| OK             | Normaler Betrieb                   | Keine Aktion erforderlich                               |
| API\_ERROR     | Problem mit der OpenWeatherMap-API | API-Schlüssel und Netzwerkverbindung überprüfen         |
| CONFIG\_ERROR  | Konfigurationsproblem              | App-Konfiguration überprüfen                            |
| RATE\_LIMIT    | API-Ratenlimit überschritten       | Aktualisierungsintervall erhöhen oder API-Plan upgraden |
| NETWORK\_ERROR | Verbindungsproblem                 | Netzwerkeinstellungen überprüfen                        |

### Anwendungsfälle

#### Gebäudeenergieoptimierung

* Anpassung von HLK-Systemen basierend auf der Außentemperatur
* Optimierung von Kühlsystemen unter Verwendung von Luftfeuchtigkeitsdaten
* Implementierung von natürlichen Lüftungsstrategien basierend auf Windbedingungen

#### Erneuerbare Energien-Management

* Vorhersage der Solarstromerzeugung unter Verwendung von Bewölkungsdaten
* Anpassung des Betriebs von Windturbinen basierend auf Windgeschwindigkeit/-richtung
* Implementierung von wetterabhängigen Energiespeicherstrategien

#### Facility-Management

* Planung von Wartungsaktivitäten unter Berücksichtigung der Wetterbedingungen
* Implementierung von wetterabhängigen Reinigungsplänen
* Optimierung der Landschaftsbewässerung basierend auf Niederschlagsvorhersagen

#### Analysen und Berichterstattung

* Korrelation des Energieverbrauchs mit Wettermustern
* Erstellung von Berichten über Wetterauswirkungen
* Erstellung von Vorhersagemodellen für den Energieverbrauch