# Wetter

### Installation

1. Navigieren Sie zum BuildingPro Suites 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 Dienst „One Call API 3.0“ (eine kostenlose Version ist verfügbar).
3. Generieren Sie Ihren API-Schlüssel im Konto-Dashboard.
4. Notieren Sie Ihren API-Schlüssel für die BuildingPro Suites-Konfiguration.

#### Konfigurationsparameter der App

| Parameter         | Beschreibung                                            | Erforderlich | Standardwert |
| ----------------- | ------------------------------------------------------- | ------------ | ------------ |
| `apiKey`          | Ihr OpenWeatherMap-API-Schlüssel                        | Ja           | -            |
| `enable`          | Aktiviert/Deaktiviert die Konfiguration                 | Ja           | wahr         |
| `refreshInterval` | Daten-Synchronisierungsintervall (Sekunden)             | Ja           | 300          |
| `requestTimeout`  | API-Anfrage-Timeout (Sekunden)                          | Nein         | 120          |
| `tenantIDs`       | BuildingPro Suites Mandanten-IDs für die Datenerfassung | Ja           | -            |

#### Konfigurationsschritte

1. Navigieren Sie zu `Einstellungen > Apps > Wetter` in BuildingPro Suites.
2. Rufen Sie die Generic-Frontend-Oberfläche auf.
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,
  "tenantIDs": [
    "10"
  ]
}
```

### Anlagenverwaltung

#### Anlagentyp

Die App erstellt einen `Wetter` Anlagentyp, der Wetterüberwachungsstandorte repräsentiert.

#### Wetteranlagen erstellen

1. Navigieren Sie in BuildingPro Suites zu Anlagen.
2. Klicken Sie auf „Neue Anlage erstellen“.
3. Wählen Sie „Wetter“ als Anlagentyp aus.
4. Konfigurieren Sie die grundlegenden Anlageneigenschaften.
5. Speichern Sie die neue Anlage.

#### Standortkonfiguration

1. Öffnen Sie Ihre Wetteranlage.
2. Klicken Sie auf die Schaltfläche „Bearbeiten“.
3. Im Abschnitt „Zusätzliche Informationen“:
   * Geben Sie den Standortnamen ein (z. B. „Zürich, Schweiz“).
   * Für optimale Ergebnisse verwenden Sie das Format: „Stadt, Land“ oder „Stadt, Bundesland, Land“.
4. Speichern Sie die Konfiguration.
5. Aktualisieren Sie die Seite, um Folgendes zu prüfen:
   * Der Standortname wird mit zusätzlichen geografischen Details angezeigt.
   * Wetterdaten beginnen, die Anlagenattribute zu füllen.

#### Fehlerbehebung beim Standort

Wenn der Standort nicht gefunden wird:

1. Versuchen Sie spezifischere Standortnamen.
2. Fügen Sie Länder- oder Bundeslandinformationen hinzu.
3. Prüfen Sie, ob der Standort in der OpenWeatherMap-Datenbank vorhanden ist.
4. Prüfen Sie den Standortnamen auf Tippfehler.

### Attribute für Wetterdaten

Die App stellt diese Wettereigenschaften bereit:

| Attribut            | Beschreibung                                                             | Einheit |
| ------------------- | ------------------------------------------------------------------------ | ------- |
| Temperatur          | Aktuelle Lufttemperatur                                                  | °C      |
| fühlt\_sich\_an     | Gefühlte Temperatur unter Berücksichtigung von Wind und Luftfeuchtigkeit | °C      |
| Druck               | Luftdruck am Standort                                                    | hPa     |
| Luftfeuchtigkeit    | Relative Luftfeuchtigkeit in Prozent                                     | %       |
| Taupunkt            | Temperatur, bei der sich Tau bildet                                      | °C      |
| uv-Index            | Ultraviolettindex, der das Risiko eines Sonnenbrands anzeigt             | -       |
| Wolken              | Prozentuale Bewölkung                                                    | %       |
| Windgeschwindigkeit | Aktuelle Windgeschwindigkeit                                             | m/s     |
| Windrichtung        | Windrichtung in Grad (0-360)                                             | °       |

In Google Sheets exportieren

### App-Statusüberwachung

Die App erstellt eine Anlage „Weather Root“, die Folgendes bereitstellt:

#### Statusanzeigen

* Anlagenstatus: Zeigt den aktiven/inaktiven Zustand an.
* Statusattribut: Aktueller Betriebsstatus mit möglichen Werten:

| Status         | Beschreibung                       | Empfohlene Maßnahme                                      |
| -------------- | ---------------------------------- | -------------------------------------------------------- |
| OK             | Normalbetrieb                      | Keine Maßnahme erforderlich                              |
| API\_ERROR     | Problem mit der OpenWeatherMap-API | API-Schlüssel und Netzwerkverbindung prüfen              |
| CONFIG\_ERROR  | Konfigurationsproblem              | App-Konfiguration prüfen                                 |
| RATE\_LIMIT    | API-Ratenlimit überschritten       | Aktualisierungsintervall erhöhen oder API-Tarif upgraden |
| NETWORK\_ERROR | Verbindungsproblem                 | Netzwerkeinstellungen prüfen                             |

In Google Sheets exportieren

### Anwendungsfälle

#### Optimierung von Gebäudenergie

* Anpassung von HVAC-Systemen anhand der Außentemperatur.
* Optimierung von Kühlsystemen anhand von Luftfeuchtigkeitsdaten.
* Implementierung natürlicher Belüftungsstrategien basierend auf Windbedingungen.

#### Management erneuerbarer Energien

* Prognose der Solarstromerzeugung anhand von Bewölkungsdaten.
* Anpassung des Betriebs von Windkraftanlagen basierend auf Windgeschwindigkeit/-richtung.
* Implementierung wetterabhängiger Energiespeicherstrategien.

#### Facility Management

* Planung von Wartungsaktivitäten unter Berücksichtigung der Wetterbedingungen.
* Implementierung wetterabhängiger Reinigungspläne.
* Optimierung der Landschaftsberegnung auf Basis von Niederschlagsprognosen.

#### Analysen und Berichte

* Abgleich des Energieverbrauchs mit Wettermustern.
* Erstellung von Berichten über die Auswirkungen des Wetters.
* Aufbau prädiktiver Modelle für den Energieverbrauch.