التوعية بجودة الهواء في الأماكن باستخدام واجهة برمجة التطبيقات Air Quality API

في هذا المستند، ستتعرّف على كيفية استخدام واجهة برمجة التطبيقات Air Quality API لإنشاء تجارب بحث غنية عن الأماكن. سنوضّح كيف يمكن أن تكون جودة الهواء إشارة قيّمة للمستخدمين منذ البداية وحتى نهاية مسار الإحالة الناجحة، وكيف يمكن تضمين بيانات Air Quality API في التجارب الحالية.

حالات الاستخدام والقيمة المضافة

يمكن أن تتناسب إشارات واجهة برمجة التطبيقات جودة الهواء مع تجارب البحث المختلفة، مثلاً عندما يبحث المستخدمون عن موقع جغرافي لزيارته. تقدّم Air Quality API ما يلي:

  • الوقت الفعلي * والبيانات السابقة: بيانات جديدة ودقيقة تمثّل الحالة الحالية بالإضافة إلى بيانات سابقة خلال فترة 30 يومًا بدقة ساعة. (* نبذة كل ساعة عن جودة الهواء خارج المنزل)
  • البيانات العالمية والمحلية: تغطي مناطق بأكملها في أكثر من 100 بلد، ومع ذلك، توفّر بيانات Air Quality API التي تمّت ترجمتها بشكل كبير (حتى 500 متر) إشارات رئيسية للمستخدمين للمقارنة واتخاذ القرارات بشأن المكان الأنسب.

يمكن أن تختلف جودة الهواء بشكل كبير حتى في المواقع الجغرافية القريبة.

نموذج الجولة التفصيلية

عرض بيانات جودة الهواء في مرحلة مبكرة من التجربة

هناك طريقتان رئيسيتان لعرض بيانات Air Quality API:

عرض بيانات Air Quality API على دبابيس المواقع الجغرافية

  • اختَر مؤشر موقعك الجغرافي: مؤشر جودة الهواء العالمي أو مؤشر جودة الهواء المحلي (تتوفّر ما يصل إلى 70 مؤشر جودة هواء مختلفًا). مؤشر جودة الهواء (AQI) هو المقياس الذي يصنف به بلد معيّن، مثل وكالة حماية البيئة الأمريكية، مستويات جودة الهواء المختلفة، استنادًا إلى طرق احتساب مختلفة ومصادر بيانات وأغراض محدّدة.
  • يمكنك الاطّلاع على قيمة Air Quality API الرئيسية ورمز اللون مباشرةً من تجربة البحث عن الأماكن.

يمكن أن يتضمّن العرض التلقائي رمز اللون فقط.


عرض المزيد من معلومات Air Quality API عند اختيار دبوس:

  • معنى مؤشر جودة الهواء العالمي / مؤشر جودة الهواء المحلي
  • مستويات الملوّثات، وهي مقياس للجسيمات والغازات في الهواء: الملوّث السائد، والتركيز، والمصادر، والتأثيرات
  • الاقتراحات الصحية، وهي إجراءات مقترَحة لظروف جودة الهواء الحالية
  • يمكنك ضبط مستوى المعلومات المعروضة تلقائيًا لتلبية احتياجاتك. يُرجى العلم أنّ نقاط البيانات الخاصة بالموقع الجغرافي تكون مفيدة في أغلب الأحيان مقارنةً بالمواقع الجغرافية الأخرى.

مثال على عرض قسم جودة الهواء

استجابة جودة الهواء

{
    "dateTime": "2023-08-09T10:00:00Z",
    "regionCode": "fr",
    "indexes": [
       {
            "code": "uaqi",
            "displayName": "Universal AQI",
            "aqi": 76,
            "aqiDisplay": "76",
            "color": {
                "red": 0.4117647,
                "green": 0.77254903,
                "blue": 0.20392157
            },
            "category": "Good air quality",
            "dominantPollutant": "pm10"
        },
       …
    ],
    "pollutants": [
       {
            "code": "co",
            "displayName": "CO",
            "fullName": "Carbon monoxide",
            "concentration": {
                "value": 95.18,
                "units": "PARTS_PER_BILLION"
            }...
        },
       …
    ],
    "healthRecommendations": -{
        "generalPopulation": "With this level of air quality, you have no limitations. Enjoy the outdoors!",
        "elderly": "If you start to feel respiratory discomfort such as coughing or breathing difficulties, consider red ...",
        "lungDiseasePopulation": …
    }
}
  • بدلاً من ذلك، يمكنك طلب بيانات جودة الهواء عند التفاعل مع موقع جغرافي فقط.

  • يمكنك استخدام مؤشر واجهة برمجة التطبيقات Air Quality API لفلترة الأماكن المجاورة، مثلاً: إذا كنت تبحث عن حدائق في منطقتك، سيتم عرض فقط الحدائق ذات جودة الهواء الجيدة.

