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

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

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

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

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

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

  • UAQI_RED_GREEN - لوحة ألوان مؤشر جودة الهواء العالمي باللونَين الأحمر والأخضر
  • UAQI_INDIGO_PERSIAN - لوحة ألوان مؤشر جودة الهواء العالمي (UAQI) باللونين النيلي والفارسي
  • 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 - لوحة ألوان مؤشر جودة الهواء في الولايات المتحدة

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

    • مقياس التدرّج اللوني لمؤشر جودة الهواء في أوكرانيا (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 صيانة هذه المقالة. كتب المساهمون التاليون هذا المحتوى في الأصل.
    المؤلف الرئيسي:

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