آگاهی از کیفیت هوا برای مکان‌هایی که از API کیفیت هوا استفاده می‌کنند

در این سند، نحوه استفاده از Air Quality API برای ایجاد تجربیات جستجوی مکان غنی را بررسی خواهید کرد. ما نشان خواهیم داد که چگونه کیفیت هوا می تواند از همان ابتدا تا پایان قیف برای کاربران یک سیگنال ارزشمند باشد و چگونه داده های API کیفیت هوا را می توان در تجربیات موجود جاسازی کرد.

موارد استفاده و ارزش افزوده

سیگنال‌های API کیفیت هوا می‌توانند در تجارب مختلف جستجو، مانند زمانی که کاربران به دنبال مکانی برای بازدید هستند، قرار بگیرند. Air Quality API ارائه می دهد:

  • زمان واقعی * و داده های تاریخی - داده های تازه و دقیق که وضعیت فعلی و همچنین داده های گذشته را در یک پنجره 30 روزه در وضوح ساعتی نشان می دهد. (* یک عکس فوری ساعتی از کیفیت هوای بیرون)
  • داده‌های جهانی و محلی - کل مناطق در بیش از 100 کشور را پوشش می‌دهد و در عین حال داده‌های API کیفیت هوا بسیار محلی شده (تا 500 متر) سیگنال‌های کلیدی را برای مقایسه و تصمیم‌گیری در مناسب‌ترین مکان برای کاربران فراهم می‌کند.

کیفیت هوا حتی برای مکان های نزدیک می تواند به شدت متفاوت باشد

نمونه راهنما

داده‌های کیفیت هوا را در اوایل تجربه نشان دهید

دو روش اصلی برای نمایش داده های API کیفیت هوا وجود دارد:

نمایش داده های API کیفیت هوا در پین های مکان

  • شاخص موقعیت مکانی خود را انتخاب کنید: AQI جهانی یا AQI محلی (حداکثر 70 شاخص مختلف کیفیت هوا (AQI) موجود است). شاخص کیفیت هوا (AQI) مقیاسی است که توسط آن یک کشور خاص، به عنوان مثال، EPA ایالات متحده ، سطوح مختلف کیفیت هوا را بر اساس روش‌های مختلف محاسبه، منابع داده‌ها و اهداف تعیین‌شده طبقه‌بندی می‌کند.
  • مستقیماً از تجربه جستجوی مکان، مقدار اصلی API کیفیت هوا و کد رنگ را تجسم کنید.

نمایش پیش فرض می تواند فقط شامل کد رنگ باشد.


نمایش اطلاعات بیشتر Air Quality API در انتخاب پین:

  • معنی AQI جهانی / محلی AQI.
  • سطوح آلاینده ، که معیاری از ذرات و گازهای موجود در هوا هستند: آلاینده غالب، غلظت، منابع و اثرات.
  • توصیه های بهداشتی ، که اقدامات توصیه شده برای شرایط فعلی کیفیت هوا هستند.
  • شما می توانید سطح اطلاعات نمایش داده شده را به طور پیش فرض برای پاسخگویی به نیازهای خود تنظیم کنید. به خاطر داشته باشید که نقاط داده برای یک مکان اغلب در مقایسه با مکان های دیگر مفید هستند.

نمونه نمایش بخش کیفیت هوا

پاسخ کیفیت هوا

{
    "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": …
    }
}
  • از طرف دیگر، می‌توانید داده‌های کیفیت هوا را فقط در تعامل با یک مکان جستجو کنید.

  • می توانید از شاخص 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)

لایه نقشه حرارتی API کیفیت هوا را روی نقشه نمایش دهید

کاشی های رنگی Heatmap یک راه عالی هستند:

  • برای ارائه نمای کلی منطقه بزرگ
  • برای نشان دادن سریع تفاوت های ظریف در آن منطقه.

از Maps JavaScript API با ImateMapType برای نمایش کاشی‌های جداگانه مورد نیاز برای پوشش کل نمای نقشه Google خود استفاده کنید. کاشی‌های Heatmap با درگیری کاربر با نقشه با حرکت، بزرگ‌نمایی یا تغییر مکان، تازه می‌شوند.

به خاطر داشته باشید که مقدار مجاز بزرگنمایی حداکثر تا 16 است.
لایه کاشی نقشه حرارتی Air Quality API ممکن است در جستجوی hyperlocal ناپدید شود.

می‌توانید انواع نقشه‌های حرارتی را در مجموعه محدودی از شاخص‌های کیفیت هوا انتخاب کنید:

  • 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 : 1 نقشه در بارگیری تجربه.
    • API کیفیت هوا :
      • 1 پرس و جو در هر مکان (همه در بارگذاری نقشه یا فقط در انتخاب کاربر).
      • لایه کاشی Heatmap: هر تصویر کاشی 256*256 پیکسل است و برای پوشش یک نقشه استاندارد ارائه شده در یک دستگاه تلفن همراه یا وب، به 12-14 کاشی نیاز دارید. هر کاشی کشیده شده به عنوان 1 واحد SKU محاسبه می شود.
    • Nearby Search (جدید) API : 1 پرس و جو در هر 20 مکان نمایش داده می شود. صورت‌حساب متفاوت با توجه به داده‌های مکان که بخشی از پاسخ پرس و جو هستند.

    نتیجه گیری

    ما نشان دادیم که Air Quality API می‌تواند یک نقطه داده مهم برای کاربران برای تصمیم‌گیری در مورد مکانی برای بازدید باشد. بنابراین، داده‌های کیفیت هوا باید در اولین فرصت ممکن در تجربه جستجو با دقت به مقدار اطلاعات نمایش داده شده در یک زمان و نحوه قابل مشاهده بودن آن قابل مشاهده باشند.

    اقدامات بعدی

    پیشنهاد برای مطالعه بیشتر:

    مشارکت کنندگان

    گوگل این مقاله را حفظ می کند. مشارکت کنندگان زیر در ابتدا آن را نوشتند.
    نویسنده اصلی:

    توماس آنگلرت | مهندس راه حل