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

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

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

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

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

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

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

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

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

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

  • اختَر مؤشر موقعك الجغرافي: مؤشر جودة الهواء العالمي أو مؤشر جودة الهواء المحلي (يتوفّر ما يصل إلى 70 مؤشر جودة هواء (AQI) مختلف). مؤشر جودة الهواء (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 - Universal Air Quality Index indigo-persian palette.
  • PM25_INDIGO_PERSIAN - PM2.5 index indigo-persian palette.
  • GBR_DEFRA - Daily Air Quality Index (UK) color palette.
  • DEU_UBA - German Local Air Quality Index color palette.
  • 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 مربّعًا. يتم احتساب كل مربّع تم سحبه كوحدة رمز تخزين تعريفي واحدة.
    • Nearby Search (New) API: طلب بحث واحد لكل 20 مكان معروض. تختلف الفوترة وفقًا لبيانات المكان التي تشكّل جزءًا من ردّ طلب البحث.

    الخاتمة

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

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

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

    المساهمون

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

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