---
title: "Forecast.Solar"
description: "Integracija Forecast.Solar za TapHome. Predviđanje proizvodnje solarne elektrane za planiranje punjenja baterije, rada dizalice topline i punjenja vozila."
url: "https://taphome.com/hr/compatibility/forecast-solar/"
language: hr
lastmod: 2026-03-28
generator: hugo
ai:
  topics: ["http","data-service","solar-forecast","energy-management","cloud-api"]
  questions: ["Kako integrirati Forecast.Solar sa sustavom TapHome?","Kako TapHome predviđa proizvodnju energije solarnih panela?","Koji su parametri potrebni za uvoz Forecast.Solar u TapHome?","Zašto uređaj Forecast.Solar prikazuje nulu ili nema podataka?","Kako podatke o solarnoj prognozi koristiti za automatizaciju punjenja baterije?","Koja je razlika između uređaja s prognozom energije za pojedina vremenska razdoblja u Forecast.Solar?"]
---

# Forecast.Solar

Komunikacija: Packet Parser → HTTP

- [Službena stranica Forecast.Solar](https://forecast.solar)

## Upute za integraciju

Forecast.Solar je besplatni API u oblaku koji procjenjuje proizvodnju energije solarne elektrane prema lokaciji, orijentaciji panela i instaliranoj snazi. Kombinira podatke o ozračenosti iz EU sustava PVGIS (Photovoltaic Geographical Information System) s vremenskom prognozom kako bi predvidio koliko će energije solarna elektrana proizvesti.

TapHome se na ovu uslugu spaja preko HTTPS-a s pomoću HTTP predloška PacketParser. Predložak jednom na sat šalje upit krajnjoj točki `/estimate` (unutar besplatnog ograničenja od 12 zahtjeva na sat) i daje šest senzora energije koji se mogu samo čitati: četiri vremenska razdoblja tekućeg dana i dnevne ukupne vrijednosti za danas i sutra. Autentifikacija ni API ključ nisu potrebni.

## Konfiguracija

Pri uvozu predloška potrebno je pet parametara. Oni opisuju solarnu elektranu i služe za sastavljanje URL-a API zahtjeva:

- **Latitude**: zemljopisna širina lokacije fotonaponskog sustava u decimalnom obliku (npr. `48.1778` za Bratislavu). Raspon: -90 do 90, preciznost do 0,0001 (točnost ~10 m).
- **Longitude**: zemljopisna dužina lokacije fotonaponskog sustava u decimalnom obliku (npr. `17.1426` za Bratislavu). Raspon: -180 do 180.
- **PV_declination**: kut nagiba panela u stupnjevima. `0` = vodoravno (ravni krov), `90` = okomito (na zidu). Uobičajene vrijednosti za kuće: 20–45.
- **PV_azimuth**: orijentacija panela prema stranama svijeta. `-180` ili `180` = sjever, `-90` = istok, `0` = jug, `90` = zapad. Za panele okrenute prema jugu koristite `0`.
- **PV_kWp**: ukupna instalirana snaga fotonaponskog sustava u kilovatima vršne snage (npr. `5` za sustav od 5 kWp).

Svih pet parametara sprema se kao varijable modula u TapHome i mogu se promijeniti nakon uvoza bez ponovnog uvoza predloška.

> [!WARNING]
> API Forecast.Solar koristi drugačiju konvenciju azimuta od nekih drugih alata. U ovom API-ju **0 = jug**, a vrijednosti rastu u smjeru kazaljke na satu (-90 = istok, 90 = zapad, 180/-180 = sjever). Ako prelazite s Home Assistanta (gdje je 180 = jug), od vrijednosti iz HA oduzmite 180.

> [!TIP]
> Koordinate ćete pronaći tako da u Google Maps desnom tipkom miša kliknete na svoju lokaciju i kopirate vrijednosti zemljopisne širine i dužine.

## Kako radi

Modul u svakom ciklusu očitavanja šalje jedan HTTP zahtjev:

```
GET /estimate/{Latitude}/{Longitude}/{PV_declination}/{PV_azimuth}/{PV_kWp}
Accept: application/json
```

API vraća JSON odgovor s kumulativnim vatsatima za svaki sat (`watt_hours`), energijom po razdoblju (`watt_hours_period`), trenutačnom snagom (`watts`) i dnevnim ukupnim vrijednostima (`watt_hours_day`). Predložak obrađuje `watt_hours` i `watt_hours_day` i iz njih izvodi svih šest vrijednosti uređaja.

Iz metapodataka odgovora čitaju se dva servisna atributa: **Lokacija** (prepoznati naziv lokacije, npr. „Bratislava, Slovakia”) i **Vremenska zona** (npr. „Europe/Bratislava”). Vidljivi su u detaljima modula i potvrđuju da je API ispravno prepoznao lokaciju.

## Mogućnosti uređaja

Predložak sadrži šest senzora energije koji se mogu samo čitati. Sve su vrijednosti u vatsatima (Wh) i predstavljaju predviđenu proizvodnju solarne elektrane.

### Prognoza energije po vremenskim razdobljima

Dan je podijeljen na četiri vremenska razdoblja. Svaki uređaj prikazuje očekivanu proizvodnju energije za to razdoblje:

- **Energija 0–9 h**: predviđena proizvodnja od ponoći do 9:00. Čita kumulativnu vrijednost vatsati u 09:00. Na većini lokacija to obuhvaća razdoblje od izlaska sunca do ranog jutra.
- **Energija 9–12 h**: predviđena proizvodnja od 9:00 do 12:00. Izračunava se kao razlika kumulativnih vrijednosti u 12:00 i 09:00.
- **Energija 12–15 h**: predviđena proizvodnja od 12:00 do 15:00. Izračunava se kao razlika kumulativnih vrijednosti u 15:00 i 12:00. Obično je to razdoblje najveće proizvodnje.
- **Energija 15–0 h**: predviđena proizvodnja od 15:00 do kraja dana. Izračunava se kao dnevna ukupna vrijednost umanjena za kumulativnu vrijednost u 15:00. U praksi obuhvaća razdoblje od 15:00 do zalaska sunca, jer proizvodnja nakon mraka pada na nulu.

Zahvaljujući toj podjeli smart rules mogu se vezati uz određene dijelove dana, npr. punjenje baterije u vršnom razdoblju 12–15 h ili odgodu energetski zahtjevnih zadataka na sate s najvećom očekivanom proizvodnjom.

### Dnevne ukupne vrijednosti

- **Prognoza solarne energije (danas)**: ukupna predviđena proizvodnja energije za tekući dan. Izravno čita vrijednost `watt_hours_day` za današnji datum.
- **Prognoza solarne energije (sutra)**: ukupna predviđena proizvodnja energije za sljedeći dan. Koristi sutrašnji datum iz istog API odgovora.

Ove ukupne vrijednosti korisne su za dnevno planiranje, npr. za odluku hoće li dizalica topline raditi na solarnu energiju ili na energiju iz mreže, prema očekivanoj solarnoj proizvodnji.

### Dodatne mogućnosti

API Forecast.Solar daje i procjene trenutačne snage (vati po razdoblju od 15 minuta), podatke o energiji po razdoblju bez kumulativnog izračuna i vrijeme najveće proizvodnje. Plaćeni paketi dodaju podršku za više orijentacija panela (2–4 plohe), povijesne podatke o proizvodnji, procjene za vedro nebo i faktore prigušenja za korekciju zasjenjenja. Mogu se dodati u budućem ažuriranju predloška.

## Primjeri automatizacije

### Punjenje baterije prema prognozi

Uređaj **Prognoza solarne energije (danas)** koristite u smart rule:

- Uvjet: Prognoza solarne energije (danas) > 15000 (Wh = 15 kWh)
- Radnja: bateriju prebacite u način „punjenje samo iz solarne elektrane”

Za oblačnih dana, kad je predviđena proizvodnja niska, bateriju umjesto toga prebacite na punjenje iz mreže u satima jeftine tarife.

### Planiranje energetski zahtjevnih zadataka

Uređaje za vremenska razdoblja koristite za određivanje najboljeg razdoblja za zadatke s velikom potrošnjom:

- Uvjet: Energija 12–15 h > 3000 (Wh)
- Radnja: u 12:00 pokrenite crpku bazena, grijač vode ili punjenje električnog vozila

## Rješavanje problema

### Svi uređaji prikazuju nulu ili NaN

1. Provjerite internetsku vezu centralne jedinice TapHome Core: predložak treba izlazni HTTPS pristup na `api.forecast.solar`
2. Provjerite odgovara li API: u pregledniku otvorite `https://api.forecast.solar/estimate/48.1778/17.1426/45/0/5` (zamijenite svojim parametrima)
3. Ako greška sadrži statusni kod (npr. „429”), prekoračeno je ograničenje broja zahtjeva. Besplatni paket dopušta 12 zahtjeva na sat: pričekajte da se broj zahtjeva u zadnjih sat vremena smanji
4. Statusni kod 400 obično znači neispravne koordinate (zemljopisna širina i dužina možda su zamijenjene ili je lokacija na vodi)

### Vrijednosti prognoze čine se previsokima ili preniskima

1. Provjerite odgovara li parametar **PV_kWp** stvarnoj instaliranoj snazi: izravno skalira sve vrijednosti prognoze
2. Provjerite **PV_declination**: vodoravni panel (0) proizvodi manje od optimalno nagnutog panela (30–40 u srednjoj Europi)
3. Provjerite **PV_azimuth**: provjerite odgovara li orijentacija stvarnosti. Upamtite: u ovom API-ju 0 = jug
4. API koristi podatke vremenske prognoze koji možda ne odražavaju lokalne uvjete (obližnje zgrade, drveće, privremeno zasjenjenje). Za korekciju zasjenjenja koristite faktor prigušenja u plaćenom paketu API-ja

### Energija 15–0 h prikazuje neočekivano niske vrijednosti

To je očekivano ponašanje. Uređaj „15–0 h” izračunava dnevnu ukupnu vrijednost umanjenu za kumulativnu proizvodnju u 15:00. Budući da proizvodnja solarne elektrane praktički prestaje zalaskom sunca, ova vrijednost predstavlja proizvodnju od 15:00 do zalaska sunca, a ne do ponoći. Zimi, kad sunce rano zalazi, vrijednost može biti vrlo mala.

> [!NOTE]
> API Forecast.Solar provodi tromjesečno održavanje 1. dana prvog mjeseca svakog tromjesečja oko ponoći UTC (siječanj, travanj, srpanj, listopad). Tijekom održavanja API vraća HTTP 503, a uređaji privremeno prikazuju greške.

## Dostupni uređaji 6

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

Forecast.Solar Modul

Servisni atributi

|                |                                                                                                              |
|----------------|--------------------------------------------------------------------------------------------------------------|
| Lokacija       | Naziv lokacije koji je API odredio iz poslanih koordinata, potvrđuje da je API prepoznao ispravnu lokaciju   |
| Vremenska zona | Vremenska zona koju je API odredio za postavljenu lokaciju, služi za ispravno usklađivanje vremenskih oznaka |

Prilagođene varijable

|                            |                                                                                                   |
|----------------------------|---------------------------------------------------------------------------------------------------|
| `Latitude` (numeric)       | Zemljopisna širina solarne elektrane u decimalnim stupnjevima (postavlja se pri uvozu)            |
| `Longitude` (numeric)      | Zemljopisna dužina solarne elektrane u decimalnim stupnjevima (postavlja se pri uvozu)            |
| `PV_declination` (numeric) | Kut nagiba fotonaponskih panela u stupnjevima (0 = vodoravno, 90 = okomito)                       |
| `PV_azimuth` (numeric)     | Orijentacija fotonaponskih panela u stupnjevima (0 = jug, -90 = istok, 90 = zapad, ±180 = sjever) |
| `PV_kWp` (numeric)         | Instalirana vršna snaga fotonaponskog sustava u kilovatima                                        |

Čitanje (modul)

```taphome
VAR response := SENDHTTPREQUEST("/estimate/" + Latitude + "/" + Longitude + "/" + PV_declination + "/" + PV_azimuth + "/" + PV_kWp, "GET", "", "Accept: application/json");
IF response.IsSuccess
    output := response.Content;
ELSE
    ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
END
```

Servisni atributi

Place

```taphome
PARSEJSON(output, "$.message.info.place")
```

Time zone

```taphome
PARSEJSON(output, "$.message.info.timezone")
```

Energija 0–9 h Varijabla Samo za čitanje

Predviđena solarna energija od ponoći do 9:00, kumulativni vatsati u 09:00

numeric Jedinica: Wh json\_path

Čitanje

```taphome
var date := tostring(NOW(), "yyyy-MM-dd");

var tmp := PARSEJSON(output,"$.result.watt_hours");

PARSETEXT(tmp, date + " 09:00:00\":", ",");
```

Energija 9–12 h Varijabla Samo za čitanje

Predviđena solarna energija od 9:00 do 12:00, razlika kumulativnih vatsati u 12:00 i 09:00

numeric Jedinica: Wh json\_path

Čitanje

```taphome
var date := tostring(NOW(), "yyyy-MM-dd");

var tmp := PARSEJSON(output,"$.result.watt_hours");

var h9 := PARSETEXT(tmp, date + " 09:00:00\":", ",");
var h12 := PARSETEXT(tmp, date + " 12:00:00\":", ",");

h12 - h9
```

Energija 12–15 h Varijabla Samo za čitanje

Predviđena solarna energija od 12:00 do 15:00, razlika kumulativnih vatsati u 15:00 i 12:00

numeric Jedinica: Wh json\_path

Čitanje

```taphome
var date := tostring(NOW(), "yyyy-MM-dd");

var tmp := PARSEJSON(output,"$.result.watt_hours");

var h12 := PARSETEXT(tmp, date + " 12:00:00\":", ",");
var h15 := PARSETEXT(tmp, date + " 15:00:00\":", ",");

h15 - h12
```

Energija 15–0 h Varijabla Samo za čitanje

Predviđena solarna energija od 15:00 do kraja dana, dnevna ukupna vrijednost umanjena za kumulativne vatsate u 15:00

numeric Jedinica: Wh json\_path

Čitanje

```taphome
var date := tostring(NOW(), "yyyy-MM-dd");

var tmp := PARSEJSON(output,"$.result.watt_hours");

var last := PARSEJSON(output, "$.result.watt_hours_day." + date);

var h15 := PARSETEXT(tmp, date + " 15:00:00\":", ",");

last - h15
```

Prognoza solarne energije (danas) Varijabla Samo za čitanje

Ukupna predviđena proizvodnja solarne energije za tekući dan u vatsatima

numeric Jedinica: Wh json\_path

Čitanje

```taphome
var date := tostring(NOW(), "yyyy-MM-dd");

PARSEJSON(output, "$.result.watt_hours_day." + date)
```

Prognoza solarne energije (sutra) Varijabla Samo za čitanje

Ukupna predviđena proizvodnja solarne energije za sljedeći dan u vatsatima

numeric Jedinica: Wh json\_path

Čitanje

```taphome
var date := tostring(DATETIMEADD(NOW(), 0, 0, 1), "yyyy-MM-dd");

PARSEJSON(output, "$.result.watt_hours_day." + date)
```

**Povezivanje:** Packet Parser → HTTP

Moguća poboljšanja (9)

- Instantaneous Power (watts) — Power average (W) per 15-min period — HA integration exposes this as 'Estimated Power Production — Now'
- Energy per Period (watt\_hours\_period) — Energy produced in each 15-min period — alternative to cumulative watt\_hours with delta calculation
- Remaining Energy Today — Daily total minus current cumulative — HA exposes this, template could compute from existing data
- Peak Production Time — Timestamp of highest watts value — requires iterating watts object, not trivially extractable with PARSEJSON
- Multi-Plane Support (2-4 planes) — Paid tiers support 2-4 panel orientations per request — requires API key import parameter
- Historic Production Data — Past production data for comparison — requires paid API key
- Clear Sky Estimate — Theoretical maximum production without clouds — requires Professional tier API key
- Damping Factor (shadow adjustment) — Adjusts morning/evening predictions for shadows, trees, buildings — could be added as import parameter
- Inverter Power Limit — Limits peak prediction to inverter capacity — could be added as import parameter

## Parametri uvoza

Ove vrijednosti unosite pri uvozu XML-a.

| Pitanje u aplikaciji                                               | Zadano    |
|--------------------------------------------------------------------|-----------|
| latitude: zemepisná šírka v desiatkovej sústave                    | `48.1778` |
| longitude: zemepisná dĺžka v desiatkovej sústave                   | `17.1426` |
| PV\_declination: sklon PV systému (0 = vodorovne, 90 = vertikálne) | `45`      |
| PV\_azimuth: orientácia PV voči severu (0 = sever, 180 = juh)      | `0`       |
| PV\_kWp: výkon inštalovaných panelov v kilowatoch                  | `5`       |

## Izvori

- Forecast.Solar API — /estimate Endpoint
  
  [doc.forecast.solar](https://doc.forecast.solar/api:estimate) 2026-03-28
- Forecast.Solar API — General Documentation
  
  [doc.forecast.solar](https://doc.forecast.solar/api) 2026-03-28
- Forecast.Solar — Home Assistant Integration
  
  [www.home-assistant.io](https://www.home-assistant.io/integrations/forecast_solar/) 2026-03-28
- Forecast.Solar — Python Client Library (GitHub)
  
  [github.com](https://github.com/home-assistant-libs/forecast_solar) 2026-03-28

## Povezana dokumentacija

- [Packet Parser Integration](https://taphome.com/hr/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hr/docs/integration/packet-parser/)
- [Funkcije Packet parsera](https://taphome.com/hr/docs/script/packet-parser/)
- [Funkcije za raščlambu](https://taphome.com/hr/docs/script/parsing-functions/)

