RichPear HOME DOCS Začít

Integrace RichPear Home

AirVisual Cloud

AirVisual Cloud načítá z cloudového API IQAir AirVisual údaje o kvalitě venkovního vzduchu pro zvolenou lokalitu. Lokalitu můžete nastavit souřadnicemi nebo kombinací město, stát/region a země.

Začít nastaveníZpět na integrace
Doména
airvisual
Nastavení
Průvodce v UI
Komunikace
cloud-polling
Platformy
sensor
Požadavek
AirVisual API klíč
01

Připravte AirVisual API klíč

Nejdřív si na AirVisual/IQAir dashboardu vytvořte API klíč. Integrace byla navržena pro tarif Community; klíče z tarifů Startup a Enterprise mohou fungovat, ale výsledek se může lišit podle toho, co AirVisual API konkrétnímu klíči dovolí.

Community klíč je časově omezený na 12 měsíců. Po vypršení je potřeba ve správě AirVisual starý klíč odstranit, vytvořit nový a v RichPear Home znovu ověřit nebo aktualizovat konfiguraci integrace.

Kontrola před přidáním

  1. Máte platný AirVisual API klíč z dashboard.iqair.com.
  2. RichPear Home má přístup k internetu, protože data se načítají z cloudu.
  3. Víte, jestli chcete sledovat souřadnice, nebo přesný název lokality z AirVisual region directory.
  4. RichPear Home otevřete na http://rphome.local:8123 nebo http://IP-ADRESA:8123.
02

Vyhledejte AirVisual v integracích

Otevřete Nastavení → Zařízení a služby → Přidat integraci a vyhledejte AirVisual. V seznamu se nejdřív vybírá značka AirVisual.

Vyhledání značky AirVisual v dialogu Přidat integraci.
03

Vyberte AirVisual Cloud

Po výběru značky zvolte AirVisual Cloud. Volba AirVisual Pro je jiná integrace pro fyzické jednotky AirVisual Pro/Node, zatímco tento návod řeší cloudová data kvality vzduchu pro geografickou lokalitu.

Pokračujte jen volbou AirVisual Cloud, jinak se otevře průvodce pro jiný typ zařízení.

AirVisual Cloud a AirVisual Pro jsou v RichPear Home oddělené položky.
04

Zvolte způsob určení lokality

Průvodce nabízí dva způsoby nastavení. Pro běžnou domácnost je nejjednodušší použít zeměpisnou šířku a délku; RichPear Home do formuláře předvyplní souřadnice instalace. Druhá možnost je město, stát/region a země.

U názvu lokality použijte hodnoty přesně podle AirVisual region directory. V detailu města si z drobečkové navigace opište pořadí country > state/region > city a ve formuláři ho zadejte jako země, stát a město.

Příklad hodnot podle region directory

  1. Breadcrumb Brazil > Sao Paulo > Sao Paulo odpovídá hodnotám Country: Brazil, State: Sao Paulo, City: Sao Paulo.
  2. Pokud AirVisual lokalitu nenajde, zkontrolujte diakritiku, anglický název a pořadí hodnot proti region directory.
05

Vyplňte souřadnice nebo název lokality

U nastavení podle souřadnic zadejte Klíč API, Zeměpisnou šířku a Zeměpisnou délku. Tento způsob je vhodný, když chcete sledovat nejbližší dostupnou AirVisual lokalitu k vaší instalaci.

U nastavení podle názvu zadáváte Klíč API, Město, Stát a Země. Po odeslání RichPear Home ověří klíč i lokalitu proti AirVisual API.

Formulář pro sledování lokality podle zeměpisné šířky a délky.
06

Alternativně použijte město, stát a zemi

Tuto variantu zvolte, když chcete v AirVisual API sledovat konkrétní město ze seznamu dostupných regionů. Hodnoty opisujte přesně podle AirVisual, ne podle českého překladu názvu.

Pokud se zobrazí chyba, že lokalita nebyla nalezena, opravte město, stát nebo zemi podle AirVisual region directory a formulář odešlete znovu.

