Přesné denní úhrny srážek z bezprostředního okolí vašeho domu - bez vlastního srážkoměru

V článku o chytrých zavlažovacích ventilech jsme slíbili, že sepíšeme návod, jak do Home Assistant dostat denní úhrny srážek z bezprostředního okolí vašeho domu - bez vlastního srážkoměru.

Využijeme srážkoměry vašich sousedů: po celém Česku (po celém světě) běží tisíce soukromých meteostanic, které svá data posílají do sítě Weather Underground, a ta se dají číst i z Home Assistant. Déšť totiž může být velmi lokální záležitost a data z předpovědí počasí jsou často dost nepřesná. Letní bouřka dokáže zalít jednu čtvrť dvaceti milimetry, zatímco tři kilometry vedle nespadne skoro nic.

Tento screenshot z mapy je správně, dnes prostě nikde v ČR neprší.

Není to oficiálně podporovaná cesta

Než se pustíme do návodu, jedno důležité upozornění.

Weather Underground (patří pod The Weather Company) vydává bezplatné API klíče jen majitelům meteostanic, kteří do sítě posílají vlastní data. Pokud meteostanici s podporou nahrávání do Weather Underground máte nebo o ní uvažujete, zaregistrujte ji - dostanete vlastní oficiální klíč a máte vystaráno. To je jediná oficiální bezplatná cesta a doporučujeme ji.

Návod v tomto článku se ale obejde i bez vlastní stanice. Používá totiž API klíč, který má web wunderground.com uložený ve svém vlastním kódu - stejný klíč, přes který se data načítají každému návštěvníkovi mapy stanic. Není to klíč vydaný vám a nikdo vám u něj nic negarantuje.

Je to legální? Není to nelegální?

Nejde o žádné prolamování zabezpečení - API klíč, na kterém je to postaveno, dostane do prohlížeče každý návštěvník webu a data jsou veřejně dostupná. Soudy v USA, kde The Weather Company sídlí, opakovaně potvrdily, že čtení veřejně dostupných dat není trestný čin. Podmínky služby weather.com nicméně automatizované stahování dat mimo oficiálně vydaný klíč nepovolují - jejich porušení ale není porušení zákona, je to smluvní záležitost mezi vámi a provozovatelem a nejhorší, co za to hrozí, je zablokování přístupu (prakticky: výměna klíče).

Neděláte tedy nic nelegálního, ale stojí za zvážení, jestli je to stoprocentně etické: síť Weather Underground žije z dat dobrovolníků a tímhle postupem z ní jen čerpáte. I proto doporučujeme zvážit investici do vlastní meteostanice se srážkoměrem - budete do sítě přispívat, využívat ji jako plnohodnotný člen a získáte vlastní oficiální API klíč.

Jedná se ale o investici v řádech vyšších tisíců až desítek tisíc Kč. Rozhodnutí je na vás.
(my bohužel takovou stanici v nabídce nemáme)

Funguje to ale už od roku 2018

Krátká historie: Weather Underground koupila v roce 2016 společnost IBM v rámci akvizice The Weather Company. V roce 2018 IBM oznámila konec bezplatných veřejných API klíčů a začátkem roku 2019 staré klíče přestaly platit. Web wunderground.com ovšem data zobrazovat nepřestal, takže ve svém kódu nese veřejně viditelný klíč. Komunita kolem chytrých domácností ho používá zhruba od roku 2019 a za celou dobu se stalo jediné: klíč se jednou vyměnil za jiný. Nový se našel během několika dní a vše jelo dál.

V roce 2024 IBM prodala The Weather Company investiční skupině Francisco Partners. Ani změna majitele na fungování nic nezměnila - API pro soukromé meteostanice běží dál, používají ho platící firemní zákazníci, majitelé stanic i samotný web. Oznámení o ukončení nikde nepadlo.

Prakticky to znamená:

• Funguje to nepřetržitě od roku 2018 a přežilo to i prodej celé firmy. Je dost pravděpodobné, že poběží i další roky.
• Nejpravděpodobnější komplikace není vypnutí API, ale výměna (rotace) klíče. Ta neznamená konec funkčnosti - jen v konfiguraci přepíšete jeden řetězec za nový.
• Přesto s tím počítejte jako s neoficiální cestou. V závěru článku si proto postavíme hlídače, který vás na výpadek sám upozorní.

Jak to bude fungovat

