מוּדעוּת לאיכות האוויר במקומות באמצעות ממשק ה-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 על סיכות מיקום

  • בוחרים את מדד המיקום: מדד AQI אוניברסלי או מדד AQI מקומי (יש עד 70 מדדי איכות אוויר (AQI) שונים). מדד איכות האוויר (AQI) הוא הסולם שבו מדינה מסוימת, למשל ה-EPA בארה"ב, מסווגת רמות שונות של איכות האוויר, על סמך שיטות חישוב שונות, מקורות נתונים שונים ומטרות ייעודיות שונות.
  • אתם יכולים להתחיל להציג חזותית את הערך הראשי של Air Quality 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": …
    }
}
  • לחלופין, אפשר לשלוח שאילתה לגבי נתוני איכות האוויר רק במהלך אינטראקציה עם מיקום.

  • ניתן להשתמש במדד 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 – לוח צבעים אינדיגו-פרסי לפי מדד איכות האוויר האוניברסלי.
  • 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): גרוע / מעולה

    מספר השאילתות והעלות המשויכת

    • API JavaScript של מפות Google: מפה אחת לטעינה של חוויית המשתמש.
    • Air Quality API:
      • שאילתה אחת לכל מקום (כולן בזמן טעינת המפה או רק בזמן הבחירה של המשתמש).
      • שכבת משבצות של מפת חום: כל תמונה של משבצת היא בגודל 256*256 פיקסלים, וכדי לכסות מפה רגילה שמוצגת במכשיר נייד או באינטרנט צריך 12-14 משבצות. כל אריח שנשלף נספר כיחידה אחת של מק"ט.
    • Nearby Search (New) API: שאילתת חיפוש אחת לכל 20 מקומות שמוצגים. חיוב שונה בהתאם לנתוני המיקום שנכללים בתשובה לשאילתה.

    סיכום

    הגענו למסקנה ש-Air Quality API יכול לשמש כנקודת נתונים חשובה למשתמשים כדי להחליט איפה לבקר. לכן, נתוני איכות האוויר אמורים להיות גלויים בממשק החיפוש בהקדם האפשרי, תוך הקפדה על כמות המידע שמוצגת בו-זמנית ועל האופן שבו הוא מוצג.

    הפעולות הבאות

    מקורות מידע נוספים:

    תורמים

    Google מתחזקת את המאמר הזה. המחברים הבאים כתבו את הספר במקור.
    המחבר הראשי:

    Thomas Anglaret | מהנדס פתרונות