> For the complete documentation index, see [llms.txt](https://docs.buildings.ability.abb/collection/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.buildings.ability.abb/collection/german/plattform/additional-features/weather.md).

# Wetter

Der Wetterdienst stellt aktuelle Wetter- und Prognosedaten für BuildingPro Suites bereit. Er verwendet die Standorte von Sites und Wetterstations-Assets, um Wetterinformationen auf der gesamten Plattform verfügbar zu machen.

Wetterdaten werden bereitgestellt von [Meteonomiqs](https://www.meteonomiqs.com/weather-api/).

Der Dienst ist in jedem Tenant verfügbar. Keine Installation, kein externes Wetterkonto und keine API-Schlüsselkonfiguration sind erforderlich.

{% hint style="info" %}
Die Nutzung des Wetterdienstes verbraucht keine Infravolts.
{% endhint %}

## Wo Wetterdaten verwendet werden

Wetterdaten werden verwendet von:

* der Wetteranzeige auf der [Startseite](/collection/german/verpflichtende-basis/platform-core/workspace-and-identity/home-page.md)
* dem [Wetter-Widget](/collection/german/plattform/live-cockpit/widgets/predefined-widgets/weather.md)
* [Heiz- und Kühlgradtage](/collection/german/plattform/platform-core/baseline-and-factors/heating-and-cooling-days.md), das Heizgradtage und Kühlgradtage berechnet
* Dashboards, Berechnungen, Analysen, Berichte, Regeln und andere Plattformfunktionen, die Asset-Attribute verwenden

## Wie Standorte bestimmt werden

Der Wetterdienst verwendet den für die jeweilige Site oder das jeweilige Asset konfigurierten Standort.

### Sites

Das Wetter für Sites basiert auf dem Breiten- und Längengrad der Site. Eine Site ohne Koordinaten erhält kein automatisch erstelltes Wetterstations-Asset.

### Wetterstations-Assets

Für ein Wetterstations-Asset verwendet der Dienst den direkt am Asset konfigurierten Standort. Hat das Asset keinen eigenen Standort, kann es den Standort seines übergeordneten Assets verwenden.

Wenn weder das Asset noch ein übergeordnetes Asset einen Standort hat, kann der Dienst keine Wetterdaten abrufen. Das Asset zeigt einen Standortstatus an, der das Problem erläutert.

## Typ des Wetterstations-Assets

Der folgende Asset-Typ ist in jedem Tenant verfügbar:

`Wetterstation BuildingProSuites`

Der Asset-Typ enthält die unten beschriebenen Attribute für aktuelles Wetter, Prognose, Wetterzustand und Standortstatus. Die Verwendung dieses Asset-Typs verbraucht keine Infravolts.

<figure><img src="https://2215908449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOqGnkz52o2zVUsEGEZGk%2Fuploads%2Fgit-blob-32a26ebed8832b866612577ac7df59a1bf61972c%2FWeather%20asset%20type.png?alt=media" alt="Weather Station BuildingProSuites asset type"><figcaption></figcaption></figure>

### Automatische Wetter-Assets für Sites

Für jede Site mit konfiguriertem Standort erstellt BuildingPro Suites automatisch ein aktives Wetterstations-Asset unterhalb dieser Site. Das Asset verwendet den Standort der Site und stellt aktuelle Bedingungen sowie Prognosedaten für diesen Standort bereit.

Wenn eine Site erst nach ihrer Erstellung einen Standort erhält, wird das entsprechende Wetterstations-Asset automatisch erstellt, sobald der Standort verfügbar ist. Sites ohne konfigurierten Standort werden übersprungen, bis einer hinzugefügt wird.

### Eine Wetterstation für einen anderen Standort erstellen

Sie können auch manuell ein Wetterstations-Asset für einen Standort erstellen, der keiner Site zugeordnet ist.

<figure><img src="https://2215908449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOqGnkz52o2zVUsEGEZGk%2Fuploads%2Fgit-blob-e188cde75cd25d736f92243d31455c889bbc049d%2FCreate%20Weather%20asset.png?alt=media" alt="Create a Weather Station asset"><figcaption></figcaption></figure>

<table data-header-hidden data-full-width="true"><thead><tr><th width="66.800048828125">Element</th><th width="143.800048828125">Name</th><th>Beschreibung</th></tr></thead><tbody><tr><td><strong>[1]</strong></td><td>Asset-Hub</td><td>Öffnet den Asset-Hub, in dem Sie Assets anzeigen und verwalten können.</td></tr><tr><td><strong>[2]</strong></td><td>Asset hinzufügen</td><td>Öffnet den Dialog zum Erstellen eines neuen Assets.</td></tr><tr><td><strong>[3]</strong></td><td>Asset-Typ</td><td>Wählen Sie <code>Wetterstation BuildingProSuites</code> als Asset-Typ.</td></tr><tr><td><strong>[4]</strong></td><td>Hinzufügen</td><td>Erstellt das Asset. Füllen Sie die übrigen erforderlichen Felder, z. B. den Asset-Namen, aus, bevor Sie auf <strong>Hinzufügen</strong>. Optionale Felder können bei Bedarf ausgefüllt werden.</td></tr></tbody></table>

1. Öffnen Sie [Assets](/collection/german/verpflichtende-basis/assets/create-assets.md) und ein neues Asset erstellen.
2. Wählen Sie `Wetterstation BuildingProSuites` als Asset-Typ.
3. Geben Sie die Basisinformationen des Assets ein und speichern Sie es.
4. Öffnen Sie die Asset-Einstellungen und [platzieren Sie das Asset auf der Karte](/collection/german/verpflichtende-basis/assets/placing-assets-on-a-map.md) am erforderlichen Standort.
5. Aktualisieren Sie das Asset nach dem nächsten Wetter-Update und öffnen Sie [Asset-Daten](/collection/german/verpflichtende-basis/assets/asset-data.md) um die Werte anzuzeigen.

Die Kartenposition gibt den Standort des Assets vor. Alternativ können Sie das Asset unterhalb eines übergeordneten Assets platzieren, das über einen Standort verfügt, damit die Wetterstation diesen verwenden kann. Wenn sich der Standort eines vorhandenen Wetterstations-Assets ändert, werden seine Wetterdaten automatisch aktualisiert.

### Den Asset-Standort festlegen

Der Wetterdienst benötigt einen Standort, bevor er Daten für ein Wetterstations-Asset bereitstellen kann. So legen Sie den Standort direkt am Asset fest:

1. Öffnen Sie die [Asset-Details](/collection/german/verpflichtende-basis/assets/asset-details.md) des Wetterstations-Assets.
2. Öffnen Sie die **Allgemein** Registerkarte und öffnen Sie dann die Asset-Einstellungen.
3. Wählen Sie **Standort** um die Karte zu öffnen.
4. Suchen Sie den benötigten Standort oder navigieren Sie dorthin und klicken Sie auf die Karte.
5. Speichern Sie den Standort.

<figure><img src="https://2215908449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOqGnkz52o2zVUsEGEZGk%2Fuploads%2Fgit-blob-5ea84a161b38485c5056c2ca49a136bcdfcf8bf5%2FPlace%20Weather%20Asset.png?alt=media" alt="Place a Weather Station asset and save its location"><figcaption></figcaption></figure>

<table data-header-hidden data-full-width="true"><thead><tr><th width="70.79998779296875">Element</th><th width="212.20001220703125">Name</th><th>Beschreibung</th></tr></thead><tbody><tr><td><strong>[5]</strong></td><td>Status des Wetterstandorts</td><td>Zeigt an, dass Koordinaten am Wetterstations-Asset oder an einem übergeordneten Asset festgelegt werden müssen, bevor Wetterdaten verfügbar sind.</td></tr><tr><td><strong>[6]</strong></td><td>Bearbeiten</td><td>Öffnet die Asset-Einstellungen, damit Sie die Asset-Konfiguration bearbeiten können.</td></tr><tr><td><strong>[7]</strong></td><td>Standort anzeigen/bearbeiten</td><td>Öffnet die Kartenansicht, in der Sie den Asset-Standort festlegen oder ändern können.</td></tr><tr><td><strong>[8]</strong></td><td>Kartenstandort</td><td>Klicken Sie auf der Karte auf die gewünschte Position, um den Asset-Standort festzulegen.</td></tr><tr><td><strong>[9]</strong></td><td>Speichern</td><td>Speichert den ausgewählten Standort. Nach dem nächsten Wetter-Update zeigt das Asset Wetterdaten für diesen Standort an.</td></tr></tbody></table>

Sie können das Wetterstations-Asset auch einem übergeordneten Asset zuordnen, das bereits einen Standort hat. In diesem Fall verwendet die Wetterstation den Standort des übergeordneten Assets, sofern nicht direkt an der Wetterstation ein Standort festgelegt wird. Weitere Informationen finden Sie unter [Assets auf einer Karte platzieren](/collection/german/verpflichtende-basis/assets/placing-assets-on-a-map.md).

Wenn nach dem nächsten Update keine Wetterwerte angezeigt werden, öffnen Sie die Daten des Assets und prüfen Sie das `weather_location_status` Attribut. Es teilt Ihnen mit, ob ein Standort fehlt, nicht verfügbar ist oder keine Wetterdaten liefern kann.

## Attribute der Wetterstation

### Aktuelles Wetter

Die folgenden Attribute liefern die aktuellen Wetterbedingungen:

<table data-search="false"><thead><tr><th width="335.60003662109375">Attribut</th><th width="399.0001220703125">Beschreibung</th><th>Einheit</th></tr></thead><tbody><tr><td><code>weather_temperature</code></td><td>Außentemperatur</td><td>°C</td></tr><tr><td><code>weather_humidity</code></td><td>Relative Luftfeuchtigkeit außen</td><td>%</td></tr><tr><td><code>weather_wind_speed</code></td><td>Windgeschwindigkeit</td><td>m/s</td></tr><tr><td><code>weather_wind_direction</code></td><td>Windrichtung</td><td>°</td></tr><tr><td><code>weather_wind_gusts</code></td><td>Windböen</td><td>m/s</td></tr><tr><td><code>weather_cloud_coverage</code></td><td>Bewölkungsgrad</td><td>%</td></tr><tr><td><code>weather_solar_radiation</code></td><td>Globale horizontale Strahlung</td><td>W/m²</td></tr><tr><td><code>weather_dewpoint_temperature</code></td><td>Taupunkttemperatur</td><td>°C</td></tr><tr><td><code>weather_mean_sea_level_pressure</code></td><td>Luftdruck auf Meereshöhe</td><td>Pa</td></tr><tr><td><code>weather_precipitation_sum</code></td><td>Niederschlagssumme</td><td>mm</td></tr><tr><td><code>weather_precipitation_probability</code></td><td>Niederschlagswahrscheinlichkeit</td><td>%</td></tr></tbody></table>

### Prognosetemperaturen

Die folgenden Attribute liefern Prognosetemperaturen. Jeder Wert stellt die Prognose für den angegebenen Horizont dar; es handelt sich nicht um eine Messung, die zu diesem zukünftigen Zeitpunkt erfolgt.

<table data-search="false"><thead><tr><th>Attribut</th><th width="278">Prognosehorizont</th><th>Einheit</th></tr></thead><tbody><tr><td><code>weather_temperature_1h</code></td><td>1 Stunde</td><td>°C</td></tr><tr><td><code>weather_temperature_2h</code></td><td>2 Stunden</td><td>°C</td></tr><tr><td><code>weather_temperature_3h</code></td><td>3 Stunden</td><td>°C</td></tr><tr><td><code>weather_temperature_6h</code></td><td>6 Stunden</td><td>°C</td></tr><tr><td><code>weather_temperature_12h</code></td><td>12 Stunden</td><td>°C</td></tr><tr><td><code>weather_temperature_1d</code></td><td>1 Tag</td><td>°C</td></tr><tr><td><code>weather_temperature_3d</code></td><td>3 Tage</td><td>°C</td></tr><tr><td><code>weather_temperature_1w</code></td><td>1 Woche</td><td>°C</td></tr><tr><td><code>weather_temperature_2w</code></td><td>2 Wochen</td><td>°C</td></tr></tbody></table>

### Wetterzustand und Standortstatus

Die folgenden Attribute liefern den Wetterzustand und den Standortstatus:

<table><thead><tr><th width="260.20001220703125">Attribut</th><th>Beschreibung</th></tr></thead><tbody><tr><td><code>weather_state</code></td><td>Zugeordnete Wetterbedingung, z. B. sonnig, bewölkt, Regen, Schnee oder Gewitter.</td></tr><tr><td><code>weather_location_status</code></td><td>Gibt an, ob ein Standort und Wetterdaten verfügbar sind.</td></tr><tr><td><code>weather_state_text</code></td><td>Textdarstellung der Wetterbedingung.</td></tr></tbody></table>

Das `weather_location_status` Meldungen lauten:

<table><thead><tr><th width="247.4000244140625">Status</th><th>Bedeutung</th></tr></thead><tbody><tr><td>OK</td><td>Wetterdaten sind verfügbar.</td></tr><tr><td>Koordinaten erforderlich</td><td>Legen Sie einen Standort am Asset oder an einem übergeordneten Asset fest.</td></tr><tr><td>Standort nicht verfügbar</td><td>Für den konfigurierten Standort konnten keine Wetterdaten gefunden werden.</td></tr><tr><td>Prognose nicht verfügbar</td><td>Für den ausgewählten Standort sind keine Wettervorhersagedaten verfügbar.</td></tr></tbody></table>

## Aktualisierungsverhalten

Wetterstations-Assets werden normalerweise einmal pro Stunde aktualisiert. Aktuelle Bedingungen und Prognosewerte werden automatisch aktualisiert. Das Aktualisierungsintervall kann je nach Plattformkonfiguration variieren.

Die Werte sind in Asset-Details und [Asset-Daten](/collection/german/verpflichtende-basis/assets/asset-data.md), und können wie andere Asset-Attribute verwendet werden.

## Zugehörige Dokumentation

* [Wetter-Widget](/collection/german/plattform/live-cockpit/widgets/predefined-widgets/weather.md)
* [Startseite](/collection/german/verpflichtende-basis/platform-core/workspace-and-identity/home-page.md)
* [Asset-Daten](/collection/german/verpflichtende-basis/assets/asset-data.md)
* [Assets auf einer Karte platzieren](/collection/german/verpflichtende-basis/assets/placing-assets-on-a-map.md)
* [Heiz- und Kühlgradtage](/collection/german/plattform/platform-core/baseline-and-factors/heating-and-cooling-days.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.buildings.ability.abb/collection/german/plattform/additional-features/weather.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.