استجابة جودة الهواء

...
"color":{
  "red": 0.9490196,
  "green": 0.98039216,
  "blue": 0.019607844
}
...
 التحويل إلى نموذج أحمر أخضر أزرق 
  var red = parseInt(colorResponse.red*255)|| 1;
  var green = parseInt(colorResponse.green*255)|| 1;
  var blue = parseInt(colorResponse.blue*255)|| 1; 
  // --> output rgb(241,250,5)

عرض طبقة خريطة التمثيل اللوني في Air Quality API على خريطة

تعتبر المربعات الملونة في خريطة التمثيل اللوني طريقة رائعة:

  • لتقديم نظرة عامة على منطقة كبيرة
  • لعرض الاختلافات الدقيقة بسرعة في تلك المنطقة.

استخدِم Maps JavaScript API مع ImateMapType لعرض المربّعات الفردية اللازمة لتغطية مساحة العرض بالكامل في خريطة Google. وستتم إعادة تحميل مربّعات خريطة التمثيل اللوني أثناء تفاعل المستخدم مع الخريطة عن طريق العرض الشامل أو تكبير/تصغير الموقع أو تغييره.

يُرجى العلم أنّ قيمة مستوى التكبير المسموح به تصل إلى 16.
قد تختفي طبقة مربّعات خريطة الحرارة في Air Quality API عند إجراء بحث محلي دقيق.

يمكنك اختيار أنواع خرائط "الخريطة الحرارية" ضمن مجموعة محدودة من مؤشرات جودة الهواء:

  • ‫UAQI_RED_GREEN: لوحة ألوان مؤشر جودة الهواء العالمي باللونَين الأحمر والأخضر
  • UAQI_INDIGO_PERSIAN - لوحة ألوان فارسية ونيلية لمؤشر جودة الهواء العالمي
  • ‫PM25_INDIGO_PERSIAN - لوحة ألوان مؤشر PM2.5 باللون الأزرق الداكن الفارسي
  • GBR_DEFRA - لوحة ألوان مؤشر جودة الهواء اليومية (المملكة المتحدة)
  • DEU_UBA - لوحة ألوان مؤشر جودة الهواء المحلية في ألمانيا.
  • CAN_EC - لوحة ألوان مؤشر الصحة لجودة الهواء في كندا
  • FRA_ATMO - لوحة ألوان مؤشر جودة الهواء في فرنسا
  • US_AQI: لوحة ألوان مؤشر جودة الهواء في الولايات المتحدة

    • احرص على الإشارة إلى مقياس الألوان ليتمكّن المستخدمون من فهم القيمة وترتيبها حسب اللون:

    • مقياس متدرّج لمؤشر جودة الهواء (0-100): سيء / ممتاز

    مقتطف رمز CSS للوحة الألوان: 

    .gradient-scale { 
background: linear-gradient(to right, 
    rgb(99, 20, 161) 0%, /* purple */
    rgb(149, 0, 25) 20%, /* red */
    rgb(248, 47, 21) 40%, /* orange */
    rgb(255, 248, 35) 60%, /* yellow */
    rgb(34,163,120) 80%, /* steelblue */
    rgb(255,255,255) 100% /* white */
   );
}

    • ألوان خالصة لتمثيل النقطة الرئيسية في مقياس UAQI (0-100): سيّئ / ممتاز

    عدد طلبات البحث والتكاليف المرتبطة بها

    الخاتمة

    لقد أظهرنا أنّ واجهة برمجة التطبيقات Air Quality API يمكن أن تكون نقطة بيانات مهمة يمكن للمستخدمين من خلالها اختيار مكان لزيارته. لذلك، يجب أن تكون بيانات "جودة الهواء" مرئية في أقرب وقت ممكن ضمن تجربة البحث مع مراعاة كمية المعلومات المعروضة في الوقت نفسه وطريقة عرضها.

    الإجراءات التالية

    قراءة إضافية مقترحة:

    المساهمون

    تُعدّ هذه المقالة من إعداد Google. كتبه المساهمون التاليون في الأصل.
    المؤلف الرئيسي:

    توماس أنغلارت | مهندس حلول