Jazyk
DE NL FR DA EN CS

Home Assistant · cena elektřiny

Dvě rovnocenné cesty k datům o ceně a CO2 v Home Assistantu

Existují dvě plně podporované cesty: nativní integrace HACS s nastavením přes UI, nebo běžný REST senzor v YAML. Obě používají stejné API a vrací aktuální hodnoty, stav aktivního okna a nejužitečnější časová okna.

Přidat integraci HACS Otevřít živé JSON

Která cesta se hodí pro tebe?

Open-source repozitář integrace HACS: github.com/BackupBaTTerY/energypriceforecast-home-assistant. V HACS pod „Vlastní repozitáře" (kategorie Integration) přidej a nainstaluj „Energy Price Forecast EU", pak nastav přes Nastavení → Zařízení a služby. Pokud raději spravuješ vše v YAML, použij místo toho REST senzor níže na této stránce - obě cesty vrací stejná data.

Důležitý bod

API už lze použít přímo z Home Assistantu, skriptů i jiných automatizací - přes integraci HACS nebo přímo jako REST senzor.

Migrace API

Nové integrace by nyní měly používat https://api.energypriceforecast.eu/api/v1/.... Starší projektové URL ještě mohou pro některé existující setupy fungovat, ale pro nové integrace už nemají sloužit jako referenční cesta.

Doporučený endpoint

Pro Home Assistant je nejjednodušší vstup /api/v1/home-assistant/summary. Endpoint vrací nejen surové hodnoty, ale i už spočítaná okna pro nejlevnější, nejzelenější a kombinované použití.

https://api.energypriceforecast.eu/api/v1/home-assistant/summary?country=cz&hours=48&window_hours=4
Cenaflat.current_price a flat.cheapest_window_*.
CO2flat.current_co2_g_kwh a flat.greenest_window_* jsou pro CZ veřejně dostupné.
Kombinaceflat.combined_window_* vrací kompromis mezi cenou a CO2 i pro CZ.

Rychlý start pro copy-paste

Ano, stránka je záměrně napsaná tak, aby stačila běžná konfigurace Home Assistantu. Nejjednodušší postup je: vložit YAML blok, upravit trh, znovu načíst Home Assistant.

  1. Vlož níže uvedený YAML blok do configuration.yaml nebo do package souboru, který už Home Assistant načítá.
  2. Uprav jen parametr country.
  3. Home Assistant znovu načti nebo restartuj.
  4. V nástrojích pro vývojáře zkontroluj, že nové senzory vracejí hodnoty.
Vhodné i pro začátečníkyUkázka záměrně používá jednoduchá pole z flat místo složitějších template výrazů, aby zůstala copy-paste použitelná.
Co je potřeba změnitObvykle jen country. Zbytek může zůstat beze změny.
Co by mělo být potom vidětAlespoň jeden senzor pro aktuální cenu a jeden senzor pro nejlevnější okno.

Příklad REST senzoru

Ukázka níže dotazuje Česko každých 15 minut. U ostatních trhů se mění jen parametr country.

rest:
  - resource: "https://api.energypriceforecast.eu/api/v1/home-assistant/summary?country=cz&hours=48&window_hours=4"
    scan_interval: 900
    sensor:
      - name: "PredikceCenyElektřiny aktuální cena"
        value_template: "{{ value_json.flat.current_price }}"
        unit_of_measurement: "EUR/kWh"

      - name: "PredikceCenyElektřiny začátek nejlevnějšího okna"
        value_template: "{{ value_json.flat.cheapest_window_start }}"

Po vložení Home Assistant znovu načti nebo restartuj a zkontroluj hodnoty senzorů v nástrojích pro vývojáře.

Oficiální reference polí pro home-assistant/summary

Summary endpoint je záměrně kompaktní. Pro český trh je veřejně použitelný blok flat i strukturované bloky price, co2 a combined.

