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

  • בוחרים את המדד למיקום שלכם: מדד AQI אוניברסלי או מדד AQI מקומי (יש עד 70 מדדים שונים של איכות האוויר (AQI)). מדד איכות האוויר (AQI) הוא סולם שבאמצעותו מדינה מסוימת, למשל הסוכנות להגנת הסביבה בארה"ב (EPA), מסווגת רמות שונות של איכות האוויר, על סמך שיטות חישוב שונות, מקורות נתונים שונים ומטרות ייעודיות שונות.
  • התחלנו להציג את הערך העיקרי של Air Quality API ואת קוד הצבע שלו ישירות מתוך חוויית החיפוש של מקומות.

תצוגת ברירת המחדל יכולה לכלול רק את קוד הצבע.


הצגת מידע נוסף על Air Quality API כשבוחרים סיכה:

  • המשמעות של מדד איכות האוויר (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 - Universal Air Quality Index indigo-persian palette.
  • PM25_INDIGO_PERSIAN - PM2.5 index indigo-persian palette.
  • 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:
      • שאילתה אחת לכל מקום (הכל בטעינת המפה או רק בבחירת המשתמש).
      • שכבת משבצות של מפת חום: כל תמונה של משבצת היא בגודל ‎256*256px, וכדי לכסות מפה רגילה שמוצגת במכשיר נייד או באינטרנט צריך 12-14 משבצות. כל אריח שנשלף נספר כיחידת מק"ט אחת.
    • ‫Nearby Search (New) API: שאילתה אחת לכל 20 מקומות שמוצגים. חיוב שונה בהתאם לנתוני המקום שכלולים בתשובת השאילתה.

    סיכום

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

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

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

    תורמים

    Google היא זו שכותבת את המאמר הזה. הוא נכתב במקור על ידי התורמים הבאים.
    המחבר הראשי:

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