بنیادی انضمام آسان اور سیدھا آگے ہے۔ آپ کو پہلے درج ذیل کوڈ کو شامل کرنے کی ضرورت ہے:

  
<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` ویجیٹ کے کنفیگریشن بلاک کو بطور دلیل لیتا ہے۔ پیرامیٹر `کنٹینر: "city-aqi-container"` سے مراد اس ٹیگ کی id ہے جس میں آپ ویجیٹ داخل کرنا چاہتے ہیں (جیسے `<span id='city-aqi-container'></span>`)، اور پیرامیٹر city شہر کا نام جس کے لیے آپ موجودہ ایئر کوالٹی ریڈنگ دکھانا چاہتے ہیں (جیسے `شہر: "لندن"`)۔

北京

87

北京空气质量

87

良

更新时间 星期二14:00

PM2.5 AQI		87
PM10 AQI		61
O3 AQI		51

Data monitored by Beijing Environmental Protection Monitoring Center (北京市环境保护监测中心) . Click for more information.

آپ lang آپشن سیٹ کر کے استعمال کی جانے والی زبان کی بھی وضاحت کر سکتے ہیں۔ مثال کے طور پر، چینی میں ویجیٹ شامل کرنے کے لیے (جیسا کہ دائیں طرف دکھایا گیا ہے)، درج ذیل کوڈ کا استعمال کریں:

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

فی الحال تعاون یافتہ زبانیں ہیں:

Beijing AQI is

87

Beijing Air Quality.

87

Moderate

Updated on Tuesday 14:00

PM2.5 AQI		87
PM10 AQI		61
O3 AQI		51

Data monitored by Beijing Environmental Protection Monitoring Center (北京市环境保护监测中心) . Click for more information.

on Tuesday 14: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 )
• غیر سجاوٹ (کچے متن) AQI قدر (مثلاً 58 ) کے لیے `%aqiv`،
• آرائش شدہ AQI تفصیلات کے سی ایس ایس ڈیکلریشن کے لیے `%style` (مثلاً background-color: #ffde33;color:#000000; )
• `%تاریخ` اس وقت کے لیے جس میں AQI کو اپ ڈیٹ کیا گیا تھا (مثلاً Wed 20:00 )،
• متعلقہ صحت کے اثرات کے لیے `% اثر` (مثلاً Good ، Moderate ...)
• AQI ڈیٹا انتساب کے لیے `%انتساب` (مثلا Beijing Environmental Protection Monitoring Center )
• AQI کی مکمل تفصیلات کے لیے `%تفصیلات` (ماؤس کو AQI قدر پر منتقل کرنے پر ظاہر ہونے والا پاپ اپ مواد)۔

یہاں چند مثالیں ہیں:

Display Configuration	Result
%cityname Air Quality is <b>%impact</b>.	Beijing Air Quality is Moderate.
%aqi <small>(%impact)</small>	87 Beijing Air Quality. 87 Moderate Updated on Tuesday 14:00 PM2.5 AQI 87 PM10 AQI 61 O3 AQI 51 Data monitored by Beijing Environmental Protection Monitoring Center (北京市环境保护监测中心) . Click for more information. (Moderate)
<span style='%style;font-size:12px;padding:5px 10px;'>%cityname AQI: %impact</span>	Beijing AQI: Moderate
%cityname Air Quality is <span style='%style;padding:0 5px'>%impact</span> (%aqiv on %date)	Beijing Air Quality is Moderate ( 87 Beijing Air Quality. 87 Moderate Updated on Tuesday 14:00 PM2.5 AQI 87 PM10 AQI 61 O3 AQI 51 Data monitored by Beijing Environmental Protection Monitoring Center (北京市环境保护监测中心) . Click for more information. on Tuesday 14: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: 87 Beijing Air Quality. 87 Moderate Updated on Tuesday 14:00 PM2.5 AQI 87 PM10 AQI 61 O3 AQI 51 Data monitored by Beijing Environmental Protection Monitoring Center (北京市环境保护监测中心) . Click for more information. Moderate
%details	Beijing Air Quality. 87 Moderate Updated on Tuesday 14:00 PM2.5 AQI 87 PM10 AQI 61 O3 AQI 51 Data monitored by Beijing Environmental Protection Monitoring Center (北京市环境保护监测中心) . Click for more information.

اگر آپ DIY انضمام کو ترجیح دیتے ہیں، تو آپ جاوا اسکرپٹ فنکشن کال بیک کی بھی وضاحت کر سکتے ہیں جب ڈیٹا لوڈ ہو جائے۔ آپ کو پیرامیٹر بلاک میں آپشن 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.

87

Moderate

Poprawiony: Wtorek 14:00

PM2.5 AQI		87
PM10 AQI		61
O3 AQI		51

Data monitored by Beijing Environmental Protection Monitoring Center (北京市环境保护监测中心) . Click for more information.

aqi آبجیکٹ سیکشن C (ڈسپلے فارمیٹ) میں مذکور تمام مطلوبہ الفاظ پر مشتمل ہے۔

ایک صفحے میں متعدد وجیٹس کو شامل کرنا ممکن ہے۔ آپ کو صرف `_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>"));  
}  

London

61

London Air Quality.

61

Moderate

Updated on Tuesday 6:00

PM2.5 AQI		61
PM10 AQI		24
O3 AQI		9

Data monitored by UK-AIR, air quality information resource - Defra, UK , London Air Quality Network - Environmental Research Group, King's College London . Click for more information.

Tuesday 6:00

New-york

-

New-york Air Quality.

-

Not Available

Never updated!

Data monitored by . Click for more information.

Thursday 9:00

Seoul

91

Seoul Air Quality.

91

Moderate

Updated on Tuesday 15:00

