Levegőminőség modul – Új, továbbfejlesztett hírcsatorna
Air Quality Widget - New Improved Feed

Posted on July 28th 2015
Ossza meg: aqicn.org/faq/2015-07-28/air-quality-widget-new-improved-feed/hu/
{ widget : feed }

Az AQI widgetjeink külső webhelyeken belüli integrálásának javítása érdekében kifejlesztettünk egy új widget API feedet. A meglévő widget feedhez képest ez az új API feed sokkal nagyobb rugalmasságot biztosít az integrációhoz, de sokkal több lehetőséget kínál a widget megjelenésének testreszabására is.

Megjeleníthet például egy olyan apró widgetet, amilyen egyszerű ... (vigye az egeret az AQI szám fölé a részletek megtekintéséhez), vagy egy nagyobb widgetet az elmúlt 24 óra szennyezőanyagainak részleteivel a jobb oldalon látható módon.

Az új keretrendszer támogatja a sablonozást, több nyelvet (angol, egyszerűsített és hagyományos kínai, spanyol stb.), valamint lehetőséget a programozási integráció elvégzésére adatalapú javascript visszahívásokkal.

A. Alapbeállítás

Az alapvető integráció egyszerű és egyértelmű. Először hozzá kell adnia a következő kódrészletet:

  
<script  type="text/javascript"  charset="utf-8">  
	(function  (w,  d,  t,  f)  {  
		w[f]  =  w[f]  ||  function  (c,  k,  n)  {  
			s  =  w[f],  k  =  s['k']  =  (s['k']  ||  (k  ?  ('&k='  +  k)  :  ''));  s['c']  =  
				c  =  (c  instanceof  Array)  ?  c  :  [c];  s['n']  =  n  =  n  ||  0;  L  =  d.createElement(t),  e  =  d.getElementsByTagName(t)[0];  
			L.async  =  1;  L.src  =  '//feed.aqicn.org/feed/'  +  (c[n].city)  +  '/'  +  (c[n].lang  ||  '')  +  '/feed.v1.js?n='  +  n  +  k;  
			e.parentNode.insertBefore(L,  e);  
		};  
	})(window,  document,  'script',  '_aqiFeed');    
</script>

Ezután adja hozzá ezt a másik kódot a widget felvételéhez:

  
<span  id="city-aqi-container"></span>  
  
<script  type="text/javascript"  charset="utf-8">  
	_aqiFeed({  container:  "city-aqi-container",  city:  "beijing"  });  
</script>

Az `_aqiFeed` függvény a widget konfigurációs blokkját veszi argumentumként. A `container: "city-aqi-container"` paraméter annak a címkének az azonosítójára utal, amelybe be szeretné szúrni a modult (pl. `<span id='city-aqi-container'></span>`), a city paraméter pedig annak a városnak a neve, amelyre vonatkozóan meg szeretné jeleníteni az aktuális levegőminőségi értéket (pl. `város: "london"`).

B. A nyelv megadása

...

A használandó nyelvet a lang beállításával is megadhatja. Ha például a widgetet kínai nyelven szeretné beilleszteni (amint a jobb oldalon látható), használja a következő kódot:

  
_aqiFeed({  
	container:"city-aqi-container",  
	city:"beijing",  
	lang:"cn"  
});  

