RichPearHOME DOCSZačít

Integrace RichPear Home

AirNow

Integrace AirNow přidá do RichPear Home údaje o kvalitě ovzduší z webové služby AirNow pro zadanou zeměpisnou polohu. Data se načítají z cloudu, takže je potřeba přístup k internetu a vlastní AirNow API klíč.

Začít nastaveníZpět na audit
Doména
airnow
Kategorie
Zdraví
Komunikace
cloud-polling
Účet
AirNow API klíč
01

Připravte API klíč a polohu

Nejdřív si v AirNow Developer Tools vytvořte API klíč. RichPear Home bez něj nebude mít oprávnění volat AirNow webovou službu.

Připravte také zeměpisnou šířku, zeměpisnou délku a rádius vyhledávání měřicích stanic. Průvodce používá polohu instalace jako výchozí hodnotu a rádius je v mílích.

Co mít předem

  1. AirNow API klíč z adresy https://docs.airnowapi.org/account/request/.
  2. Zeměpisnou šířku a délku místa, pro které chcete sledovat kvalitu ovzduší.
  3. Rádius stanic v mílích; integrace používá minimálně 5 mil a výchozí hodnota je 150 mil.
  4. Odchozí internetové připojení z RichPear Home na službu AirNow.
02

Přidejte AirNow v RichPear Home

Otevřete Nastavení → Zařízení a služby → Přidat integraci, vyhledejte AirNow a spusťte průvodce. Formulář po vás bude chtít Klíč API, Zeměpisnou šířku, Zeměpisnou délku a volitelný Rádius stanice.

Po odeslání RichPear Home zkusí načíst aktuální pozorování pro zadanou polohu a rádius. Pokud AirNow nevrátí žádná data, položka integrace se nevytvoří a průvodce zobrazí chybu pro neplatnou nebo nepokrytou lokalitu.

Lokální uživatelská adresa instalace bývá http://rphome.local:8123. Pokud nefunguje mDNS, použijte http://IP-ADRESA:8123.
03

Zkontrolujte senzory kvality ovzduší

AirNow v RichPear Home vytváří senzorové entity. Hodnota hlavního AQI senzoru je vypočtená z nejvyššího AQI mezi dostupnými znečišťujícími látkami, které AirNow pro danou stanici vrátí.

U hlavního AQI senzoru sledujte také atributy s popisem kategorie, úrovní kategorie a časem měření. Stanice se zobrazuje jako samostatný senzor s polohou reportovací oblasti v atributech.

Entity v RichPear Home Core

  1. sensor pro celkový AQI.
  2. sensor pro PM10 v µg/m³, pokud jej AirNow pro danou lokalitu vrátí.
  3. sensor pro PM2.5 v µg/m³, pokud je dostupný.
  4. sensor pro O3 v ppm, pokud je dostupný.
  5. sensor pro Reporting station s atributy zeměpisné šířky a délky reportovací oblasti.
04

Počítejte s hodinovými daty a limitem API

AirNow aktualizuje pozorování typicky jednou za hodinu. Integrace proto data načítá dvakrát za hodinu, tedy každých 30 minut. Častější ruční obnovování obvykle nepřinese nové hodnoty.

AirNow API povoluje 500 aktualizací dat za hodinu. Výchozí interval integrace by tento limit neměl vyčerpat, ale pokud stejný API klíč používáte i jinde, započítejte všechny požadavky dohromady.

Úprava rádiusu

Rádius vyhledávání stanic je dostupný jako volba integrace. Pokud AirNow pro přesnou polohu nevrací data, zkuste rádius zvětšit a ověřit, jestli se v dosahu nachází reportovací stanice.

05

Řešení problémů

AirNow API může občas dočasně nevrátit žádný výsledek pro konkrétní polohu. Pokud se průvodce zastaví na chybě „No results found for that location“, nemusí jít hned o špatné nastavení.

Když chyba trvá, otestujte stejnou zeměpisnou šířku, délku a rádius přímo v nástroji AirNow Current Observations By Lat/Lon. Jako výstup zvolte application/json, sestavte dotaz a spusťte jej. Pokud odpověď není prázdné pole [], přiložte výsledek k hlášení chyby; polohu můžete před sdílením anonymizovat, ale neodstraňujte datová pole.

Typické příčiny

  1. Neplatný API klíč: klíč není vytvořený v AirNow Developer Tools, je opsaný špatně nebo byl zneplatněný.
  2. Žádná stanice v rádiusu: zvolená poloha a rádius nevrací žádné AirNow pozorování.
  3. Dočasně prázdná odpověď API: dokumentace RichPear Home upozorňuje, že AirNow API může být dočasně nespolehlivé.
  4. Limit požadavků: stejný API klíč používá více aplikací a součet požadavků se blíží limitu AirNow.
  5. Síťový problém: RichPear Home nemá funkční DNS nebo odchozí spojení k AirNow.