RichPear HOME DOCS Začít

Integrace RichPear Home

Airly

Airly přidává do RichPear Home údaje o kvalitě venkovního vzduchu pro zadanou zeměpisnou polohu. Data se načítají z cloudového API Airly, takže je potřeba internetové připojení a platný API klíč.

Začít nastaveníZpět na integrace
Doména
airly
Komunikace
cloud-polling
Nastavení
UI průvodce
Požadavek
Airly API klíč
01

Připravte Airly API klíč a polohu

Nejdřív si vytvořte nebo připravte API klíč ve vývojářském účtu Airly. Registrační stránka pro vývojáře je dostupná na developer.airly.eu/register.

Integrace potřebuje zeměpisnou šířku a délku místa, pro které chcete kvalitu vzduchu sledovat. Pokud je v daném bodě dostupná měřicí stanice nebo vhodná nejbližší stanice, RichPear Home vytvoří senzory pro dostupné hodnoty.

Co mít předem

  1. Platný API klíč Airly.
  2. Zeměpisnou šířku a délku sledovaného místa.
  3. Přístup RichPear Home k internetu a k API Airly.
  4. Polohu, kde Airly vrací měření. Pokud v okolí nejsou Airly senzory, integrace se nenastaví nebo později zahlásí chybu bez dostupné stanice.
02

Vyhledejte integraci Airly

Otevřete Nastavení → Zařízení a služby → Přidat integraci a vyhledejte Airly. Integrace se přidává přes průvodce v UI, ne přes YAML konfiguraci.

Airly v dialogu Přidat integraci.
03

Zadejte API klíč a souřadnice

Po odeslání RichPear Home ověří API klíč a zadanou polohu. Pokud Airly pro daný bod nemá data, průvodce zkusí najít nejbližší dostupnou stanici v okruhu do 5 km.

Konkrétní český formulář Airly: API klíč, zeměpisná šířka a zeměpisná délka.
04

Zkontrolujte senzory kvality vzduchu

Airly v RichPear Home vytváří senzorové entity podle hodnot, které API pro zvolenou polohu vrátí. Ne každá lokalita musí poskytovat všechny znečišťující látky nebo meteorologické údaje.

Integrace nepřidává vlastní akce s doménou airly.*. V automatizacích se používají stavy senzorů, například částice PM2.5, PM10 nebo celkový index kvality vzduchu.

Typické senzory

  1. CAQI, tedy Common Air Quality Index, včetně úrovně, popisu a doporučení z Airly.
  2. Částice PM1, PM2.5 a PM10, včetně limitu a procenta limitu tam, kde je Airly vrací.
  3. Plyny CO, NO2, O3 a SO2, pokud jsou pro stanici dostupné.
  4. Teplota, vlhkost a tlak, pokud je stanice nebo výpočet Airly poskytuje.
05

Počítejte s limitem Airly API

Airly u tohoto napojení počítá s limitem 100 aktualizací dat denně. Při jedné instanci integrace to odpovídá přibližně 15minutovému intervalu, při dvou instancích 30 minutám a při třech 45 minutám.

RichPear Home interval upravuje podle počtu instancí Airly a zbývajících požadavků do půlnoci UTC. Pokud budete integraci ručně obnovovat často nebo přidáte více lokalit, můžete denní limit vyčerpat dřív.

Příklad automatizace

alias: Upozornění na zhoršený vzduch
triggers:
  - trigger: numeric_state
    entity_id: sensor.airly_caqi
    above: 75
actions:
  - action: notify.mobile_app
    data:
      message: "Airly hlásí zhoršenou kvalitu venkovního vzduchu."
06

Řešení problémů

Pokud průvodce selže hned při nastavení, ověřte hlavně API klíč a souřadnice. Chyba polohy znamená, že pro daný bod nebo jeho použitelné okolí nejsou dostupná Airly měření.

Při pozdější chybě aktualizace zkontrolujte dostupnost internetu, stav API Airly a denní kvótu požadavků. V systémových informacích integrace může RichPear Home zobrazovat povolené a zbývající požadavky API, pokud je Airly API vrátí.

Časté příčiny

  1. Neplatný API klíč: klíč je opsaný špatně, byl zrušený nebo nemá přístup k Airly API.
  2. Špatná poloha: v místě nejsou dostupná měření Airly nebo není nalezena vhodná nejbližší stanice.
  3. Vyčerpaný limit: příliš mnoho instancí nebo ručních obnov překročí denní počet požadavků.
  4. Nedostupný cloud: RichPear Home se nedostane na Airly API kvůli internetu, DNS nebo dočasné chybě služby.
URL

Lokální adresa systému

RichPear Home se v domácí síti běžně otevírá na http://rphome.local:8123. Pokud tato adresa v dané síti neodpoví, použijte http://IP-ADRESA:8123.