Integrace RichPear Home
National Weather Service (NWS)
National Weather Service (NWS) získává meteorologická data z webového API americké meteorologické služby pro zadanou polohu.
- Doména
nws- Kategorie
- Počasí
- Komunikace
- cloud-polling
- Kvalita
- Není uvedeno
Příprava
Nejdřív připravte vše, co integrace National Weather Service (NWS) potřebuje mimo RichPear Home: polohu v podporované oblasti USA a stabilní internetové připojení pro dotazy na NWS API. Bez této přípravy se průvodce může dokončit jen částečně nebo se entity budou tvářit jako nedostupné.
Uživatelé obvykle otevírají systém na http://rphome.local:8123. Pokud tato adresa nefunguje, použijte http://IP-ADRESA:8123. Nastavení provádějte z účtu správce, aby bylo možné vytvářet zařízení, oblasti a případné pomocné entity.
Nastavení
V RichPear Home otevřete Nastavení -> Zařízení a služby, zvolte Přidat integraci a vyhledejte National Weather Service (NWS). Pokud je zařízení nebo služba nalezená automaticky, dokončete nabídnuté nastavení z objevené karty.
Průvodce obvykle vyžaduje přihlašovací údaje, API klíč, adresu zařízení nebo výběr konkrétního účtu podle typu integrace. Při nastavení zadejte polohu. Pro korektní dotazy API je důležitý popis instance a kontakt v uživatelském agentu podle požadavků služby. Po dokončení pojmenujte zařízení podle místnosti a zkontrolujte, že vytvořené entity odpovídají skutečnému zařízení nebo službě.
Poloha
NWS poskytuje data pro podporované oblasti Spojených států. Pokud je poloha mimo rozsah služby, integrace nemusí vrátit předpověď.
Při více lokalitách vytvořte samostatné instance a pojmenujte je podle města nebo objektu, aby bylo jasné, která předpověď se zobrazuje.
Předpověď
Integrace vytváří počasí a může poskytovat rozšířené předpovědní údaje. Používejte je pro dashboardy, upozornění a nenáročné automatizace.
Pro venkovní automatizace přidejte další senzory, například reálný déšť, vítr nebo teplotu na pozemku. Předpověď sama o sobě nemusí stačit.
Akce pro rozšířená data
Akce nws.get_forecasts_extra umožní získat doplňkové předpovědní informace. Hodí se pro vlastní dashboard nebo oznámení.
Výstup akce zpracovávejte s kontrolou prázdných hodnot, protože API může pro některé polohy nebo časy vrátit méně detailů.
API požadavky
Veřejné API očekává slušné dotazování a identifikaci klienta. Nenastavujte zbytečně krátké intervaly aktualizace.
Když se objeví chyby odpovědi, rozlišujte výpadek internetu, omezení služby a chybnou polohu.
Použití
NWS se hodí pro americké instalace, které potřebují lokální předpověď a upozornění na počasí. Pro jiné země použijte odpovídající meteorologickou integraci.
Na hlavní dashboard zobrazte jen aktuální stav a nejbližší předpověď. Detailní údaje nechte v samostatném panelu pro počasí.
Kontrola po nasazení
Po prvním dni provozu projděte historii entit integrace National Weather Service (NWS). Sledujte, jestli se hodnoty aktualizují podle očekávané komunikace, zda příkazy nemají zpoždění a jestli se v logu neopakují chyby přihlášení, odmítnuté požadavky nebo výpadky dostupnosti.
U zařízení s přímým dopadem na provoz domácnosti nechte správcům jasný postup pro ruční ovládání, vypnutí automatizace a bezpečný návrat do původního stavu. Zapište také místo, kde se spravuje token, heslo, API klíč, adresa zařízení, topic struktura nebo konfigurační soubor.