أداة جودة الهواء - تغذية محسنة جديدة
Air Quality Widget - New Improved Feed

Posted on July 28th 2015
يشارك: aqicn.org/faq/2015-07-28/air-quality-widget-new-improved-feed/ar/
{ widget : feed }

من أجل تحسين تكامل عناصر واجهة المستخدم الخاصة بـ AQI داخل مواقع الويب الخارجية، قمنا بتطوير خلاصة واجهة برمجة تطبيقات عناصر واجهة المستخدم الجديدة. بالمقارنة مع موجز عناصر واجهة المستخدم الحالي، يوفر موجز واجهة برمجة التطبيقات الجديد هذا مرونة أكبر للتكامل، ولكنه يوفر أيضًا العديد من الخيارات لتخصيص مظهر عنصر واجهة المستخدم.

يمكنك، على سبيل المثال، عرض عنصر واجهة مستخدم صغير بسيط مثل ... (حرك الماوس فوق رقم AQI لعرض التفاصيل)، أو عنصر واجهة مستخدم أكبر يحتوي على تفاصيل حول الملوثات خلال الـ 24 ساعة الماضية كما هو موضح على اليمين.

يدعم الإطار الجديد أيضًا القوالب واللغات المتعددة (الإنجليزية، والصينية المبسطة والتقليدية، والإسبانية، ...) بالإضافة إلى إمكانية إجراء تكامل برمجي مع عمليات رد اتصال جافا سكريبت المستندة إلى البيانات.

أ. الإعداد الأساسي

التكامل الأساسي بسيط ومباشر. تحتاج أولاً إلى إضافة الجزء التالي من التعليمات البرمجية:

  
<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"` إلى معرف العلامة التي تريد إدراج الأداة فيها (على سبيل المثال `<span id='city-aqi-container'></span>`)، والمعلمة city هي اسم المدينة التي تريد عرض القراءة الحالية لجودة الهواء فيها (على سبيل المثال `المدينة: "لندن"`).

ب. تحديد اللغة

...