Najdeme několik soukromých meteostanic se srážkoměrem ve vašem okolí. Home Assistant se jich bude každých dvacet minut ptát na dnešní úhrn srážek a na aktuální intenzitu deště. Z hodnot pak vyrobíme jeden binární senzor „přeskočit zálivku“, který pracuje s:

• mediánem denních úhrnů ze všech stanic - jedna vadná nebo ucpaná stanice výsledek nerozhodí,
• aktuální intenzitou - když právě prší, není třeba čekat, až úhrn naroste přes práh,
• nastavitelným prahem v milimetrech, který doladíte přímo v aplikaci bez zásahu do konfigurace.

Pro příklady v článku jsme si vybrali fiktivní adresu - brněnský hrad Špilberk. Vy si všude dosadíte vlastní stanice ze svého okolí.

Ještě jedna poznámka ke kódu: části, které si upravíte podle sebe (hlavně ID stanic), jsou v ukázkách zvýrazněné červeně. Zbytek můžete kopírovat beze změny.

Krok 1: Najděte srážkoměry ve svém okolí

Otevřete mapu stanic wunderground.com/wundermap a najděte na ní svůj dům - mapa se ovládá stejně jako kterákoli jiná, stačí si přiblížit své okolí. Každá ikonka s teplotou je jedna soukromá meteostanice. Po kliknutí na ikonku se zobrazí detail stanice včetně jejího ID (například IBRNO599) - přesně ten údaj budeme potřebovat.

U každé vybrané stanice si klikněte i na její přehled s grafy a zkontrolujte dvě věci: jestli posílá srážky (položka „Precip“) a jestli jsou data čerstvá.

Ne každá stanice totiž srážkoměr má - levnější modely měří jen teplotu a vlhkost. A některé stanice už majitel odpojil, jen na mapě ještě nějakou dobu zůstávají. Obojí nás potkalo i u Špilberku: jedna stanice v nejbližším okolí srážky vůbec neposílá (IBRNO445) a další nevrací žádná data (IBRNO491). Skončili jsme u těchto čtyř:

Jedna rada z praxe: přidejte si na začátek stanic raději víc a několik dnů až týdnů je sledujte. Stane se totiž, že stanice vypadá funkční - hlásí teplotu, data má čerstvá - ale ani po vydatném dešti nevykáže žádné srážky, protože má srážkoměr ucpaný nebo rozbitý. To z mapy nepoznáte, ukáže to až srovnání stanic mezi sebou po prvním dešti. Po pár týdnech pozorování ty nespolehlivé ze seznamu vyřadíte. Medián si s jednou vadnou stanicí poradí, ale čím lepší vstupy, tím líp.

Ve větších městech najdete použitelné stanice do kilometru, na vesnicích počítejte spíš s jednotkami kilometrů. I stanice pět kilometrů daleko je ale většinou blíž realitě vaší zahrady než předpověď nebo vzdálené letiště.

Krok 2: Přidejte srážkové senzory do Home Assistant

Konfiguraci uděláme v jednom souboru - takzvaném balíčku (package). Pokud balíčky ještě nepoužíváte, přidejte jednou do configuration.yaml tyto řádky a ve složce s konfigurací vytvořte podsložku packages

homeassistant:
  packages: !include_dir_named packages

Do složky packages pak uložte nový soubor srazky_wu.yaml. Začneme senzory - pro každou stanici jeden blok. Měníte jen ID stanice v názvu a v adrese; zbytek adresy včetně API klíče nechte přesně tak, jak je:

