2025-11-13 22:53:46 +01:00
|
|
|
## Weather Forecast Configuration
|
|
|
|
|
|
|
|
|
|
<!-- pyml disable line-length -->
|
|
|
|
|
:::{table} weather
|
|
|
|
|
:widths: 10 20 10 5 5 30
|
|
|
|
|
:align: left
|
|
|
|
|
|
|
|
|
|
| Name | Environment Variable | Type | Read-Only | Default | Description |
|
|
|
|
|
| ---- | -------------------- | ---- | --------- | ------- | ----------- |
|
2026-02-28 11:31:51 +01:00
|
|
|
| provider | `EOS_WEATHER__PROVIDER` | `Optional[str]` | `rw` | `None` | Weather provider id of provider to be used. |
|
2025-12-30 22:08:21 +01:00
|
|
|
| providers | | `list[str]` | `ro` | `N/A` | Available weather provider ids. |
|
2026-07-20 14:37:03 +02:00
|
|
|
| weatherimport | `EOS_WEATHER__WEATHERIMPORT` | `WeatherImportCommonSettings` | `rw` | `required` | Weather import provider settings |
|
2025-11-13 22:53:46 +01:00
|
|
|
:::
|
|
|
|
|
<!-- pyml enable line-length -->
|
|
|
|
|
|
|
|
|
|
<!-- pyml disable no-emphasis-as-heading -->
|
2025-12-30 22:08:21 +01:00
|
|
|
**Example Input**
|
2025-11-13 22:53:46 +01:00
|
|
|
<!-- pyml enable no-emphasis-as-heading -->
|
|
|
|
|
|
|
|
|
|
<!-- pyml disable line-length -->
|
|
|
|
|
```json
|
|
|
|
|
{
|
|
|
|
|
"weather": {
|
|
|
|
|
"provider": "WeatherImport",
|
2026-07-20 14:37:03 +02:00
|
|
|
"weatherimport": {
|
|
|
|
|
"import_file_path": null,
|
|
|
|
|
"import_json": null
|
2025-11-13 22:53:46 +01:00
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
```
|
|
|
|
|
<!-- pyml enable line-length -->
|
|
|
|
|
|
2025-12-30 22:08:21 +01:00
|
|
|
<!-- pyml disable no-emphasis-as-heading -->
|
|
|
|
|
**Example Output**
|
|
|
|
|
<!-- pyml enable no-emphasis-as-heading -->
|
|
|
|
|
|
|
|
|
|
<!-- pyml disable line-length -->
|
|
|
|
|
```json
|
|
|
|
|
{
|
|
|
|
|
"weather": {
|
|
|
|
|
"provider": "WeatherImport",
|
2026-07-20 14:37:03 +02:00
|
|
|
"weatherimport": {
|
|
|
|
|
"import_file_path": null,
|
|
|
|
|
"import_json": null
|
2025-12-30 22:08:21 +01:00
|
|
|
},
|
|
|
|
|
"providers": [
|
|
|
|
|
"BrightSky",
|
|
|
|
|
"ClearOutside",
|
2026-03-13 12:23:21 +01:00
|
|
|
"OpenMeteo",
|
2025-12-30 22:08:21 +01:00
|
|
|
"WeatherImport"
|
|
|
|
|
]
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
```
|
|
|
|
|
<!-- pyml enable line-length -->
|
|
|
|
|
|
2025-11-13 22:53:46 +01:00
|
|
|
### Common settings for weather data import from file or JSON string
|
|
|
|
|
|
|
|
|
|
<!-- pyml disable line-length -->
|
2026-07-20 14:37:03 +02:00
|
|
|
:::{table} weather::weatherimport
|
2025-11-13 22:53:46 +01:00
|
|
|
:widths: 10 10 5 5 30
|
|
|
|
|
:align: left
|
|
|
|
|
|
|
|
|
|
| Name | Type | Read-Only | Default | Description |
|
|
|
|
|
| ---- | ---- | --------- | ------- | ----------- |
|
2026-02-28 11:31:51 +01:00
|
|
|
| import_file_path | `Union[str, pathlib.Path, NoneType]` | `rw` | `None` | Path to the file to import weather data from. |
|
|
|
|
|
| import_json | `Optional[str]` | `rw` | `None` | JSON string, dictionary of weather forecast value lists. |
|
2025-11-13 22:53:46 +01:00
|
|
|
:::
|
|
|
|
|
<!-- pyml enable line-length -->
|
|
|
|
|
|
|
|
|
|
<!-- pyml disable no-emphasis-as-heading -->
|
|
|
|
|
**Example Input/Output**
|
|
|
|
|
<!-- pyml enable no-emphasis-as-heading -->
|
|
|
|
|
|
|
|
|
|
<!-- pyml disable line-length -->
|
|
|
|
|
```json
|
|
|
|
|
{
|
|
|
|
|
"weather": {
|
2026-07-20 14:37:03 +02:00
|
|
|
"weatherimport": {
|
|
|
|
|
"import_file_path": null,
|
|
|
|
|
"import_json": "{\"weather_temp_air\": [18.3, 17.8, 16.9]}"
|
2025-11-13 22:53:46 +01:00
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
```
|
|
|
|
|
<!-- pyml enable line-length -->
|