يمكنك أيضًا تحديد اللغة التي سيتم استخدامها عن طريق ضبط خيار 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

    إذا لم يتم تحديده أو تعيينه على null ، فسيتم استخدام اللغة الإنجليزية.

  • ج. تحديد تنسيق العرض

    ...

    من الممكن تخصيص النص الذي سيتم عرضه داخل الأداة عن طريق تحديد خيار 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 ...)
    • "نسبة الإسناد" لإسناد بيانات تنظيم القاعدة في العراق (على سبيل المثال، Beijing Environmental Protection Monitoring Center )
    • `%details` للحصول على تفاصيل AQI الكاملة (يتم عرض محتوى النافذة المنبثقة عند تحريك الماوس فوق قيمة AQI).

    وفيما يلي بعض الأمثلة على ذلك:

    Display Configuration Result

    د. رد الاتصال البرنامجي

    إذا كنت تفضل التكامل بنفسك، فيمكنك أيضًا تحديد رد اتصال وظيفة جافا سكريبت ليتم عند تحميل البيانات. تحتاج فقط إلى إضافة 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>

    سوف تنتج المحتوى التالي:

    تحتوي كائنات 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:

    واو استخدام الأعلاف

    يتم توفير خلاصة الأدوات هذه مجانًا، ولغرض وحيد هو دمج الخلاصة في مواقع الويب الأخرى (أي يتم استبعاد التطبيقات)، وبشرط الاستخدام المعقول والمقبول. نحن نحتفظ بالحق في تغيير بنية الخلاصة (تنسيق البيانات) في أي وقت ودون إشعار مسبق، لذا من الأفضل الاتصال بنا إذا كنت تخطط لإجراء تكامل مخصص.

    عند القيام بالتكامل، هناك عدد قليل من القواعد الأخلاقية التي ينبغي تطبيقها عند استخدام خلاصة البيانات:

    • أولاً، تأكد دائمًا من وجود الإسناد إلى وكالة حماية البيئة الأصلية. جميع بيانات جودة الهواء التي يمكنك العثور عليها في مشروع مؤشر جودة الهواء العالمي هي بفضل العمل الشاق الذي قامت به جميع وكالة حماية البيئة في جميع أنحاء العالم، لذا يرجى التأكد من إسناد عملهم أيضًا. إذا كنت تستخدم واجهة برمجة التطبيقات الآلية، فستكون الإسناد متاحًا من حقل attribution .
    • إذا كنت من مؤسسة وتستخدم البيانات، فيرجى إظهار الاحترام وسداد الاعتمادات لعملنا. إذا كنت تحاول الحصول على خلاصة البيانات، فيرجى أن تضع في اعتبارك أن هذا المشروع يعتمد على مشاريع الرعاية والتعاون، لذا فكر في دعمنا بدلاً من إلغائنا، خاصة إذا كنت مؤسسة أو جامعة واسعة النطاق.
    • As a matter of fact, do not act like the WRI (World Resource Institute ): Scrapping the overall World Air Quality Index project data feed, and beeing so cheap that they would not even give any attribution for our work, and this despite their 80 millions annual USD fundings. Don't believe us? Check this snapshot.

    ز. التحسينات المستقبلية

    هذا هو الإصدار الأول من واجهة برمجة تطبيقات موجز عناصر واجهة المستخدم الجديدة. هناك عدد لا بأس به من التحسينات قيد الإعداد بالفعل، مثل العرض والارتفاع الرسومي القابل للتعديل، ومقياس AQI القابل للتحديد، وما إلى ذلك. إذا كنت ترغب في اقتراح أي تحسين محدد آخر، فلا تتردد في إرسال رسالة إلينا.

    انقر هنا لرؤية كافة إدخالات الأسئلة الشائعة
  • AQI Scale: What do the colors and numbers mean?
  • Using Statistical Distances for Real-time Sensor Networks Validation
  • Nitrogen Dioxyde (NO2) in our atmosphere
  • حول جودة الهواء وقياس التلوث:

    حول مستويات جودة الهواء

    -قيم مؤشر جودة الهواء (AQI).مستويات الاهتمام بالصحة
    0 - 50جيدوتعتبر جودة الهواء مرضية ، كما أن تلوث الهواء لا يشكل خطراً يُذكر
    51 -100معتدلجودة الهواء مقبولة. ومع ذلك ، فبالنسبة لبعض الملوثات قد يكون هناك قلق صحي معتدل لعدد قليل جداً من الأشخاص الذين لديهم حساسية غير عادية لتلوث الهواء.
    101-150غير صحي للمجموعات الحساسةقد يواجه أعضاء المجموعات الحساسة آثارًا صحية. من غير المحتمل أن يتأثر عامة الناس.
    151-200غير صحيقد يعاني معظم الناس من الآثار الجانبية التي تؤثر على الصحة؛ أما الأفراد الذين لديهم وضع صحي حساس فقد يعانون من مشاكل صحية خطيرة
    201-300غير صحي للغايةتحذيرات صحية لظروف الطوارئ. من المرجح أن يتأثر جميع السكان.
    300+خطيرتنبيه صحي: قد يعاني الجميع من آثار صحية أكثر خطورة

    لمعرفة المزيد عن جودة الهواء والتلوث، راجع موضوع جودة الهواء في ويكيبيديا أو دليل airnow لجودة الهواء وصحتك .

    للحصول على نصائح صحية مفيدة للغاية من طبيب بكين ريتشارد سانت سير، قم بزيارة مدونة www.myhealthbeijing.com .


    إشعار الاستخدام: جميع بيانات جودة الهواء غير مضمونة في وقت النشر ، وبسبب ضمان الجودة ، يمكن تعديل هذه البيانات ، دون سابق إنذار ، في أي وقت. لقد مارس مشروع مؤشر جودة الهواء العالمي جميع المهارات والحلول المعقولة في تجميع محتويات هذه المعلومات ولن يكون تحت أي ظرف من الظروف فريق مشروع جودة الهواء العالمي أو وكلائه مسؤولين في العقد أو الضرر أو غير ذلك عن أي خسارة أو ضرر أو ضرر ناشئ بشكل مباشر أو غير مباشر عن توريد هذه البيانات.



    Settings


    Language Settings:


    Temperature unit:
    Celcius