Forecast API Call und horizont parameter von api.akkudoktor.net

Der Akkudoktor - Kanal und Forum Akkudoktor-EOS
1

Hallo in die Runde!

Ich habe ein wenig mit der API experimentiert und dem horizont Parameter entdeckt. Die PV Vorhersagen sind für meinen Standort leider viel zu hoch, da ich am Wald wohne und gerade im Winter deutlich weniger Ertrag habe. Also habe ich versucht das mit dem horizont zu kompensieren.

Aber egal was ich angebe, power und dcPower bleiben gleich. Der Parameter selber wird erkannt:

"horizont": [
      {
        "altitude": 25,
        "transparency": 0.3,
        "azimuthFrom": -180,
        "azimuthTo": 180
      }
    ],
    "horizontString": "25t0.3"
...,
    {
      "datetime": "2025-11-04T08:00:00.000+01:00",
      "dcPower": 22.187959587868292,
      "power": 22.187959587868292,
...

Zum Test hatte ich 25t0.3 angeben. Leider ändert sich die dcPower oder Power Werte im Ergebnis überhaupt nicht. Selbst ein „unsinnigen“ Werten von t0.01 nicht. Er bleibt immer bei den 22,18

Was mache ich falsch?

Danke,

Volker

2

So wie ich mich erinnere must du die Azimuth-Werte und die Horizont-Werte als kommagetrennte Liste an die Akkudoktor API schicken. Für die Azimutwerte gilt: north=+-180, east=-90, south=0, west=90. Die Horizontwerte gibst du passend zu den Azimutwerten dann einfach als Grad 0..90 an.

3

Das ist leider so nicht richtig. Die API sagt

“For this, you use can a comma separated string with obsticals hight in angle (-180 = north, -90 = east, 0 = south, 90 = east). Also transparency is optional supported with a "t" after angle”

Also meint 25t0.3, dass eine eine Bereich (-180 - +180) Grad gibt und bis 25Grad Verschattung bei 30% transaprent. So lese ich auch die Antwort vom Service. Nur ändern sich die Werde nicht

4

Das ist die Definition von PVGIS, eigentlich der Standard bei solchen Daten:

”The horizon heights in the file should be given in a clockwise direction starting at North; that is, from North, going to East, South, West, and back to North. The values are assumed to represent equal angular distance around the horizon. For instance, if you have 36 values in the file, PVGIS assumes that the first point is due north, the next is 10 degrees east of north, and so on, until the last point, 10 degrees west of north.”

Es würde mich auch interessieren bei welcher Himmelsrichtung akkudoktor.net in der Liste für die Horizontwerte anfängt.

5

Guter Hinweiß. Aber erst mal möchte ich verstehen, was da falsch läuft. Ein Fehler bei meiner Nutzung oder ein Bug in der API? Wenn man nur einen Wert angibt, dann ist es erst mal egal, ob es von -180 - +180 geht oder anders rum.

Leider ist die Email von API-Team aus dem Swagger nicht mehr gültig. Vielleicht schau ich mit die API mal an. ggf. muss man ja einfach einen Account nutzen oder so was.

6

Ok, ich habe mir die API mal angesehen. An den Randbereichen von Sonnenaufgang sind die Werte von “direct_normal_irradiance” noch 0 und damit wirkt wohl nur die indirekte Einstrahlung auf die Zellen und die Verschattung hat keine Auswirkung. Im Laufe des Tages verringern sich die Wert schon im Vergleich.

Damit ist mein Punkt soweit klar. Aber Achtung, im Swagger ist ein Fehler in dem Bereich. Das Beispiel sagt 20t30, die Beschreibung 10t0.3,15t0.8. Die Werte zwischen 0…1 sind richtig. 20t30 müsste 20t0.3 heißen.

Auch habe ich noch einen Bug im DEBUG mode gefunden, der die API abstürzen lässt. Leider schient der Code aktuell nicht mehr bereut zu werden. Ein PR schient also nutzlos. Wobei der Fehler auch keinen Einfluss auf den normalen Betrieb hat.

7

Ich leite es mal an Nick weiter. Allerdings ist der forecast im EOS integriert und läuft da eigentlich ganz gut. Horizont funktioniert auch.
Ihr könnt dort im Code schauen, die Integration ist dort auf jeden Fall richtig.

8

Ich habe gerade auch ein paar Test gemacht.. Ist alles schon so lange her :blush:

https://api.akkudoktor.net/forecast?lat=55.45&lon=8.14&power=3400&azimuth=-30&tilt=35&timecycle=hourly&horizont=20t.1

ohne horizont

"datetime": "2025-11-13T13:00:00.000+01:00",
"dcPower": 472.35636539455,

20t.3
"dcPower": 355.207642683437,

20t.8
"dcPower": 438.994619564593,

20t.1
"dcPower": 321.53980700847,

Die Änderungen sind erkennbar

9

Habe ich auch gesehen. Es wird berücksichtigt, nur an den von mir gesehen Tagesanfang nicht, da die direkte Einstrahlung noch nicht wirkte.

@nick81 Aber im DEBUG stürzt es ab, da unten ein nicht definierter Wert ausgegeben wird.
if (DEBUG && horizont) calcResult.horizont = horizontVal

Volker

10

Kannst du den Fehler fixen und einen PR schicken? Du steckst da gerade sicherlich tiefer drin als ich.

11

Klar, ich mach die die Tage einen PR.

12

Das hatte ich total vergessen…

@nick81 fixing horizontValues im debug mode by volkerrichert · Pull Request #6 · nick81nrw/solApi · GitHub