A jelenleg támogatott nyelvek a következők:

  • "en": English
  • "cn": Chinese
  • "jp": Japanese
  • "es": Spanish
  • "kr": Korean
  • "ru": Russian
  • "hk": Traditional Chinese
  • "fr": French
  • "pl": Polish
  • "de": German
  • "pt": Portuguese
  • "vn": Vietnamese
  • "it": Italian
  • "id": Indonesian
  • "nl": Dutch
  • "fa": Persian
  • "th": Thai
  • "hu": Hungarian
  • "el": Greek
  • "ro": Romanian
  • "bg": Bulgarian
  • "ur": Urdu
  • "hi": Hindi
  • "ar": Arabic
  • "sr": Serbian
  • "bn": Bangla
  • "hu": Hungarian
  • "bs": Bosnian
  • "hr": Croatian
  • "tr": Turkish
  • "uk": Ukrainian
  • "cs": Czech
  • "be": Belarusian

    Ha nincs megadva, vagy null van állítva, akkor az angol nyelvet használjuk.

  • C. A megjelenítési formátum megadása

    ...

    Lehetőség van a widgeten belüli szöveg testreszabására a display opció megadásával. Például a szöveges "AQI" név és a frissítési idő (a bal oldali widgeten látható) megjelenítéséhez a következő kódot használhatja:

    >
      
    _aqiFeed({    
    	display:"%cityname  AQI  is  %aqi<br><small>on  %date</small>",  
    	container:"city-aqi-container-display",    
    	city:"beijing"  
    });  
    

    A display egy HTML-alapú karakterlánc, és a következő kulcsszavak bármelyikét tartalmazhatja:

    • "%cityname" a város nevéhez (pl. Beijing ),
    • "%aqi" a díszített AQI értékhez (pl. 58 ),
    • "%aqiv" a díszítetlen (nyers szöveg) AQI értékhez (pl. 58 ),
    • `%style` a díszített AQI részletek css deklarációjához (pl. background-color: #ffde33;color:#000000; ),
    • "%dátum" az AQI frissítésének időpontjára (pl. Wed 20:00 ),
    • "%impact" a kapcsolódó egészségügyi hatásra (pl. Good , Moderate ...)
    • "%attribúció" az AQI adatok hozzárendeléséhez (pl. Beijing Environmental Protection Monitoring Center )
    • "%részletek" a teljes AQI részlethez (a felugró ablak tartalma, amely akkor jelenik meg, amikor az egeret az AQI érték fölé viszi).

    Íme néhány példa:

    Display Configuration Result

    D. Programozott visszahívás

    Ha inkább a barkács integrációt részesíti előnyben, megadhat egy JavaScript-függvény-visszahívást is az adatok betöltésekor. Csak hozzá kell adnia a callback opciót a paraméterblokkhoz, például:

      
    _aqiFeed({  city:"beijing",  callback:function(aqi){  
    	/*  Do  whatever  you  want  with  the  AQI  object  */  
    	console.log(aqi);    
    }  });

    Például, ha feltételezzük, hogy jquery-t is használ, a következő kód:

      
    <div  id='my-container'></div>  
    <script  type="text/javascript"  charset="utf-8">  
    	_aqiFeed({  
    		city:  "beijing",  lang:  "pl",  callback:  function  (aqi)  {  
    			$("#my-container").html(aqi.details);  
    		}  
    	});  
    </script>

    a következő tartalmat fogja előállítani:

    Az aqi objektumok a C részben (megjelenítési formátum) említett kulcsszavakat tartalmazzák.

    E. Több widgetet is tartalmaz

    Egy oldalon több widget is elhelyezhető. Csak át kell adnia az `_aqiFeed` függvénynek egy tömböt az összes szükséges widgettel. Például London, Párizs és New York beszúrásához használja ezt a kódot:

      
    var  cities  =  ["london",  "newyork",  "seoul",  "guangzhou",  "tokyo",  "shanghai",  "paris","hongkong"];  
      
    var  aqiWidgetConfig  =  [];    
    cities.forEach(function(city)  {  aqiWidgetConfig.push({city:city,  callback:  displayCity});  });  
    _aqiFeed(aqiWidgetConfig);  
      
    function  displayCity(aqi)  {  
    	$("#mutiple-city-aqi").append(aqi.text("<center>%cityname<br>%aqi<br><small>%date</small></center>"));  
    }  
    
    The result is:

    F. Takarmányhasználat

    Ezt a widget-hírcsatornát ingyenesen biztosítjuk, és kizárólag azzal a céllal áll rendelkezésre, hogy a hírcsatornát integrálja más webhelyekkel (azaz az alkalmazásokat kizárjuk), ésszerű és elfogadható felhasználási feltételek mellett. Fenntartjuk a jogot, hogy bármikor és előzetes értesítés nélkül megváltoztassuk a feed szerkezetét (adatformátumát), ezért jobb, ha felveszi velünk a kapcsolatot, ha egyéni integrációt tervez.

    Az integráció során néhány deontológiai szabályt kell alkalmazni az adatfolyam használatakor:

    • Először mindig győződjön meg arról, hogy az eredeti EPA-hoz való hozzárendelés szerepel. A World Air Quality Index projektben megtalálható összes levegőminőségi adat a világ összes EPA kemény munkájának köszönhető, ezért kérjük, feltétlenül adja meg munkájuk forrását is. Ha az automatizált API-t használja, a hozzárendelés a attribution mezőből érhető el.
    • Ha Ön intézményből származik, és használja az adatokat, kérjük, mutasson tiszteletet és fizesse vissza a munkánkért járó kreditet. Ha megpróbálja lekaparni az adatfolyamot, kérjük, ne feledje, hogy ez a projekt szponzori és együttműködési projekteken alapul, ezért fontolja meg, hogy támogasson minket , semmint selejtezést, különösen, ha Ön egy nagy intézmény vagy egyetem.
    • Ami azt illeti, ne járjunk úgy, mint a WRI ( World Resource Institute ): letöröljük a World Air Quality Index projekt teljes adatfolyamát, és olyan olcsóak, hogy még csak a mi munkánknak sem tulajdonítanák el, és ez annak ellenére, hogy 80 millió dolláros éves támogatás. Nem hisz nekünk? Ellenőrizze ezt a pillanatképet .

    G. Jövőbeli fejlesztések

    Ez az új widget feed API első verziója. Jó néhány fejlesztés van már folyamatban, mint például az állítható grafikus szélesség és magasság, választható AQI skála stb. Ha bármilyen konkrét fejlesztést szeretne javasolni, írjon nekünk.

    Kattintson ide az összes GYIK bejegyzés megtekintéséhez
  • AQI Scale: What do the colors and numbers mean?
  • Using Statistical Distances for Real-time Sensor Networks Validation
  • Nitrogen Dioxyde (NO2) in our atmosphere
  • A levegőminőség és szennyezettség méréséről:

    A levegőminőségi szintekről

    -Levegőminőségi index (AQI) értékekAz egészségügyi aggályok szintjei
    0 - 50A levegő minősége kielégítőnek tekinthető, és a levegőszennyezés kevés vagy semmilyen kockázatot jelent
    51 -100MérsékeltA levegő minősége elfogadható; egyes szennyező anyagok esetében azonban mérsékelten aggodalomra adhat okot olyan kevés ember számára, akik szokatlanul érzékenyek a levegőszennyezésre.
    101-150Egészségtelen az érzékeny csoportok számáraAz érzékeny csoporttagok egészségügyi hatásokat tapasztalhatnak. A nagyközönséget valószínűleg nem érinti.
    151-200EgészségtelenA teljes lakosság érzékeli az egészségre gyakorolt hatásokat; az érzékeny csoportok tagjai komolyabb tüneteket tapasztalhatnak
    201-300Nagyon egészségtelenEgészségügyi figyelmeztetések vészhelyzet esetén. Az egész lakosság nagyobb valószínűséggel érinti.
    300+VeszélyesEgészségügyi figyelmeztetés: mindenki súlyos egészségügyi hatásokat tapasztalhat

    Ha többet szeretne megtudni a levegőminőségről és a szennyezésről, tekintse meg a Wikipédia Levegőminőség témakörét vagy az airnow Levegőminőség és egészsége című útmutatóját .

    A pekingi orvos, Richard Saint Cyr MD nagyon hasznos egészségügyi tanácsaiért tekintse meg a www.myhealthbeijing.com blogot.


    Használati közlemény: Az összes levegőminőségre vonatkozó adat érvénytelenítése a közzététel időpontjában, és a minőségbiztosítás miatt ezek az adatok bármikor előzetes értesítés nélkül módosíthatók. A Világ levegőminőségi mutatója projekt minden ésszerű ismeretet és gondosságot gyakorolt ezen információk tartalmának összeállításában, és semmilyen körülmények között nem fogja a Világ levegőminőségi mutatója a projektcsapat vagy ügynökei felelősséggel tartoznak az adatok átadásából közvetlenül vagy közvetve okozott veszteségekért, sérülésekért vagy károkért szerződésben, kártérítésben vagy egyéb módon.



    Settings


    Language Settings:


    Temperature unit:
    Celcius