Formulář pro sledování lokality podle města, státu a země.
07

Zkontrolujte vytvořené senzory

Po úspěšném přidání vytvoří AirVisual Cloud senzory kvality vzduchu. Integrace používá dva standardy měření kvality vzduchu, U.S. a Chinese, a pro každý z nich vytvoří tři typy senzorů.

Praktické názvy entit se mohou upravit podle názvů ve vaší instalaci, ale typy hodnot zůstávají stejné: číselný AQI, slovní úroveň znečištění a hlavní znečišťující látka.

Typy senzorů

  1. Air quality index: číselná hodnota AQI, například sensor.us_air_quality_index nebo sensor.chinese_air_quality_index.
  2. Air pollution level: stav odvozený z AQI, například good, moderate, unhealthy, very unhealthy nebo hazardous.
  3. Main pollutant: látka s nejvyšším aktuálním dopadem; AirVisual používá například PM2.5, PM10, ozon, SO2, CO a podle dat API také NO2.
08

Čtěte AQI ve správných rozsazích

AQI je index celkové kvality vzduchu. Nižší hodnota znamená lepší stav, vyšší hodnota znamená horší kvalitu vzduchu a vyšší zdravotní zátěž.

Pro dashboardy a automatizace počítejte s tím, že AirVisual vrací venkovní kvalitu vzduchu pro sledovanou geografii, ne měření z lokálního čidla uvnitř domu.

Rozsahy AQI

  1. 0-50: dobrá kvalita vzduchu.
  2. 51-100: přijatelná kvalita, citliví lidé mohou u některých látek reagovat.
  3. 101-150: nezdravé pro citlivé skupiny.
  4. 151-200: nezdravé, dopady může pociťovat širší populace.
  5. 201-300: velmi nezdravé, zdravotní varování.
  6. 301+: nebezpečné, zdravotní riziko pro všechny.
09

Nastavte zobrazení lokality na mapě

V možnostech integrace je dostupná volba Zobrazit sledovanou geografii na mapě. Když je zapnutá, senzory dostanou atributy zeměpisné šířky a délky tak, aby se poloha mohla zobrazit na mapě.

Když nechcete polohu sledované lokality ukazovat v mapových kartách, volbu vypněte. Data kvality vzduchu se tím nepřestanou načítat.

Limit API volání

Community API klíč má limit 10 000 volání za měsíc. RichPear Home rozkládá interval dotazování podle počtu AirVisual Cloud položek se stejným API klíčem, aby limit zbytečně nepřekročil. Jedna položka se běžně dotazuje přibližně po 5 minutách, dvě položky přibližně po 10 minutách.

Řešení problémů

Když AirVisual Cloud nejde přidat nebo se neaktualizuje

API klíč je odmítnutý

Ověřte, že jste zkopírovali celý AirVisual API klíč bez mezer. Pokud Community klíč vypršel, vytvořte na AirVisual dashboardu nový klíč a proveďte znovuověření integrace v RichPear Home.

Lokalita nebyla nalezena

U varianty město, stát a země porovnejte všechny tři hodnoty s AirVisual region directory. Hodnoty zadávejte ve tvaru, který AirVisual uvádí v breadcrumbu.

Hodnoty se obnovují pomaleji, než čekáte

Interval dotazování se automaticky prodlužuje podle počtu sledovaných lokalit se stejným API klíčem. To je očekávané chování kvůli měsíčnímu limitu API volání.

Senzory nejsou dostupné

Zkontrolujte internetové připojení RichPear Home, stav služby AirVisual a platnost API klíče. Integrace je cloudová a bez odpovědi AirVisual API nemá z čeho vytvořit aktuální hodnoty.

Máte zařízení AirVisual Pro nebo Node

Pro fyzickou jednotku použijte samostatnou integraci AirVisual Pro. AirVisual Cloud v tomto návodu sleduje geografická data přes cloudové API.