PM2.5 AQI		91
PM10 AQI		63
O3 AQI		58

Data monitored by South Air Korea Environment Corporation (대기오염실시간공개시스템) , Seoul Clean Air Pollution Information (서울특별시 기후대기환경정보) . Click for more information.

Tuesday 15:00

Guangzhou

-

Guangzhou Air Quality.

-

Not Available

Updated on Tuesday, Mar 4th 2025

PM2.5 AQI

-

Data monitored by Guangzhou Environmental Protection Bureau (广州市生态环境局) , China National Urban air quality real-time publishing platform (全国城市空气质量实时发布平台) , U.S. Consulate Guangzhou Air Quality Monitor . Click for more information.

Tuesday 20:00

Naitōmachi, Shinjuku-ku, Tōkyō-to

65

Naitōmachi, Shinjuku-ku, Tōkyō-to Air Quality.

65

Moderate

Updated on Tuesday 14:00

PM2.5 AQI		65
PM10 AQI		9
O3 AQI		45

Data monitored by Japan Atmospheric Environmental Regional Observation System (環境省大気汚染物質広域監視システム) . Click for more information.

Tuesday 14:00

Shanghai

122

Shanghai Air Quality.

122

Unhealthy for Sensitive Groups

Updated on Tuesday 14:00

PM2.5 AQI		122
PM10 AQI		63
O3 AQI		87

Data monitored by Shanghai Environment Monitoring Center(上海市环境监测中心) , China National Urban air quality real-time publishing platform (全国城市空气质量实时发布平台) , U.S. Consulate Shanghai Air Quality Monitor . Click for more information.

Tuesday 14:00

Paris

58

Paris Air Quality.

58

Moderate

Updated on Tuesday 5:00

PM2.5 AQI		58
PM10 AQI		24
O3 AQI		9

Data monitored by AirParif - Association de surveillance de la qualité de l'air en Île-de-France , European Environment Agency . Click for more information.

Tuesday 5:00

HongKong

79

HongKong Air Quality.

79

Moderate

Updated on Tuesday 14:00

PM2.5 AQI		79
PM10 AQI		43
O3 AQI		24

Data monitored by Hong Kong Environmental Protection Department - 空氣質素健康指數單張及海報 . Click for more information.

Tuesday 14:00

یہ ویجیٹ فیڈ مفت میں فراہم کی گئی ہے، اور فیڈ کو دوسری ویب سائٹس میں ضم کرنے کے واحد مقصد کے لیے (یعنی ایپس کو خارج کر دیا گیا ہے)، اور معقول اور قابل قبول استعمال کی شرط کے تحت۔ ہم کسی بھی وقت اور پیشگی اطلاع کے بغیر فیڈ کا ڈھانچہ (ڈیٹا فارمیٹ) تبدیل کرنے کا حق محفوظ رکھتے ہیں، لہذا اگر آپ حسب ضرورت انضمام کرنے کا ارادہ رکھتے ہیں تو ہم سے رابطہ کرنا بہتر ہے۔

انضمام کرتے وقت، چند ڈیونٹولوجیکل اصول ہیں جن کا اطلاق ڈیٹا فیڈ استعمال کرتے وقت کیا جانا چاہیے:

• سب سے پہلے، ہمیشہ اس بات کو یقینی بنائیں کہ ابتدائی EPA سے انتساب موجود ہے۔ ایئر کوالٹی کا تمام ڈیٹا جو آپ ورلڈ ایئر کوالٹی انڈیکس پروجیکٹ پر حاصل کر سکتے ہیں وہ پوری دنیا کے تمام EPA کی محنت کی بدولت ہے، اس لیے براہ کرم ان کے کام کے لیے بھی انتساب فراہم کرنا یقینی بنائیں۔ اگر آپ پروگرامیٹک API استعمال کرتے ہیں تو انتساب attribution فیلڈ سے دستیاب ہے۔
• اگر آپ کسی ادارے سے ہیں اور ڈیٹا استعمال کر رہے ہیں، تو براہ کرم، احترام کا مظاہرہ کریں اور ہمارے کام کے لیے کریڈٹ واپس کریں۔ اگر آپ ڈیٹا فیڈ کو ختم کرنے کی کوشش کر رہے ہیں تو، براہ کرم، ذہن میں رکھیں کہ یہ پروجیکٹ اسپانسرشپ اور تعاون کے منصوبوں پر منحصر ہے، لہذا ہمیں ختم کرنے کے بجائے ہماری مدد کرنے پر غور کریں، خاص طور پر اگر آپ بڑے پیمانے پر ادارہ یا یونیورسٹی ہیں۔
• حقیقت میں، WRI ( ورلڈ ریسورس انسٹی ٹیوٹ ) کی طرح کام نہ کریں: مجموعی طور پر ورلڈ ایئر کوالٹی انڈیکس پروجیکٹ ڈیٹا فیڈ کو ختم کرنا، اور اتنا سستا ہونا کہ وہ ہمارے کام کے لیے کوئی انتساب بھی نہیں کریں گے، اور یہ ان کے 80 کے باوجود ملین سالانہ USD فنڈنگ۔ ہم پر یقین نہیں ہے؟ اس سنیپ شاٹ کو چیک کریں۔

یہ اس نئے ویجیٹ فیڈ API کا پہلا ورژن ہے۔ پائپ لائن میں پہلے سے ہی کچھ بہتری موجود ہیں، جیسے کہ ایڈجسٹ گرافک چوڑائی اور اونچائی، قابل انتخاب AQI اسکیل وغیرہ۔ اگر آپ کوئی اور خاص بہتری تجویز کرنا چاہتے ہیں تو بلا جھجھک ہمیں ایک پیغام بھیجیں۔