التوعية بجودة الهواء في الأماكن باستخدام واجهة برمجة التطبيقات 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 على دبابيس المواقع الجغرافية

  • اختَر مؤشر الموقع الجغرافي: مؤشر جودة الهواء عام أو مؤشر جودة محلي (ما يصل إلى 70 مؤشرًا مختلفًا لـ مؤشر جودة الهواء (AQI)). مؤشر جودة الهواء (AQI) هو المقياس الذي يتم من خلاله في بلد معيّن، على سبيل المثال، وكالة حماية البيئة في الولايات المتحدة (EPA)، تصنيف مستويات جودة الهواء المختلفة استنادًا إلى طرق الاحتساب المختلفة ومصادر البيانات والأغراض المحدّدة.
  • يمكنك بدء إنشاء تمثيل مرئي للقيمة الرئيسية لواجهة برمجة التطبيقات 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 على خريطة

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

  • لتقديم نظرة عامة شاملة
  • لتظهر الفروقات الدقيقة في تلك المنطقة بسرعة

استخدم واجهة برمجة تطبيقات JavaScript للخرائط مع 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 - لوحة ألوان مؤشر جودة الهواء في الولايات المتحدة.

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

    • UAQI بمقياس متدرج (من 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): ضعيف / ممتاز

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

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

    الخلاصة

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

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

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

    المساهمون

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

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