sensor:
  - platform: rest
    name: Srážky WU IBRNO599
    unique_id: srazky_wu_ibrno599
    resource: "https://api.weather.com/v2/pws/observations/current?stationId=IBRNO599&format=json&units=m&apiKey=e1f10a1e78da46f5b10a1e78da96f525"
    value_template: "{{ value_json.observations[0].metric.precipTotal | default(0, true) }}"
    unit_of_measurement: "mm"
    state_class: measurement
    scan_interval: 1200
    json_attributes_path: "$.observations[0].metric"
    json_attributes:
      - precipRate

  - platform: rest
    name: Srážky WU IBRNO744
    unique_id: srazky_wu_ibrno744
    resource: "https://api.weather.com/v2/pws/observations/current?stationId=IBRNO744&format=json&units=m&apiKey=e1f10a1e78da46f5b10a1e78da96f525"
    value_template: "{{ value_json.observations[0].metric.precipTotal | default(0, true) }}"
    unit_of_measurement: "mm"
    state_class: measurement
    scan_interval: 1200
    json_attributes_path: "$.observations[0].metric"
    json_attributes:
      - precipRate

  - platform: rest
    name: Srážky WU IBRNO741
    unique_id: srazky_wu_ibrno741
    resource: "https://api.weather.com/v2/pws/observations/current?stationId=IBRNO741&format=json&units=m&apiKey=e1f10a1e78da46f5b10a1e78da96f525"
    value_template: "{{ value_json.observations[0].metric.precipTotal | default(0, true) }}"
    unit_of_measurement: "mm"
    state_class: measurement
    scan_interval: 1200
    json_attributes_path: "$.observations[0].metric"
    json_attributes:
      - precipRate

  - platform: rest
    name: Srážky WU IBRNO578
    unique_id: srazky_wu_ibrno578
    resource: "https://api.weather.com/v2/pws/observations/current?stationId=IBRNO578&format=json&units=m&apiKey=e1f10a1e78da46f5b10a1e78da96f525"
    value_template: "{{ value_json.observations[0].metric.precipTotal | default(0, true) }}"
    unit_of_measurement: "mm"
    state_class: measurement
    scan_interval: 1200
    json_attributes_path: "$.observations[0].metric"
    json_attributes:
      - precipRate

K jednotlivým řádkům: stav senzoru je precipTotal - dnešní úhrn srážek v milimetrech, který se o půlnoci vynuluje (k tomu se ještě vrátíme). Atribut precipRate je aktuální intenzita deště - podle ní poznáme, že právě prší. scan_interval: 1200 znamená dotaz jednou za 20 minut, což pro zálivku stačí.

Po uložení a restartu Home Assistant najdete nové senzory ve Vývojářské nástroje → Stavy:

Krok 3: Vytvořte si práh srážek jako pomocníka

Kolik musí napršet, aby se zálivka přeskočila? To je hodnota, kterou budete chtít časem ladit, proto ji neuložíme napevno do kódu, ale jako pomocníka. V Nastavení → Zařízení a služby → Pomocníci klikněte na Vytvořit pomocníka a vyberte typ Číslo. Vyplňte:

• Název: Práh srážek
• Ikona: mdi:weather-rainy
• Minimální hodnota: 0, maximální hodnota: 100
• Režim zobrazení: Vstupní pole
• Velikost kroku: 0,5
• Měrná jednotka: mm

Vznikne entita input_number.prah_srazek (Home Assistant odvodí ID z názvu - zkontrolujte si ho v detailu pomocníka). Nastavte jí hodnotu 5 - to je osvědčený výchozí bod: slabé mrholení zálivku nezruší, vydatnější déšť ano.

Krok 4: Slučte stanice do jednoho senzoru

Čtyři samostatná čísla jsou hezká, ale automatizace potřebuje jednoznačnou odpověď: mám dnes zalévat, nebo ne? Do souboru srazky_wu.yaml proto doplňte binární senzor, který stanice sloučí. Upravíte v něm jen seznamy senzorů - dosadíte názvy svých senzorů z kroku 2 (funguje to stejně pro dvě i pro šest stanic):

