docs: solar forecast (#18789)

evcc-io · Feb 14, 2025 · 6e6d630 · 6e6d630
1 parent 9bbac3e
commit 6e6d630
Show file tree

Hide file tree

Showing 2 changed files with 41 additions and 0 deletions.
diff --git a/templates/definition/tariff/forecast-solar.yaml b/templates/definition/tariff/forecast-solar.yaml
@@ -2,20 +2,52 @@ template: forecast-solar
 products:
   - brand: Forecast.Solar
 requirements:
+  description:
+    en: "[forecast.solar](https://forecast.solar) can be used for free. Paid plans can also be used by specifying an API key."
+    de: "[forecast.solar](https://forecast.solar) kann kostenlos verwendet werden. Kostenpflichtige Pläne können ebenfalls verwendet werden, indem ein API-Key angegeben wird."
   evcc: ["skiptest"]
 group: solar
 params:
   - name: lat
+    description:
+      en: latitude
+      de: Breitengrad
+    example: "55.7351"
     required: true
   - name: lon
+    description:
+      en: longitude
+      de: Längengrad
+    example: "9.1275"
     required: true
   - name: dec
+    description:
+      en: decline
+      de: Winkel
+    help:
+      en: 0 = horizontal, 90 = vertical
+      de: 0 = horizontal, 90 = vertikal
+    example: 25
     required: true
   - name: az
+    description:
+      en: azimuth
+      de: Azimut
+    help:
+      en: 0 = south, 90 = west, 180 = north, 270 = east
+      de: 0 = Süden, 90 = Westen, 180 = Norden, 270 = Osten
+    example: 180
     required: true
   - name: kwp
+    description:
+      en: Maximum power (kWp)
+      de: Maximalleistung (kWp)
+    example: 9.8
     required: true
   - name: apikey
+    description:
+      en: API key
+      de: API-Key
     advanced: true
 render: |
   type: custom

diff --git a/templates/definition/tariff/solcast.yaml b/templates/definition/tariff/solcast.yaml
@@ -2,12 +2,21 @@ template: solcast
 products:
   - brand: Solcast
 requirements:
+  description:
+    en: Requires a [solcast.com](https://solcast.com/free-rooftop-solar-forecasting) account. The free "Home User" tier is often sufficient for private use. This plan has an API limit of 10 requests per day.
+    de: Benötigt einen [solcast.com](https://solcast.com/free-rooftop-solar-forecasting)-Account. Der kostenlose "Home User" Tarif ist für private Anwendungen oft ausreichend. Dieser Plan hat ein API-Limit von 10 Anfragen pro Tag.
   evcc: ["skiptest"]
 group: solar
 params:
   - name: site
+    help:
+      en: ressource ID of your site
+      de: Ressource ID deiner Anlage
     required: true
   - name: token
+    help:
+      en: Solcast API Token
+      de: Solcast API Token
     required: true
 render: |
   type: solcast