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

في هذا المستند، ستتعرّف على كيفية استخدام واجهة برمجة التطبيقات 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
}
...
 التحويل إلى نموذج RGB 
  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. كتب المساهمون التاليون هذه المقالة في الأصل.
    المؤلف الرئيسي:

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