Притурка за качество на въздуха - Нова подобрена емисия
Air Quality Widget - New Improved Feed

Posted on July 28th 2015
Дял: aqicn.org/faq/2015-07-28/air-quality-widget-new-improved-feed/bg/
{ widget : feed }

За да подобрим интегрирането на нашите AQI джаджи във външни уебсайтове, ние разработихме нова емисия на API за джаджи. В сравнение със съществуващата емисия на джаджи, тази нова емисия на API предоставя много повече гъвкавост за интеграция, но също така и много повече опции за персонализиране на външния вид на джаджи.

Beijing Air Quality.
29
Good
Updated on Wed. 1:00
PM2.5 AQI
Beijing PM25 (fine particulate matter)  measured by Beijing Environmental Protection Monitoring Center (北京市环境保护监测中心).
Values are converted to the US EPA AQI standard.
21
PM10 AQI
Beijing PM10 (respirable particulate matter)  measured by Beijing Environmental Protection Monitoring Center (北京市环境保护监测中心).
Values are converted to the US EPA AQI standard.
11
O3 AQI
Beijing O3 (ozone)  measured by Beijing Environmental Protection Monitoring Center (北京市环境保护监测中心).
Values are converted to the US EPA AQI standard.
29

Можете, например, да покажете малка джаджа, просто като Beijing

29
(преместете мишката върху номера на AQI, за да видите подробностите) или по-голяма джаджа с подробности за последните 24 часа замърсители, както е показано вдясно.

Новата рамка също поддържа шаблони, множество езици (английски, опростен и традиционен китайски, испански, ...), както и възможност за извършване на програмна интеграция с базирани на данни javascript обратни извиквания.

A. Основна настройка

Основната интеграция е проста и ясна. Първо трябва да добавите следната част от кода:

  
<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>

След това просто добавете този друг код, за да включите джаджата:

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

Функцията `_aqiFeed` приема като аргумент конфигурационния блок за уиджета. Параметърът `container: "city-aqi-container"` се отнася до идентификатора на тага, в който искате да вмъкнете джаджата (напр. `<span id='city-aqi-container'></span>`), и параметърът city името на града, за който искате да покажете текущото отчитане на качеството на въздуха (напр. `град: "лондон"`).

B. Посочване на езика

北京
29

Можете също да посочите езика, който да се използва, като зададете опцията lang . Например, за да включите джаджата на китайски (както е показано вдясно), използвайте следния код:

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

