איכות האוויר במקומות

במסמך הזה נסביר איך להשתמש ב-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 כשבוחרים סיכה:

  • המשמעות של מדד איכות אוויר אוניברסלי או מקומי.
  • רמות של חומרים מזהמים, שהן מדד של חלקיקים וגזים באוויר: חומר מזהם דומיננטי, ריכוז, מקורות והשפעות.
  • המלצות בריאותיות, שהן פעולות מומלצות בהתאם לתנאי איכות האוויר הנוכחיים.
  • אתם יכולים לשנות את רמת המידע שמוצגת כברירת מחדל בהתאם לצרכים שלכם. חשוב לזכור שנקודות על הגרף של מיקום מסוים הן בדרך כלל שימושיות בהשוואה למיקומים אחרים.

דוגמה לתצוגה של קטע איכות האוויר

תגובה בנושא איכות האוויר

{
    "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): גרועה / מצוינת

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

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

    סיכום

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

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

    הצעות לקריאה נוספת:

    תורמים

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

    תומאס אנגלרט | מהנדס פתרונות