template:
  - binary_sensor:
      - name: Přeskočit zálivku - déšť
        unique_id: preskocit_zalivku_dest
        icon: mdi:water-off
        state: >
          {% set prah = states('input_number.prah_srazek') | float(5) %}
          {% set ids = [
            'sensor.srazky_wu_ibrno599', 'sensor.srazky_wu_ibrno744',
            'sensor.srazky_wu_ibrno741', 'sensor.srazky_wu_ibrno578'] %}
          {% set hodnoty = ids | map('states') | reject('in', ['unknown','unavailable','none','None',''])
                               | map('float', 0) | list | sort %}
          {% set n = hodnoty | length %}
          {% if n == 0 %}{% set median = 0.0 %}
          {% elif n % 2 == 1 %}{% set median = hodnoty[(n - 1) // 2] %}
          {% else %}{% set median = (hodnoty[n // 2 - 1] + hodnoty[n // 2]) / 2 %}{% endif %}
          {% set intenzity = ids | map('state_attr', 'precipRate')
                                 | reject('in', [none, 'unknown', 'unavailable', 'None'])
                                 | map('float', 0) | list %}
          {% set prave_prsi = ((intenzity + [0]) | max) > 0 %}
          {{ median >= prah or prave_prsi }}
        availability: >
          {% set ids = [
            'sensor.srazky_wu_ibrno599', 'sensor.srazky_wu_ibrno744',
            'sensor.srazky_wu_ibrno741', 'sensor.srazky_wu_ibrno578'] %}
          {{ ids | map('states') | reject('in', ['unknown','unavailable','none','None',''])
                 | list | length > 0 }}

Senzor je zapnutý („přeskoč dnešní zálivku“), když prostřední hodnota (medián) dnešních úhrnů dosáhla nastaveného prahu, nebo když na kterékoli stanici právě prší.

Proč medián, a ne průměr nebo maximum? Když se jedné stanici ucpe srážkoměr a hlásí nulu, nebo naopak vadná stanice hlásí nesmyslných 40 mm, medián ji přehlasuje zbývajícími stanicemi. Průměr by vadná hodnota rozhodila. Blok availability navíc zajistí, že když nefunguje ani jedna stanice, senzor bude „nedostupný“ místo falešného „neprší“ - to využijeme u hlídače v kroku 7.

Krok 5: Uložte si déšť přes noc

Denní úhrn precipTotal se o půlnoci vynuluje. Když naprší večer 15 mm a vaše zálivka startuje v pět ráno, uvidí automatizace ráno nulu - a zahradu zbytečně zalije. Vyřešíme to malou „pamětí“: přepínačem, který se při dešti zapne a drží až do rána.

V Nastavení → Zařízení a služby → Pomocníci vytvořte pomocníka typu Spínač s názvem Dnes pršelo (vznikne input_boolean.dnes_prselo). A k němu dvě automatizace. První přepínač zapne, kdykoli se rozprší nebo úhrny přesáhnou práh:

- alias: Déšť - zapamatovat na celý den
  triggers:
    - trigger: state
      entity_id: binary_sensor.preskocit_zalivku_dest
      to: "on"
  actions:
    - action: input_boolean.turn_on
      target:
        entity_id: input_boolean.dnes_prselo

Druhá ho ráno vypne - ale jen pokud už je sucho:

- alias: Ráno - zrušit blokaci, pokud je sucho
  triggers:
    - trigger: time
      at: "07:00:00"
  conditions:
    - condition: state
      entity_id: binary_sensor.preskocit_zalivku_dest
      state: "off"
  actions:
    - action: input_boolean.turn_off
      target:
        entity_id: input_boolean.dnes_prselo

Na zvýrazněném času záleží: zvolte ho tak, aby ležel až za ranní zálivkou. V našem příkladu z kroku 6 se zálivka spouští dvě hodiny před východem slunce, skončí tedy nejpozději kolem páté ráno, a přepínač se ruší v 7:00 - noční déšť tak ranní zálivku spolehlivě přeskočí a od sedmi je systém připravený na nový den. Pokud zaléváte večer, posuňte rušení přepínače; princip zůstává stejný.

Krok 6: Napojte to na zálivku

Zbývá doplnit podmínku do automatizace, kterou spouštíte zálivku - ať už jede podle časového plánu, nebo podle vlhkosti půdy. Vaše automatizace zavlažování se po přidání této podmínky spustí pouze, pokud je input_boolean.dnes_prselo vypnutý.

conditions:
  - condition: state
    entity_id: input_boolean.dnes_prselo
    state: "off"

V automatizaci vytvářené v grafickém editoru přidáte totéž jako podmínku typu „Stav entity“. Zálivka pak proběhne jen ve dnech, kdy skutečně nepršelo - ne podle předpovědi, ale podle srážkoměrů pár set metrů od vaší zahrady.

Kompletní automatizaci zapínání a vypínání zavlažování si ukážeme na Zigbee vodním ventilu SONOFF Hydro Series Hydro ONE z naší nabídky. V Home Assistant je po spárování vidět jako přepínač - u nás switch.zahradni_ventil. Zavlažovat budeme každý den dvě hodiny před východem slunce, jen od dubna do září, po dobu patnácti minut - a díky podmínce z tohoto kroku jen tehdy, když nepršelo:

- alias: Ranní zálivka - dvě hodiny před východem slunce
  triggers:
    - trigger: sun
      event: sunrise
      offset: "-02:00:00"
  conditions:
    - condition: state
      entity_id: input_boolean.dnes_prselo
      state: "off"
    - condition: template
      value_template: "{{ 4 <= now().month <= 9 }}"
  actions:
    - action: switch.turn_on
      target:
        entity_id: switch.zahradni_ventil
    - delay: "00:15:00"
    - action: switch.turn_off
      target:
        entity_id: switch.zahradni_ventil

Trigger typu „sun“ si časy východu slunce počítá sám z polohy nastavené v Home Assistant, takže se start zálivky posouvá s ročním obdobím - v červnu poběží dřív, v září později. Šablonová podmínka omezuje běh na měsíce duben až září. A jedno doporučení navíc: nastavte i přímo ve ventilu maximální dobu otevření. Kdyby se automatizace kdekoli zasekla, ventil se zavře sám.

Krok 7: Hlídač výpadku

Protože jde o neoficiální cestu, může se stát, že klíč jednoho dne přestane platit. Bez hlídání byste to poznali až podle toho, že se zahrada zalévá i po dešti. Díky bloku availability z kroku 4 se to ale pozná okamžitě: když nefunguje žádná stanice, senzor se stane nedostupným. Stačí na to navázat upozornění - jen si dosaďte svou notifikační službu:

- alias: Srážkové stanice - upozornit na výpadek
  triggers:
    - trigger: state
      entity_id: binary_sensor.preskocit_zalivku_dest
      to: "unavailable"
      for:
        hours: 2
  actions:
    - action: notify.mobile_app_vas_telefon
      data:
        title: "Zálivka: data o srážkách nejsou dostupná"
        message: >
          Žádná ze sledovaných stanic Weather Underground neodpovídá už 2 hodiny.
          Nejspíš se změnil API klíč, nebo vypadl internet. Zálivka teď běží
          bez dešťové pojistky.

Dvouhodinový filtr odchytá krátké výpadky internetu i chvilkové nedostupnosti API. Výpadek jediné stanice poplach nespustí - medián počítá se zbývajícími. A kdyby jednou opravdu došlo na výměnu klíče: ve zdrojovém kódu stránek wunderground.com najdete nový (hledejte parametr apiKey), v souboru srazky_wu.yaml přepíšete jeden řetězec a jedete dál. Přesně tak to proběhlo i při minulé výměně.

Shrnutí

Výsledkem je dešťová pojistka zálivky postavená na skutečných srážkoměrech z okolí vašeho domu: čtyři stanice, medián odolný proti vadným datům, práh nastavitelný v aplikaci, paměť přes půlnoční nulování a hlídač, který ohlásí výpadek. Není to oficiálně podporovaná cesta - proto jsou v návodu rovnou zabudované pojistky a proto platí: kdo chce jistotu, pořídí si meteostanici se srážkoměrem a nahráváním do Weather Underground a získá vlastní oficiální klíč. Pro ostatní je tu způsob, který slouží už od roku 2018. Chytré zavlažovací ventily, ke kterým se tahle pojistka hodí, najdete v kategorii Chytré zavlažování.

FAQ - časté dotazy

Je v pořádku takový klíč používat?

Trestný čin to není - klíč je veřejně viditelný v kódu stránek wunderground.com, nic se neprolamuje ani neobchází a čtení veřejně dostupných dat soudy opakovaně potvrdily jako legální. Porušujete tím ale podmínky služby, což je smluvní věc mezi vámi a provozovatelem - ten může přístup kdykoli zablokovat. Proto doporučujeme oficiální cestu přes vlastní stanici a do návodu je rovnou zabudovaný hlídač výpadku. Rozhodnutí je na vás.

V okolí nemám žádnou stanici se srážkoměrem. Co teď?

Zkuste na mapě postupně větší okruh - i stanice 5 km daleko je pro rozhodnutí „zalévat/nezalévat“ lepší než předpověď. Pokud ve vašem okolí není vůbec nic, je to vhodná příležitost zvážit pořízení vlastní meteostanice se srážkoměrem.

Jak čerstvá data dostanu?

Stanice nahrávají měření zhruba po 5 minutách a Home Assistant se v našem nastavení ptá každých 20 minut. Pro rozhodování o zálivce to stačí; interval jde v scan_interval zkrátit, zbytečně to ale nepřehánějte.

Proč se kombinuje denní úhrn s aktuální intenzitou?

Denní úhrn říká, kolik už dnes napršelo, ale roste pomalu. Když se spustí liják deset minut před plánovanou zálivkou, úhrn ještě nemusí být přes práh - aktuální intenzita (precipRate) ale už déšť hlásí, takže se zálivka správně přeskočí.

Můžu stejná data použít i na jiné věci než zálivku?

Ano. Stanice posílají kromě srážek i teplotu, vlhkost nebo vítr - stačí do json_attributes přidat další položky (např. temp). Stejné senzory pak poslouží pro upozornění „prší a máte otevřené střešní okno“, automatické zatažení markýzy nebo jen pro graf srážek v přehledu.