جودة الهواء في الأماكن

في هذا المستند، ستتعرّف على كيفية استخدام 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 API لخدمة "خرائط 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 */
   );
}

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

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

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

    الخاتمة

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

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

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

    المساهمون

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

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