ادغام اولیه ساده و مستقیم است. ابتدا باید کد زیر را اضافه کنید:

  
<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 نام شهری است که می‌خواهید میزان فعلی کیفیت هوا را برای آن نشان دهید (به عنوان مثال «شهر: «لندن»).

北京

127

北京空气质量

127

轻度污染

更新时间 星期六3:00

PM2.5 AQI		127
PM10 AQI		72
O3 AQI		1

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

127

Beijing Air Quality.

127

Unhealthy for Sensitive Groups

Updated on Saturday 3:00

PM2.5 AQI		127
PM10 AQI		72
O3 AQI		1

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

on Saturday 3: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 )،
• «% تأثیر» برای تأثیر سلامت مرتبط (مثلاً 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 Unhealthy for Sensitive Groups.
%aqi <small>(%impact)</small>	127 Beijing Air Quality. 127 Unhealthy for Sensitive Groups Updated on Saturday 3:00 PM2.5 AQI 127 PM10 AQI 72 O3 AQI 1 Data monitored by Beijing Environmental Protection Monitoring Center (北京市环境保护监测中心) . Click for more information. (Unhealthy for Sensitive Groups)
<span style='%style;font-size:12px;padding:5px 10px;'>%cityname AQI: %impact</span>	Beijing AQI: Unhealthy for Sensitive Groups
%cityname Air Quality is <span style='%style;padding:0 5px'>%impact</span> (%aqiv on %date)	Beijing Air Quality is Unhealthy for Sensitive Groups ( 127 Beijing Air Quality. 127 Unhealthy for Sensitive Groups Updated on Saturday 3:00 PM2.5 AQI 127 PM10 AQI 72 O3 AQI 1 Data monitored by Beijing Environmental Protection Monitoring Center (北京市环境保护监测中心) . Click for more information. on Saturday 3: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: 127 Beijing Air Quality. 127 Unhealthy for Sensitive Groups Updated on Saturday 3:00 PM2.5 AQI 127 PM10 AQI 72 O3 AQI 1 Data monitored by Beijing Environmental Protection Monitoring Center (北京市环境保护监测中心) . Click for more information. Unhealthy for Sensitive Groups
%details	Beijing Air Quality. 127 Unhealthy for Sensitive Groups Updated on Saturday 3:00 PM2.5 AQI 127 PM10 AQI 72 O3 AQI 1 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.

127

Unhealthy for Sensitive Groups

Poprawiony: Sobota 3:00

PM2.5 AQI		127
PM10 AQI		72
O3 AQI		1

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

55

London Air Quality.

55

Moderate

Updated on Friday 19:00

PM2.5 AQI		55
PM10 AQI		24
O3 AQI		16

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.

Friday 19:00

New-york

-

New-york Air Quality.

-

Not Available

Never updated!

Data monitored by . Click for more information.

Thursday 9:00

Seoul

57

Seoul Air Quality.

57

Moderate

Updated on Saturday 5:00

PM2.5 AQI		57
PM10 AQI		36
O3 AQI		26

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

Saturday 5: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

Kakinokizaka, Meguro, Tokyo

63

Kakinokizaka, Meguro, Tokyo Air Quality.

63

Moderate

Updated on Saturday 4:00

PM2.5 AQI		63
PM10 AQI		19
O3 AQI		42

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

Saturday 4:00

Shanghai

70

Shanghai Air Quality.

70

Moderate

Updated on Saturday 3:00

PM2.5 AQI		70
PM10 AQI		37
O3 AQI		33

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.

Saturday 3:00

Paris

27

Paris Air Quality.

27

Good

Updated on Friday 20:00

PM2.5 AQI		64
PM10 AQI		22
O3 AQI		27

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

Friday 20:00

HongKong

54

HongKong Air Quality.

54

Moderate

Updated on Saturday 3:00

PM2.5 AQI		54
PM10 AQI		29
O3 AQI		44

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

Saturday 3:00

این فید ویجت به صورت رایگان و صرفاً با هدف ادغام فید در سایر وب‌سایت‌ها (یعنی برنامه‌ها مستثنی هستند) و به شرط استفاده معقول و قابل قبول ارائه می‌شود. ما حق تغییر ساختار فید (فرمت داده) را در هر زمان و بدون اطلاع قبلی محفوظ می داریم، بنابراین اگر قصد دارید یکپارچه سازی سفارشی انجام دهید، بهتر است با ما تماس بگیرید.

هنگام انجام ادغام، قوانین عمقی کمی وجود دارد که باید هنگام استفاده از خوراک داده اعمال شوند:

• اول، همیشه مطمئن شوید که انتساب به EPA مبدا وجود دارد. تمام داده‌های کیفیت هوا که می‌توانید در پروژه شاخص کیفیت هوای جهانی بیابید به لطف کار سخت همه سازمان‌های حفاظت محیط زیست در سرتاسر جهان است، بنابراین لطفاً مطمئن شوید که برای کار آنها نیز ذکر شده است. اگر از API برنامه‌ریزی شده استفاده می‌کنید، انتساب از قسمت attribution در دسترس است.
• اگر از مؤسسه ای هستید و از داده ها استفاده می کنید، لطفاً احترام بگذارید و اعتبار کار ما را پس دهید. اگر می‌خواهید فید داده‌ها را حذف کنید، لطفاً به خاطر داشته باشید که این پروژه به پروژه‌های حمایت مالی و همکاری متکی است، بنابراین به جای حذف ما از ما حمایت کنید ، به خصوص اگر مؤسسه یا دانشگاهی در مقیاس بزرگ هستید.
• در واقع، مانند WRI ( موسسه منابع جهانی ) عمل نکنید: فید داده‌های پروژه شاخص کیفیت هوای جهانی را از بین می‌برند و آنقدر ارزان هستند که حتی برای کار ما هیچ گونه انتسابی نمی‌دهند، و این با وجود 80 میلیون دلار بودجه سالانه ما را باور نمی کنید؟ این عکس فوری را بررسی کنید.

این اولین نسخه از این API فید ویجت جدید است. در حال حاضر چند پیشرفت در خط لوله وجود دارد، مانند عرض و ارتفاع گرافیکی قابل تنظیم، مقیاس AQI قابل انتخاب، و غیره.