В момента поддържаните езици са:

  • "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
  • "km": Khmer
  • "lo": Lao

    Ако не е посочено или зададено на null , се използва английски.

  • C. Определяне на формата на дисплея

    Beijing AQI is
    29

    on Wednesday 1:00

    Възможно е да персонализирате текста, който да се показва в изпълнимия модул, като посочите опцията display . Например, за да се покаже както с текстовото име „AQI“, така и с времето за актуализиране (както е показано на изпълнимия модул вляво), можете да използвате следния код:

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

    display на параметъра е базиран на HTML низ и може да съдържа всяка от следните ключови думи:

    • `%cityname` за името на града (напр. Beijing ),
    • `%aqi` за украсената стойност на AQI (напр. 58 ),
    • `%aqiv` за неукрасената (суров текст) стойност на AQI (напр. 58 ),
    • `%style` за css декларацията на декорираните AQI подробности (напр. background-color: #ffde33;color:#000000; ),
    • `%date` за часа, в който AQI е актуализиран (напр. Wed 20:00 ),
    • `%impact` за свързаното въздействие върху здравето (напр. Good , Moderate ...)
    • `%attribution` за приписване на данни за AQI (напр. Beijing Environmental Protection Monitoring Center )
    • `%details` за пълните подробности за AQI (съдържанието на изскачащия прозорец, показван при преместване на мишката върху стойността на AQI).

    Ето няколко примера:

    Display Configuration Result
    %cityname Air Quality is <b>%impact</b>.
    Beijing Air Quality is Good.
    %aqi <small>(%impact)</small>
    29
    (Good)
    <span style='%style;font-size:12px;padding:5px 10px;'>%cityname AQI: %impact</span>
    Beijing AQI: Good
    %cityname Air Quality is <span style='%style;padding:0 5px'>%impact</span> (%aqiv on %date)
    Beijing Air Quality is Good (
    29
    on Wednesday 1:00)
    %cityname Air Quality is provided by %attribution
    Beijing Air Quality is provided by Beijing Environmental Protection Monitoring Center (北京市环境保护监测中心)
    <div style='%style;max-width:180px;text-align:center;'><small>%cityname AQI:</small> <div style='font-size:88px;height:60px;padding-top:30px;'>%aqiv</div> %impact</div>
    Beijing AQI:
    29
    Good
    %details
    Beijing Air Quality.
    29
    Good
    Updated on Wed. 1:00
    PM2.5 AQI
    Beijing PM25 (fine particulate matter)  measured by Beijing Environmental Protection Monitoring Center (北京市环境保护监测中心).
Values are converted to the US EPA AQI standard.
    21
    PM10 AQI
    Beijing PM10 (respirable particulate matter)  measured by Beijing Environmental Protection Monitoring Center (北京市环境保护监测中心).
Values are converted to the US EPA AQI standard.
    11
    O3 AQI
    Beijing O3 (ozone)  measured by Beijing Environmental Protection Monitoring Center (北京市环境保护监测中心).
Values are converted to the US EPA AQI standard.
    29

    D. Програмно обратно извикване

    Ако предпочитате интеграция „Направи си сам“, можете също да посочите обратно извикване на функция на javascript, което да бъде, когато данните се зареждат. Просто трябва да добавите опцията callback в блока с параметри, като например:

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

    Например, ако приемем, че използвате и jquery, следният код:

      
    <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>

    ще създаде следното съдържание:

    Pekin Jakość powietrza.
    29
    Good
    Poprawiony: Środa 1:00
    PM2.5 AQI
    Pekin PM25 (fine particulate matter)  measured by Beijing Environmental Protection Monitoring Center (北京市环境保护监测中心).
Values are converted to the US EPA AQI standard.
    21
    PM10 AQI
    Pekin PM10 (respirable particulate matter)  measured by Beijing Environmental Protection Monitoring Center (北京市环境保护监测中心).
Values are converted to the US EPA AQI standard.
    11
    O3 AQI
    Pekin O3 (ozone)  measured by Beijing Environmental Protection Monitoring Center (北京市环境保护监测中心).
Values are converted to the US EPA AQI standard.
    29

    Обектите aqi съдържат всички ключови думи, споменати в раздел C (формат за показване).

    E. Включително множество джаджи

    Възможно е включване на множество джаджи в една страница. Всичко, от което се нуждаете, е да предадете на функцията `_aqiFeed` масив с всички джаджи, които трябва да включите. Например, за да вмъкнете Лондон, Париж и Ню Йорк, можете да използвате този код:

      
    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:
    London
    76
    Tuesday 16:00
    New-york
    -
    Thursday 9:00
    Seoul
    38
    Wednesday 2:00
    Guangzhou
    99
    Wednesday 1:00
    Setagaya
    30
    Wednesday 1:00
    Shanghai
    74
    Wednesday 0:00
    Paris
    78
    Tuesday 15:00
    HongKong
    69
    Wednesday 0:00

    F. Използване на фураж

    Тази емисия на джаджи се предоставя безплатно и с единствената цел да интегрира емисията в други уебсайтове (т.е. приложенията са изключени) и при условие за разумна и приемлива употреба. Запазваме си правото да променяме структурата на емисията (формата на данните) по всяко време и без предварително известие, така че е по-добре да се свържете с нас, ако планирате да направите персонализирана интеграция.

    Когато извършвате интеграцията, има няколко деонтологични правила, които трябва да се прилагат при използване на емисията с данни:

    • Първо, винаги се уверявайте, че приписването на първоначалното EPA е налице. Всички данни за качеството на въздуха, които можете да намерите в проекта за Световен индекс за качеството на въздуха, са благодарение на упоритата работа на всички EPA по целия свят, така че, моля, не забравяйте да предоставите приписването и на тяхната работа. Ако използвате програмния API, приписването е достъпно от полето attribution .
    • Ако сте от институция и използвате данните, моля, покажете уважение и върнете кредитите за нашата работа. Ако се опитвате да изтриете емисията с данни, моля, имайте предвид, че този проект разчита на проекти за спонсорство и сътрудничество, така че помислете дали да ни подкрепите, вместо да ни изтриете, особено ако сте мащабна институция или университет.
    • В интерес на истината, не действайте като WRI ( Световен институт за ресурси ): премахване на цялостната емисия с данни за проекта за Световния индекс на качеството на въздуха и бъдете толкова евтини, че дори не биха дали никакво приписване на нашата работа, и това въпреки техните 80 милиони годишно финансиране в щатски долари. Не ни вярвате? Вижте тази моментна снимка .

    Ж. Бъдещи подобрения

    Това е първата версия на този нов API за емисии на джаджи. Има доста подобрения, които вече са в процес на подготовка, като например регулируема графична ширина и височина, избираема скала на AQI и т.н. Ако искате да предложите друго конкретно подобрение, не се колебайте да ни изпратите съобщение.

    Знаете ли за станции за качество на въздуха във вашия район? защо не участвате в картата със собствена станция за качество на въздуха?
    Научете повече на
    > aqicn.org/gaia/ <
    Регистрирайте се за нашия безплатен месечен пощенски списък и получавайте известия, когато са налични нови статии.

    Щракнете тук, за да видите всички записи на ЧЗВ

    Относно качеството на въздуха и измерването на замърсяването:

    Относно нивата на качеството на въздуха

    -Стойности на индекса за качество на въздуха (AQI).Нива на загриженост за здравето
    0 - 50добреКачеството на въздуха се счита за задоволително и замърсяването на въздуха представлява малък или никакъв риск
    51 -100умеренКачеството на въздуха е приемливо; въпреки това за някои замърсители може да има умерена опасност за здравето на много малък брой хора, които са необичайно чувствителни към замърсяването на въздуха.
    101-150Нездравословна за чувствителни групиЧленовете на чувствителните групи могат да имат здравни ефекти. Обществеността не е вероятно да бъде засегната.
    151-200нездравословенВсеки може да започне да изпитва здравни ефекти; членовете на чувствителните групи могат да имат по-сериозни последици за здравето
    201-300Много НездравословнотоЗдравни предупреждения за аварийни условия. Цялото население е по-вероятно да бъде засегнато.
    300+опасенСигнал за здравето: всеки може да има по-сериозни последици за здравето

    За да научите повече за качеството на въздуха и замърсяването, вижте темата за качеството на въздуха в wikipedia или ръководството на airnow за качеството на въздуха и вашето здраве .

    За много полезни здравни съвети на д-р Ричард Сейнт Сир от Пекин проверете блога на www.myhealthbeijing.com .


    Известие за използване: Всички данни за качеството на атмосферния въздух не са валидни към момента на публикуването и поради осигуряване на качеството, тези данни могат да бъдат променяни без предизвестие по всяко време. Проектът Световен индекс на качеството на въздуха е упражнил всички разумни умения и внимание при съставянето на съдържанието на тази информация и при никакви обстоятелства Проектният екип на Световния Индекс на Качеството на Въздуха или неговите агенти са отговорни по договор, нередовност или по друг начин за всяка загуба, нараняване или щета, възникващи пряко или косвено от предоставянето на тези данни.



    Settings


    Language Settings:


    Temperature unit:
    Celcius