Pole Význam Typické použití
flat.current_priceAktuální cena v EUR/kWh.Jednoduchý cenový senzor pro automatizace.
flat.current_price_sourceZdroj aktuální ceny, například day_ahead.Kontrola, jestli už je hodnota oficiální.
flat.cheapest_window_*Začátek, konec a průměr nejlevnějšího okna.Posun flexibilní spotřeby.
price.currentObjekt s start, end, value, unit a source pro aktuální cenový slot.Dashboardy a přesnější logika.
price.cheapest_window_next_horizonStrukturovaný blok pro nejlevnější okno včetně délky a počtu zdrojů.Když potřebuješ začátek, konec a kontext společně.
flat.current_co2_g_kwhPro CZ je teď null.Veřejné CO2 zatím není k dispozici.
co2.availablePro CZ aktuálně false.Bezpečná kontrola v templatech, že CO2 data zatím nejsou dostupná.
combined.best_window_next_horizonPro CZ aktuálně null.Kombinované doporučení zatím veřejně neběží.
source.priceMetadata o cenovém zdroji včetně Firestore dokumentu a počtu dostupných záznamů.Debugging a monitoring.
Aktuální stav CZCZ je nyní veřejně dostupné pro cenu i CO2. Endpoint vrací cenu, CO2 a odpovídající časová okna; veřejná koncová cena zatím dostupná není.
Bez tichého fallbackuKdyž pro zemi nebo endpoint něco veřejně není otevřené, API to vrátí transparentně jako nedostupné místo tichého přepnutí na jiný trh.

Kdy stačí summary a kdy je lepší hourly-forecast?

summary stačí pro jednoduché cenové automatizace

Pokud potřebuješ jen aktuální cenu a nejlevnější okno, home-assistant/summary je správný endpoint. YAML zůstane krátký a nemusíš parsovat celou hodinovou řadu.

hourly-forecast je lepší pro grafy a vlastní logiku

Jestli chceš zobrazovat všechny hodinové hodnoty nebo počítat vlastní pravidla, použij hourly-forecast. Ten je pro podrobnější práci vhodnější.

Matice podpory veřejného API

Ne každý viditelný trh je zatím veřejně zapnutý ve všech endpointech. Níže je proto explicitně uvedeno, kde je který endpoint skutečně podporovaný.

Trh hourly-forecast home-assistant/summary co2-live Prognóza koncové ceny pro domácnost
retail-forecast
DEanoanoanoano
NLanoanoanoano
BEanoanoanone
FRanoanoanone
CZanoanoanone
ATanoanoanoano
PLanoanoanone
FIanoanoanone
SE1anoanoanone
SE2anoanoanone
SE3anoanoanone
SE4anoanoanone
DK1anoanoanoano
DK2anoanoanoano
NO1anoanoanoano
NO2anoanoanoano
NO3anoanoanoano
NO4anoanoanoano
NO5anoanoanoano
DánskoPro Dánsko vždy používej dk1 nebo dk2. Obecné dk spadne na DK1.
ČeskoCZ je teď veřejně dostupné pro cenu i CO2 v summary i live CO2 endpointu. Veřejná prognóza koncové ceny tam zatím není.
Koncová cena pro domácnostretail-forecast zde znamená odhad koncové ceny pro domácnost, ne jen čistou tržní nebo základní cenu. Veřejně je tento endpoint nyní otevřen pro DE, NL, DK1, DK2, AT a NO1 az NO5.

Důležité poznámky

Existuje oficiální integrace Home Assistantu?

Ano, k dispozici je nativní integrace HACS (aktuálně jako vlastní repozitář, viz srovnání výše). REST cesta na této stránce zůstává také plně podporovaná - je stabilnější, lépe se testuje a pro mnoho instalací úplně stačí.

Jsou ceny z API moje přesné koncové ceny elektřiny?

Ne automaticky. hourly-forecast a Home Assistant summary začínají tržní / základní cenou. Přesná koncová cena závisí podle země na síťových poplatcích, daních, odvodech a marži dodavatele.

Co se stane u nepodporované země?

Veřejné API teď vrací záměrně chybu místo tichého fallbacku na Německo. Je to úmyslně přísnější, aby automatizace neběžely nad špatnými daty.

Co dělat, když se po vložení YAML neukážou žádné hodnoty?

Nejčastější příčiny jsou: YAML je vložený na špatném místě, Home Assistant nebyl znovu načtený, country není podporované nebo je v YAML chyba v odsazení. Nástroje pro vývojáře a logy Home Assistantu to obvykle ukážou hned.