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

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

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

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

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

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

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

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

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

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

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

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


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

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

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

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

ردّ 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 */
   );
}

    • ألوان ثابتة لتمثيل النقطة الرئيسية في مقياس مؤشر جودة الهواء العالمي (0-100): رديء / ممتاز

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

    • Maps JavaScript API: خريطة واحدة عند تحميل التجربة
    • Air Quality API:
      • طلب واحد لكل مكان (كلها عند تحميل الخريطة أو فقط عند اختيار المستخدِم)
      • طبقة مربّعات الخريطة الحرارية: يبلغ حجم كل صورة مربّع 256×256 بكسل، ولتغطية خريطة عادية معروضة على جهاز جوّال أو على الويب، تحتاج إلى 12 إلى 14 مربّعًا. يتم احتساب كل مربّع يتم جلبه كوحدة واحدة من رقم تعريف المنتج.
    • Nearby Search (New) API: طلب واحد لكل 20 مكانًا معروضًا تختلف الفوترة وفقًا لـ بيانات المكان التي تشكّل جزءًا من ردّ الطلب.

    الخاتمة

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

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

    مقالات نقترح قراءتها:

    المساهمون

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

    Thomas Anglaret | مهندس حلول