Home Assistant · cena elektřiny
Pro Home Assistant tu není potřeba speciální integrace
Pro český trh stačí běžný REST senzor. Veřejný summary endpoint teď pokrývá hlavně cenu elektřiny a nejlevnější časová okna. Veřejné CO2 pole pro CZ je nyní otevřené.
- není potřeba add-on ani HACS komponenta
- jeden endpoint pro cenu, CO2 a užitečná časová okna
- bez tichého fallbacku na jinou zemi
API už lze použít přímo z Home Assistantu, skriptů i jiných automatizací. Chyběla hlavně srozumitelná dokumentace, ne nová technická integrace.
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=4flat.current_price a flat.cheapest_window_*.flat.current_co2_g_kwh a flat.greenest_window_* jsou pro CZ veřejně dostupné.flat.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.
- Vlož níže uvedený YAML blok do
configuration.yamlnebo do package souboru, který už Home Assistant načítá. - Uprav jen parametr
country. - Home Assistant znovu načti nebo restartuj.
- V nástrojích pro vývojáře zkontroluj, že nové senzory vracejí hodnoty.
flat místo složitějších template výrazů, aby zůstala copy-paste použitelná.country. Zbytek může zůstat beze změny.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_price | Aktuální cena v EUR/kWh. | Jednoduchý cenový senzor pro automatizace. |
flat.current_price_source | Zdroj 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.current | Objekt s start, end, value, unit a source pro aktuální cenový slot. | Dashboardy a přesnější logika. |
price.cheapest_window_next_horizon | Strukturovaný 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_kwh | Pro CZ je teď null. | Veřejné CO2 zatím není k dispozici. |
co2.available | Pro CZ aktuálně false. | Bezpečná kontrola v templatech, že CO2 data zatím nejsou dostupná. |
combined.best_window_next_horizon | Pro CZ aktuálně null. | Kombinované doporučení zatím veřejně neběží. |
source.price | Metadata o cenovém zdroji včetně Firestore dokumentu a počtu dostupných záznamů. | Debugging a monitoring. |
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ácnostretail-forecast |
|---|---|---|---|---|
| DE | ano | ano | ano | ano |
| NL | ano | ano | ano | ano |
| BE | ano | ano | ano | ne |
| FR | ano | ano | ano | ne |
| CZ | ano | ano | ano | ne |
| AT | ano | ano | ano | ano |
| PL | ano | ano | ano | ne |
| FI | ano | ano | ano | ne |
| SE1 | ano | ano | ano | ne |
| SE2 | ano | ano | ano | ne |
| SE3 | ano | ano | ano | ne |
| SE4 | ano | ano | ano | ne |
| DK1 | ano | ano | ano | ano |
| DK2 | ano | ano | ano | ano |
| NO1 | ano | ano | ano | ano |
| NO2 | ano | ano | ano | ano |
| NO3 | ano | ano | ano | ano |
| NO4 | ano | ano | ano | ano |
| NO5 | ano | ano | ano | ano |
dk1 nebo dk2. Obecné dk spadne na DK1.retail-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
Je to oficiální integrace Home Assistantu?
Ne. Záměrně jde o jednoduchou REST cestu. 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.