Integrace RichPear Home
AirNow
Integrace AirNow přidá do RichPear Home údaje o kvalitě ovzduší 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íč.
- Doména
airnow- Kategorie
- Zdraví
- Komunikace
- cloud-polling
- Účet
- AirNow API klíč
Připravte API klíč a polohu
Nejdřív si v AirNow Developer Tools vytvořte vlastní API klíč. RichPear Home bez něj nebude mít oprávnění načítat data z AirNow API.
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 se zadává v mílích.
Co mít předem
- AirNow API účet a API klíč z AirNow Developer Tools.
- Zeměpisnou šířku a délku místa, pro které chcete sledovat kvalitu ovzduší.
- Rádius stanic v mílích; integrace používá minimálně
5mil a výchozí hodnota je150mil. - Odchozí internetové připojení z RichPear Home na službu AirNow.
- Lokalitu v oblasti, kde AirNow poskytuje pozorování. AirNow pokrývá zejména Spojené státy, Kanadu a Mexiko.
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.
http://rphome.local:8123. Pokud nefunguje mDNS, použijte http://IP-ADRESA:8123.Zkontrolujte senzory kvality ovzduší
AirNow v RichPear Home vytváří senzorové entity. Hodnota hlavního AQI senzoru vychází z nejvyšší hodnoty AQI mezi dostupnými znečišťujícími látkami, které AirNow pro danou reportovací oblast vrátí.
U hlavního AQI senzoru sledujte také atributy s popisem kategorie, úrovní kategorie a časem měření. Reportovací oblast se zobrazuje jako samostatný senzor s polohou v atributech.
Vytvářené senzory
sensorpro celkový AQI.sensorpro PM10 vµg/m³, pokud jej AirNow pro danou lokalitu vrátí.sensorpro PM2.5 vµg/m³, pokud je dostupný.sensorpro O3 vppm, pokud je dostupný.sensorpro Reporting station s atributy zeměpisné šířky a délky reportovací oblasti.
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í oblast s aktuálním měřením.
Ř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 [], ponechte si výsledek pro další diagnostiku; polohu můžete před sdílením anonymizovat, ale neodstraňujte datová pole.
Typické příčiny
- Neplatný API klíč: klíč není vytvořený v AirNow Developer Tools, je opsaný špatně nebo byl zneplatněný.
- Žádná stanice v rádiusu: zvolená poloha a rádius nevrací žádné AirNow pozorování.
- Dočasně prázdná odpověď API: AirNow API může občas vrátit prázdnou odpověď i pro jinak podporovanou lokalitu.
- Limit požadavků: stejný API klíč používá více aplikací a součet požadavků se blíží limitu AirNow.
- Síťový problém: RichPear Home nemá funkční DNS nebo odchozí spojení k AirNow.