Hlavný panel rozhrania API kvality vzduchu AirVisual: 5 krokov

2024 Autor: John Day | [email protected]. Naposledy zmenené: 2024-01-30 11:57

AirVisual (https://www.airvisual.com) je webová stránka, ktorá poskytuje údaje o kvalite ovzdušia po celom svete. Majú API, ktoré použijeme na získanie údajov o kvalite ovzdušia na odoslanie na informačný panel. S týmto rozhraním API budeme interagovať podobne, ako sme to robili s informačným panelom počasia.

Jedná sa o jednoduchý projekt, ktorý vás naučí používať API. Začnime!

Krok 1: Začíname

Väčšinu kódu sme už dali dohromady, ale budete potrebovať, aby ste na ceste urobili niekoľko úprav. Existuje tiež veľa príležitostí na rozšírenie toho, čo sme urobili.

Aby ste získali všetky veci, ktoré sme pre vás pripravili, budete musieť klonovať úložisko z GitHub. GitHub je úžasná služba, ktorá nám umožňuje ukladať, revidovať a spravovať projekty ako je tento. Tento skript budete chcieť spustiť na vyhradenom zariadení. Môžete použiť prenosný počítač, Raspberry Pi alebo iný jednodoskový počítač. Na klonovanie úložiska potrebujeme prejsť do terminálu nášho počítača alebo Pi a zadať tento príkaz:

$ git klon

Stlačte Enter a uvidíte tieto informácie:

$ git clone https://github.com/InitialState/airvisual.git Klonovanie do 'airvisual' … diaľkové: Vyčíslenie objektov: 13, hotovo. diaľkové ovládanie: Počítanie predmetov: 100% (13/13), hotovo. diaľkové ovládanie: Komprimácia objektov: 100% (12/12), hotovo. diaľkové ovládanie: celkom 13 (delta 2), opätovne použité 0 (delta 0), opakovane použité v balíku 0 Rozbaľovanie predmetov: 100% (13/13), hotovo.

Akonáhle to uvidíte, potom gratulujeme, úspešne ste naklonovali GitHub Repo a máte všetky potrebné súbory na zostavenie tohto projektu. Prejdeme do nového adresára. Ak chcete zmeniť adresár, zadajte „cd“a zadajte názov adresára, do ktorého chcete prejsť. V tomto prípade napíšeme:

$ cd airvisual

Akonáhle stlačíme kláves Enter, uvidíte, že sme teraz vo vysielacom adresári. Zadajte „ls“a zistite, ktoré súbory sme nainštalovali. Mali by ste vyzerať takto:

LICENCIA README.md airquality.py

Pred úpravou kódu potrebujeme ďalšie položky, takže sa pozrime na ďalšie informácie o rozhraní API pre kvalitu ovzdušia.

Krok 2: AirVisual API

AirVisual má API pre kvalitu ovzdušia (AQI) a znečistenie, ktoré umožňuje bezplatne až 10 000 hovorov API za mesiac. Môžete sa zaregistrovať na úrovni komunity. Po registrácii môžete prejsť na stránku My Air a kartu API. Tu nájdete svoje kľúče API a dokumentáciu k API.

Kliknutím na tlačidlo +Nový kľúč vytvoríte náš prvý prístupový kľúč API. Ak chcete vybrať plán, v rozbaľovacej ponuke vyberte položku Komunita a kliknite na položku Vytvoriť. Ak všetko pôjde dobre, zobrazí sa správa o úspechu a môžete sa vrátiť na hlavný panel API a nájsť svoje nové kľúčové informácie. Kľúčová hodnota (čísla a znaky) je to, čo budete pre tento projekt potrebovať. Ak si prečítate dokumentáciu k API, uvidíte, že môžete uskutočniť niekoľko druhov hovorov API. Pre tento projekt chceme získať najbližšie údaje o meste na základe súradníc GPS. Na tento hovor budete potrebovať svoju zemepisnú dĺžku, šírku a kľúč API. Zadajte tieto parametre do nižšie uvedeného hovoru, zadajte ho do panela s adresou vo svojom prehliadači a stlačte kláves Enter.

api.airvisual.com/v2/nearest_city?lat={{LATITUDE}}&lon={{LONGITUDE}}&key={{YOUR_API_KEY}}

Tým sa vrátia údaje najbližšieho mesta na základe súradníc GPS. Bude to vyzerať asi takto:

Na lepšie zobrazenie údajov odporúčam použiť formátovač JSON. Ak to použijete, bude to namiesto toho vyzerať takto:

"status": "úspech", "data": {"city": "Nashville", "state": "Tennessee", "country": "USA", "location": {"type": "Point", "coordinates": [-86.7386, 36.1767]}, "aktuálne": {"počasie": {"ts": "2019-04-08T19: 00: 00.000Z", "_v": 0, "createdAt": "2019-04-08T19: 04: 18.662Z "," hu ": 88," ic ":" 04d "," pr ": 1012," tp ": 18," updatedAt ":" 2019-04-08T19: 46: 53.140Z "," wd ": 90, "ws": 3.1}, "znečistenie": {"ts": "2019-04-08T18: 00: 00.000Z", "aqius": 10, "mainus": "p2", "aqicn": 3, "maincn": "p2"}

Teraz môžeme ľahko vidieť, že máme informácie o polohe, počasí a znečistení. Dve hodnoty, na ktoré sa pri tomto projekte zameriavame, sú Index kvality ovzdušia USA (aquis) a hlavná znečisťujúca látka (mainus). Hodnota indexu kvality ovzdušia nám hovorí, aká je miestna hodnota kvality ovzdušia a ako sa týka vášho zdravia. Farebne označená tabuľka je uvedená nižšie. Hlavná znečisťujúca látka nám hovorí, aká je hlavná znečisťujúca látka vo vzduchu pre vašu oblasť (tuhé častice, oxid dusičitý, ozón, oxid uhoľnatý, oxid siričitý). Tieto znečisťujúce látky sú typicky vedľajšími produktmi komínov alebo emisií z vozidiel.

Teraz, keď vieme, ako používať rozhranie Air Visual API, ďalšia vec, ktorú budeme potrebovať, je platforma palubnej dosky na zobrazenie údajov.

Krok 3: Počiatočný stav

Chceme streamovať všetky naše údaje o počasí do cloudovej služby a nechať túto službu, aby z našich údajov vytvorila pekný informačný panel. Naše údaje potrebujú cieľ, takže ako cieľ použijeme Počiatočný stav.

Zaregistrujte sa na počiatočný stav účtu

Prejdite na https://iot.app.initialstate.com a vytvorte si nový účet.

Nainštalujte ISStreamer

Nainštalujte modul Počiatočný stav Python na svoj prenosný počítač alebo Raspberry Pi. Na príkazovom riadku spustite nasledujúci príkaz:

$ / curl -sSL https://iot.app.initialstate.com -o -| sudo bash

Vyrobte si nejaký Automagic

Po spustení príkazu zvlnenia sa na obrazovku zobrazí niečo podobné nasledujúcemu výstupu:

$ / curl -sSL https://iot.app.initialstate.com -o -| sudo bash

Heslo: Začiatok ISStreamer Python Jednoduchá inštalácia! Inštalácia môže trvať niekoľko minút, dajte si kávu:) Ale nezabudnite sa vrátiť, otázky budem mať neskôr! Nájdená jednoduchá inštalácia: setuptools 1.1.6 Nájdená pip: pip 1.5.6 z /Library/Python/2.7/site-packages/pip-1.5.6- py2.7.egg (python 2.7) pip major version: 1 pip minor version: 5 ISStreamer nájdený, aktualizuje sa … Požiadavka je už aktuálna: ISStreamer v /Library/Python/2.7/site-packages Čistenie … Chcete automaticky získať ukážkový skript? [y/N] Kam chcete uložiť príklad? [predvolené:./is_example.py] Vyberte aplikáciu, ktorú používate v počiatočnom stave: 1. app.initialstate.com 2. [NOVINKA!] iot.app.initialstate.com Zadajte voľbu 1 alebo 2: Zadajte iot.app Používateľské meno.initialstate.com: Zadajte heslo na adrese iot.app.initialstate.com:

Po zobrazení výzvy na automatické získanie ukážkového skriptu zadajte y. Tým sa vytvorí testovací skript, ktorý môžeme spustiť, aby sme zaistili, že budeme môcť streamovať údaje do počiatočného stavu. Nasledujúca výzva sa spýta, kam chcete uložiť ukážkový súbor. Môžete buď zadať vlastnú miestnu cestu, alebo stlačením klávesu Enter prijať predvolené umiestnenie. Nakoniec sa vás opýta, akú aplikáciu Počiatočného stavu používate. Ak ste si nedávno vytvorili účet, zvoľte možnosť 2 a zadajte užívateľské meno a heslo. Potom bude inštalácia dokončená.

Prístupové kľúče

Pozrime sa na ukážkový skript, ktorý bol vytvorený. $ nano is_example.py Na riadku 15 uvidíte riadok, ktorý začína na streamer = Streamer (bucket_ …. Tieto riadky vytvoria nový zväzok údajov s názvom „Príklad Python streamu“a budú priradené k vášmu účtu. K tomuto priradeniu dochádza z dôvodu access_key =”…” parameter na tom istom riadku. Táto dlhá séria písmen a číslic je vašim prístupovým kľúčom k počiatočnému stavu. Ak vo webovom prehliadači prejdete na svoj počiatočný stav, kliknite vpravo hore na svoje používateľské meno a potom choďte na „moje nastavenia“nájdete ten istý prístupový kľúč v spodnej časti stránky v časti „Kľúče na streamovanie“. Pri každom vytváraní toku údajov tento prístupový kľúč nasmeruje tento tok údajov na váš účet (takže podeľte sa o svoj kľúč s kýmkoľvek).

Spustite testovací skript a uistite sa, že môžeme vytvoriť dátový tok na váš účet Počiatočný stav. Na príkazovom riadku spustite nasledujúce:

$ python is_example.py

Príklad údajov

Vo webovom prehliadači sa vráťte k svojmu počiatočnému účtu. Nový priečinok s údajmi s názvom „Príklad Python streamu“sa mal zobraziť vľavo na poličke s vedrom (možno budete musieť stránku obnoviť). Údaje zobrazíte kliknutím na tento segment.

Teraz ste pripravení začať streamovať skutočné údaje z rozhrania AirVisual API.

Krok 4: Hlavný panel kvality ovzdušia

Teraz k zábavnej časti. Sme pripravení začať používať rozhranie AirVisual API na vytvorenie informačného panela kvality ovzdušia a zachytávanie údajov o znečistení ovzdušia, kdekoľvek sa rozhodneme. Tento skript airquality.py jednoducho zavolá rozhranie AirVisual API pomocou vášho kľúča API a získa aktuálne informácie o znečistení ovzdušia. Tiež streamuje tieto údaje na váš účet Počiatočný stav, čo vám umožní vytvoriť informačný panel kvality ovzdušia.

K skriptu máte prístup pomocou úložiska Github, ktoré sme klonovali skôr. Prvá vec, ktorú musíme urobiť, je uistiť sa, že sme v adresári AirVisual:

$ cd airvisual

Odtiaľto budete mať prístup k súboru python, ktorý spustíme a vytvoríme náš informačný panel o kvalite ovzdušia. Pred spustením súboru musíme urobiť nejaké zmeny. Ak chcete otvoriť súbor python, otvorte textový editor pomocou príkazu nano:

$ nano airquality.py

Keď je textový editor otvorený, v hornej časti skriptu sa vám zobrazia nasledujúce položky:

# --------- Používateľské nastavenia ---------

LATITUDE = "LAT" LONGITUDE = "LONG" AIRVISUAL_API_KEY = "AIR VISUAL API KEY" BUCKET_NAME = "Local Air Quality" BUCKET_KEY = "aq1" ACCESS_KEY = "INITIAL STATE ACCES KEY" MINUTES_BET -------------------------

musíte zadať svoju zemepisnú šírku, dĺžku, kľúč API AirVisual a prístupový kľúč počiatočného stavu. Parameter MINUTES_BETWEEN_READS nastaví, ako často bude váš skript zisťovať informácie o kvalite ovzdušia v rozhraní API AirVisual. 5 minút dosť času, aby ste neprekročili limit 10 000 hovorov API za mesiac. V záujme krátkodobého testovania ho môžete nastaviť na 0,5 minúty. Po zadaní parametrov uložte a ukončite zadávanie textu stlačením klávesov Control+X. Teraz ste pripravení spustiť skript:

$ python airquality.py

Ak chcete nechať tento skript dlhší čas bez prerušenia, môžete použiť príkaz nohup (bez zavesenia) nasledovne:

$ nohup python airquality.py &

Akonáhle to beží, prejdite na Počiatočný stav a prezrite si svoje údaje. Váš informačný panel by mal vyzerať podobne ako na obrázku nižšie. Máte svoju polohu GPS, hodnotu indexu kvality ovzdušia a hlavnú znečisťujúcu látku.

Moje odporúčanie by zmenilo vašu hodnotu AQI na dlaždicu rozchodu. Tiež presuňte dlaždice a podľa potreby zmeňte veľkosť. Ak to používate pre vstavaný informačný panel, môžete ich podľa potreby presunúť.

Ak sa rozhodnete urobiť z hodnoty AQI meradlo, môžete potom nastaviť prah farieb tak, aby bol podobný indexovému grafu kvality ovzdušia. To vám poskytne okamžitú aktualizáciu toho, kde hodnota AQI spadá do grafu, keď skontrolujete hlavný panel. Na svoj informačný panel môžete pridať obrázok na pozadí, aby mal lepší kontext.

Máte teda všetko, čo potrebujete na vytvorenie palubnej dosky kvality vzduchu. Ale čo keď chcete pridať ďalšie alebo pridať toto na informačný panel o počasí, ktorý ste už vytvorili? Ak je to tak, čítajte ďalej!

Krok 5: Vytvorte informačný panel o celkovom počasí

Nestačia vám údaje o kvalite ovzdušia? Existuje veľa možností, ako pridať ďalšie na hlavný panel alebo streamovať tieto údaje na informačný panel o počasí, ktorý už máte!

Streamujte počasie a kvalitu vzduchu na jeden informačný panel

Ak ste už implementovali náš projekt DarkSky API alebo Hyper-Local Weather Dashboard, môžete tieto údaje o kvalite ovzdušia pridať na svoj existujúci informačný panel. Je to veľmi jednoduché. Všetko, čo musíte urobiť, je zmeniť parametre v skripte kvality ovzdušia tak, aby mali rovnaký názov vedra, kľúč vedra a prístupový kľúč ako ten, ktorý ste použili na hlavnom paneli počasia. To umožní odosielanie údajov na ten istý informačný panel. Teraz budete mať informačný panel o počasí!

Požiadajte o spustenie súboru Python o počasí

Ďalšou možnosťou, ak nechcete spúšťať dva samostatné programy, je vložiť súbor python kvality ovzdušia do adresára projektu s počasím. Požiadajte súbor python o projekte počasia, aby zavolal do súboru kvality ovzdušia, aby sa spustil, keď je spustený váš súbor s počasím. Opäť nezabudnite zadať rovnaký názov vedra, kľúč vedra a prístupový kľúč, aby bežali na rovnakom paneli.

Vytvorte jeden súbor s kvalitou počasia aj vzduchu

A ak sa cítite naozaj odvážne, môžete vložiť časť kódu kvality ovzdušia do svojho skriptu python pre počasie a spustiť iba jeden skript. Bude to vyžadovať trochu viac kódovacieho úsilia ako ostatné dve možnosti, ale robí to zjednodušený program.

Streamujte ďalšie informácie z rozhrania AirVisual API

Ako ste videli, keď sme volali do rozhrania AirVisual API, obsahuje viac informácií než len kvalitu vzduchu. Poskytuje tiež teplotu, vlhkosť, rýchlosť vetra, smer vetra a atmosférický tlak. Tieto informácie môžeme odoslať do počiatočného stavu rovnakým spôsobom, akým sme poslali hodnotu indexu kvality ovzdušia a hlavnú znečisťujúcu látku. Vyžaduje iba, aby ste napísali niekoľko ďalších vyhlásení if.