Weather — Standortwetter

GET /v1/plant/weather — Anzeige-Wetter (sekundär, kein Leitprodukt). Tmin/Tmax bereits in PV Forecast. Loxone optional: Weather Guide. Klasse weather: Community 48/Tag — stündlich reicht.

Was macht diese Funktion?

Weather liefert aktuelles Wetter und eine kurze Tagesvorschau für den Standort Ihres Anlagenprofils — Temperatur, Zustandstext, Sonne/Regen, Wind.

Alltagsbeispiel: „Jetzt 22 °C, heiter, Wind 12 km/h. Heute Max 27 °C, Sonnenaufgang 05:48.“

Datengrundlage: Open-Meteo (Attribution bitte beibehalten, wo Sie Wetter anzeigen).

Wann nutzen?

Raum „Wetter“ / Statusanzeigen im Smart Home
Einfache Textanzeigen ohne eigenen Wetterdienst

Für PV-kWh-Schätzung → PV Forecast.

Endpoint


GET https://api.spotpriceapi.com/v1/plant/weather

Header:


X-API-Key: sf_live_YOUR_KEY

Mindestens Community. Basic → weather_status: not_available.

Query-Parameter

Parameter	Default	Werte	Bedeutung
`days`	`3`	1…7	Tagesvorschau ab heute
`timezone`	Profil / `Europe/Vienna`	IANA	Lokalzeiten
`locale`	aus TZ	`de` / `en`	Zustandstexte + Hinweise

Standort aus dem Portal

Koordinaten kommen aus dem Anlagenprofil. Fehlen sie → weather_status: incomplete_input mit portal_hint und portal_url.

Minimal-Beispiel


curl -s "https://api.spotpriceapi.com/v1/plant/weather?days=3&locale=de&timezone=Europe/Vienna" \
  -H "X-API-Key: sf_live_YOUR_KEY"


{
  "weather_status": "ok",
  "weather_engine": "plant_weather_v1",
  "quota_class": "weather",
  "current": {
    "temperature_c": 22.1,
    "relative_humidity_pct": 55,
    "wind_speed_kmh": 12.0,
    "wind_direction_text": "NW",
    "solar_radiation_pct": 78,
    "condition": "Heiter",
    "precipitation_mm": 0.0
  },
  "days": [
    {
      "date": "2026-08-12",
      "label": "D0",
      "temperature_max_c": 27.0,
      "temperature_min_c": 15.0,
      "condition": "Heiter",
      "sunrise": "05:48",
      "sunset": "20:31",
      "precipitation_mm": 0.0
    }
  ],
  "loxone": {
    "temp_c": 22.1,
    "humidity_pct": 55,
    "wind_kmh": 12.0,
    "solar_pct": 78,
    "condition": "Heiter",
    "wind_dir": "NW",
    "sunrise": "05:48",
    "sunset": "20:31"
  },
  "attribution": "Weather data by Open-Meteo.com"
}

Antwortfelder (Alltag)

Feld	Einfach
`weather_status`	`ok` / `incomplete_input` / `weather_missing` / `not_available`
`current.*`	Jetzt: Temp, Feuchte, Wind, Solar-%, Zustand
`days[]`	Min/Max, Zustand, Auf-/Untergang, Niederschlag
`loxone.*`	Flache Felder für PicoC (`temp_c`, `condition`, …)
`portal_hint` / `portal_url`	Wenn Koordinaten fehlen

Ablauf


Portal: Koordinaten
        ↓
GET /v1/plant/weather?days=3
        ↓
current + days + loxone.*
        ↓
Textanzeige / Virtual Inputs

Datenquelle & Aktualisierung

Punkt	Spec
Quelle	Open-Meteo Forecast am Anlagen-Lat/Lon
Cache	`plant_weather/{api_key_id}/latest.json` (gleicher Cache wie PV Forecast / Hours / Portal)
Inhalt	stündlich bis 16 Tage (+ past 7): Strahlung, Temp, Feuchte, Druck, Niederschlag, Wind, Wettercode; daily: Min/Max, Sonne, Regen
Refresh	Timer `spotforecast-plant-weather` 2×/Wiener Tag: ca. 05:20 und 12:20 Europe/Vienna (±15 min, nur HA Primary) · plus nach Geo-Speichern im Portal · Schema-Upgrade erzwingt Nachzieh auch am selben Tag · nach 12:00 gilt Morgen-Cache als stale, wenn der Fetch vor ~11:00 lag
API-Pfad	bei veraltetem Cache kurzer Nachzieh-Versuch (Timeout ~8 s), sonst `weather_missing`

Ohne Koordinaten im Portal gibt es keinen Cache und keinen Abruf.

Kontingent

Klasse weather: Community 48/Tag (Professional/OEM 288). Unabhängig von Decision und von pv.

Attribution

Wetterdaten: Open-Meteo. Bei öffentlicher Anzeige bitte Quelle nennen.

Nächste Schritte

Loxone Weather — PicoC + Virtual Output (Start + :10)
Loxone Überblick — gemeinsames Host-VO, Minutenplan
PV Forecast — Ertrag in kWh (Tmin/Tmax stecken schon in den PV-Texten)
Code-Beispiele

Mit SpotpriceAPI starten

Community registrieren oder Code-Beispiele mit Ihrem persönlichen Key.

Live API-Status