מוּדעוּת לאיכות האוויר במקומות באמצעות ממשק ה-API של איכות האוויר

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

תרחישים לדוגמה וערך מוסף

אותות של Air Quality API יכולים להתאים לחוויות חיפוש שונות, למשל כשמשתמשים מחפשים מיקום לבקר בו. השירות Air Quality API כולל:

  • זמן אמת * ונתונים היסטוריים - נתונים עדכניים ומדויקים שמייצגים את המצב הנוכחי וכן נתוני מעקב בזמן אמת בטווח של 30 יום, ברזולוציה לפי שעה. (* תמונת מצב של איכות האוויר בחוץ לפי שעה)
  • נתונים גלובליים ומקומיים – שכוללים אזורים שלמים ביותר מ-100 מדינות, אבל נתוני איכות האוויר מה-API של איכות האוויר (עד 500 מ') מותאמים לשוק המקומי. הנתונים האלה מספקים אותות חשובים למשתמשים לצורך השוואה ביניהם וקבלת החלטות במקום המתאים ביותר.

איכות האוויר יכולה להשתנות משמעותית גם במיקומים קרובים.

הדרכה מפורטת לדוגמה

הצגת נתוני איכות האוויר בשלב מוקדם של החוויה

יש שתי דרכים עיקריות להציג את נתוני Air Quality API:

הצגת נתוני API של איכות האוויר בסיכות מיקום

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

  • ניתן להשתמש באינדקס של ממשק ה-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:
      • שאילתה אחת על כל מקום (הכול בטעינת המפה או רק בבחירת המשתמש).
      • שכבת משבצת של מפת חום: כל תמונת משבצת היא בגודל 256*256 פיקסלים, וכדי לכסות מפה רגילה שמוצגת במכשיר נייד או באינטרנט, יש צורך ב-12 עד 14 משבצות. כל אריח שנשלף נחשב כיחידת מק"ט אחת.
    • Nearby Search (החדש) API: שאילתה אחת לכל 20 מקומות מוצגים. חיוב שונה בהתאם לנתוני מקום שהם חלק מתגובת השאילתה.

    סיכום

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

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

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

    תורמים

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

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