Package google.maps.airquality.v1

אינדקס

AirQuality

שירותים שקשורים לאיכות האוויר.

LookupCurrentConditions

rpc LookupCurrentConditions(LookupCurrentConditionsRequest) returns (LookupCurrentConditionsResponse)

נקודת הקצה של 'התנאים הנוכחיים' מספקת מידע שעתי על איכות האוויר ביותר מ-100 מדינות, ברזולוציה של עד 500x500 מטר. הדוח כולל יותר מ-70 מדדים מקומיים וקטגוריות ומדד איכות האוויר הגלובלי.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/cloud-platform

למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.
LookupForecast

rpc LookupForecast(LookupForecastRequest) returns (LookupForecastResponse)

מחזירה תחזית של איכות האוויר במיקום ספציפי בטווח זמן נתון.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/cloud-platform

למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.
LookupHeatmapTile

rpc LookupHeatmapTile(LookupHeatmapTileRequest) returns (HttpBody)

מחזירה מערך בייטים שמכיל את הנתונים של תמונת האריח PNG.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/cloud-platform

למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.
LookupHistory

rpc LookupHistory(LookupHistoryRequest) returns (LookupHistoryResponse)

מחזירה את היסטוריית איכות האוויר במיקום ספציפי בטווח זמן נתון.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/cloud-platform

למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.

AirQualityIndex

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

שדות
code

string

קוד האינדקס. השדה הזה מייצג את האינדקס למטרות תכנות באמצעות שימוש באותיות snake במקום ברווחים. דוגמאות: 'uaqi', 'fra_atmo'.
display_name

string

ייצוג קריא (לבני אדם) של שם האינדקס. דוגמה: "AQI (US)"
aqi_display

string

ייצוג טקסטואלי של הציון המספרי של האינדקס, שעשוי לכלול סמלי קידומת או סיומת, שמייצגים בדרך כלל את ציון האינדקס הגרוע ביותר. דוגמה: >100 או 10+.

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

Color

הצבע שמשמש לייצוג הציון המספרי של ה-AQI.
category

string

סיווג טקסטואלי של פרשנות הציון המספרי של האינדקס. לדוגמה: 'איכות אוויר מעולה'.
dominant_pollutant

string

הסמל הכימי של המזהם הדומיננטי. לדוגמה: CO.
aqi

int32

הציון המספרי של האינדקס. דוגמאות: 10, 100.

הערך לא מנורמל ויש לפרש אותו רק בהקשר של מדד איכות האוויר הקשור אליו. אם מדובר באינדקסים לא מספריים, השדה הזה לא יוחזר.

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

ColorPalette

ההגדרה הזו קובעת את לוח הצבעים של הנתונים שמתקבלים ממדד איכות האוויר האוניברסלי (UAQI). לוח הצבעים הזה רלוונטי רק ל-UAQI, ל-AQI אחרים יש לוח צבעים קבוע מראש שאי אפשר לשלוט בו.

טיפוסים בני מנייה (enums)
COLOR_PALETTE_UNSPECIFIED ערך ברירת המחדל. המערכת מתעלמת מהפריט אם הוא מועבר כפרמטר.
RED_GREEN המדיניות הזו קובעת אם להשתמש בלוח צבעים אדום/ירוק.
INDIGO_PERSIAN_DARK המדיניות הזו קובעת אם להשתמש בלוח אינדיגו/פרסי (עיצוב כהה).
INDIGO_PERSIAN_LIGHT קובעת אם להשתמש בלוח אינדיגו/פרסי (עיצוב בהיר).

CustomLocalAqi

מבטא את הקשר 'מדינה/אזור ל-AQI'. התאמה של מדינה/אזור עם AQI רצוי כדי שנתוני איכות האוויר הנדרשים למדינה או לאזור האלה יוצגו בהתאם ל-AQI שנבחר.

שדות
region_code

string

המדינה/האזור שמחייבים את ה-AQI המותאם אישית. יש לציין את הערך באמצעות קוד ISO 3166-1 alpha-2.
aqi

string

ה-AQI שאליו יש לשייך את המדינה/האזור. הערך צריך להיות קוד אינדקס תקין.

ExtraComputation

תכונות נוספות שאפשר להפעיל. ציון חישובים נוספים יגרום להחזרת הרכיבים והשדות הרלוונטיים בתגובה.

טיפוסים בני מנייה (enums)
EXTRA_COMPUTATION_UNSPECIFIED ערך ברירת המחדל. השרת מתעלם ממנו אם הוא מועבר כפרמטר.
LOCAL_AQI

קובעת אם לכלול בתשובה את ה-AQI המקומי (הלאומי) של המיקום המבוקש (מדינה).

אם צוינה בקשה, התשובה תכיל את מבנה הנתונים 'air_quality_index' עם כל הנתונים הרלוונטיים במדד AQI המקומי של המיקום.
HEALTH_RECOMMENDATIONS

ההגדרה קובעת אם התשובה תכלול את הייעוץ הרפואי ואת הפעולות המומלצות למצבים הנוכחיים של AQI.

ההמלצות מותאמות לאוכלוסייה הכללית ולשש אוכלוסיות בסיכון עם רגישות גבוהה יותר למזהמים מאשר לאוכלוסייה הכללית.

אם צוין, השדה health_recommendations יאוכלס בתשובה כשהנתונים הרלוונטיים יהיו זמינים.
POLLUTANT_ADDITIONAL_INFO

קובעת אם לכלול בתגובה את המידע הנוסף על כל חומר מזהם.

אם צוין אחרת, כל אובייקט של מדד איכות אוויר שכלול בתגובה לשדה 'אינדקסים' יכלול שדה additional_info כשהנתונים יהיו זמינים.
DOMINANT_POLLUTANT_CONCENTRATION

קובעת אם התגובה תכלול את הריכוזים של המזהמים הדומיננטיים שנמדדים לפי מדדים גלובליים ו/או מקומיים.

אם בבקשה צוינו ה-AQI הגלובלי וגם את ה-AQI המקומי, ייתכן שיוחזרו עד שני קודים של מזהמים.

אם מציינים את הפרמטר המזהם הדומיננטי ברשימת 'המזהמים', הוא יכלול את השדה concentration כשהנתונים יהיו זמינים.
POLLUTANT_CONCENTRATION

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

אם צוין אחרת, כל אובייקט מזהם שנכלל בשדה 'חומרים מזהמים' בתגובה יכלול את השדה concentration כשהנתונים יהיו זמינים.

HealthRecommendations

המלצות בנושא בריאות לקבוצות אוכלוסייה שונות בפורמט טקסט חופשי. ההמלצות נגזרות מתנאי איכות האוויר המשויכים אליהן.

שדות
general_population

string

אין רגישויות ספציפיות.
elderly

string

גמלאים ואנשים מבוגרים יותר מהאוכלוסייה הכללית.
lung_disease_population

string

בעיות נשימה הקשורות לאסתמה.
heart_disease_population

string

מחלות לב ומערכת הדם.
athletes

string

פעילויות ספורט ופעילויות מאומצות אחרות בחוץ.
pregnant_women

string

נשים בכל שלבי ההיריון.
children

string

אוכלוסיות צעירות יותר, כולל ילדים, פעוטות ותינוקות.

LookupCurrentConditionsRequest

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

שדות
location

LatLng

חובה. קווי האורך והרוחב שמהם ה-API מחפש נתונים על התנאים הנוכחיים של איכות האוויר.
extra_computations[]

ExtraComputation

זה שינוי אופציונלי. תכונות נוספות שאפשר להפעיל. ציון חישובים נוספים יגרום להחזרת הרכיבים והשדות הרלוונטיים בתגובה.
uaqi_color_palette

ColorPalette

זה שינוי אופציונלי. ההגדרה הזו קובעת את לוח הצבעים של הנתונים שמצוינים ב 'מדד איכות האוויר האוניברסלי' (UAQI). לוח הצבעים הזה רלוונטי רק ל-UAQI, ל-AQI אחרים יש לוח צבעים קבוע מראש שאי אפשר לשלוט בו.
custom_local_aqis[]

CustomLocalAqi

זה שינוי אופציונלי. מבטא את הקשר 'מדינה/אזור ל-AQI'. התאמה של מדינה/אזור עם AQI רצוי כדי שנתוני איכות האוויר הנדרשים למדינה או לאזור האלה יוצגו בהתאם ל-AQI שנבחר. אפשר להשתמש בפרמטר הזה כדי לציין AQI שלא מוגדר כברירת מחדל עבור מדינה מסוימת. לדוגמה, כדי לקבל את מדד EPA של קנדה במקום את אינדקס ברירת המחדל עבור קנדה.
universal_aqi

bool

זה שינוי אופציונלי. אם המדיניות מוגדרת כ-True, ה-AQI האוניברסלי ייכלל בשדה 'אינדקסים' של התשובה. ערך ברירת המחדל הוא True.
language_code

string

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

LookupCurrentConditionsResponse

שדות
date_time

Timestamp

חותמת זמן מעוגלת למטה בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. לדוגמה: 2014-10-02T15:00:00Z.
region_code

string

קוד ISO_3166-1 alpha-2 של המדינה/האזור התואמים למיקום שצוין בבקשה. יכול להיות שהשדה הזה יושמט מהתשובה אם המיקום שצוין בבקשה נמצא באזור מחלוקת.
indexes[]

AirQualityIndex

רשימה זו תכלול (עד) שני מדדים של איכות האוויר, על סמך הפרמטרים של הבקשות:

  • AQI אוניברסלי. הפונקציה תוחזר אם הערך הבוליאני universalAqi מוגדר כ-true.
  • AQI מקומי. הפונקציה תוחזר אם צוין החישוב הנוסף LOCAL_AQI.
pollutants[]

Pollutant

רשימה של מזהמים שמשפיעים על המיקום שצוין בבקשה. הערה: השדה הזה יוחזר רק עבור בקשות שצוינו אחד או יותר מהחישובים הנוספים הבאים: POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION.
health_recommendations

HealthRecommendations

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

LookupForecastRequest

אובייקט הבקשה של ממשק ה-API של תחזית איכות האוויר.

שדות
location

LatLng

חובה. קווי האורך והרוחב שעבורם מתבצע חיפוש של נתוני איכות האוויר על ידי ה-API.
extra_computations[]

ExtraComputation

זה שינוי אופציונלי. תכונות נוספות שאפשר להפעיל. ציון חישובים נוספים יגרום להחזרת הרכיבים והשדות הרלוונטיים בתגובה.
uaqi_color_palette

ColorPalette

זה שינוי אופציונלי. ההגדרה הזו קובעת את לוח הצבעים של הנתונים שמצוינים ב 'מדד איכות האוויר האוניברסלי' (UAQI). לוח הצבעים הזה רלוונטי רק ל-UAQI, ל-AQI אחרים יש לוח צבעים קבוע מראש שאי אפשר לשלוט בו.
custom_local_aqis[]

CustomLocalAqi

זה שינוי אופציונלי. מבטא את הקשר 'מדינה/אזור ל-AQI'. התאמה של מדינה/אזור עם AQI רצוי כדי שנתוני איכות האוויר הנדרשים למדינה או לאזור האלה יוצגו בהתאם ל-AQI שנבחר. אפשר להשתמש בפרמטר הזה כדי לציין AQI שלא מוגדר כברירת מחדל עבור מדינה מסוימת. לדוגמה, כדי לקבל את מדד EPA של קנדה במקום את אינדקס ברירת המחדל עבור קנדה.
page_size

int32

זה שינוי אופציונלי. המספר המרבי של רשומות מידע שעתיות שיש להחזיר בכל דף (ברירת מחדל = 24).
page_token

string

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

Timestamp

חותמת זמן שעבורה יש להחזיר את הנתונים עבור נקודת זמן ספציפית. חותמת הזמן מעוגלת לשעה הקודמת בדיוק.

הערה: הפעולה הזו תחזיר נתונים שעתיים עבור חותמת הזמן המבוקשת בלבד (כלומר, רכיב מידע אחד לפי שעה). לדוגמה, בקשה שנשלחת שבה הפרמטר date_time מוגדר כ-2023-01-03T11:05:49Z תעוגל כלפי מטה ל-2023-01-03T11:00:00Z.
period

Interval

מציין את תקופת ההתחלה והסיום שלגביה רוצים לקבל את נתוני התחזית. חותמת הזמן מעוגלת לשעה הקודמת בדיוק.
universal_aqi

bool

זה שינוי אופציונלי. אם היא מוגדרת כ-True, ה-AQI האוניברסלי ייכלל בשדה 'indexes' של התשובה (ברירת המחדל = true).
language_code

string

זה שינוי אופציונלי. מאפשר ללקוח לבחור את השפה לתגובה. אם לא ניתן לספק נתונים לשפה הזו, ה-API ישתמש בהתאמה הקרובה ביותר. הערכים המותרים מבוססים על תקן IETF (ברירת המחדל היא 'en').

LookupForecastResponse

אובייקט התגובה של ממשק ה-API של תחזית איכות האוויר.

שדות
hourly_forecasts[]

HourlyForecast

זה שינוי אופציונלי. מכילה את המידע על איכות האוויר לכל שעה בטווח המבוקש. לדוגמה, אם הבקשה היא לתחזית של 48 שעות, יהיו 48 רכיבים של תחזיות לפי שעה.
region_code

string

זה שינוי אופציונלי. קוד ISO_3166-1 alpha-2 של המדינה/האזור התואמים למיקום שצוין בבקשה. יכול להיות שהשדה הזה יושמט מהתשובה אם המיקום שצוין בבקשה נמצא באזור מחלוקת.
next_page_token

string

זה שינוי אופציונלי. האסימון לאחזור הדף הבא.

HourlyForecast

מכילה את המידע על איכות האוויר לכל שעה בטווח המבוקש. לדוגמה, אם הבקשה היא לתחזית של 48 שעות, יהיו 48 רכיבים של תחזיות לפי שעה.

שדות
date_time

Timestamp

חותמת זמן מעוגלת כלפי מטה, שמציינת את השעה (שעה) שאליה הנתונים מתייחסים בפורמט 'זולו' RFC3339 UTC. לדוגמה: 2014-10-02T15:00:00Z.
indexes[]

AirQualityIndex

רשימה זו תכלול (עד) שני מדדים של איכות האוויר, על סמך הפרמטרים של הבקשות:

  • AQI אוניברסלי. הפונקציה תחזיר אם הערך הבוליאני universal_aqi יוגדר כ-true.
  • AQI מקומי. הפונקציה תוחזר אם צוין החישוב הנוסף LOCAL_AQI.
pollutants[]

Pollutant

רשימה של מזהמים שמשפיעים על המיקום שצוין בבקשה.

הערה: השדה הזה יוחזר רק עבור בקשות שצוינו אחד או יותר מהחישובים הנוספים הבאים: POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION.
health_recommendations

HealthRecommendations

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

LookupHeatmapTileRequest

בקשה לאריח מפת חום.

המבנה תואם לקריאת ה-GET הרגילה של שרת המשבצות, כלומר, https://airquality.googleapis.com/v1/mapTypes/{map_type}/heatmapTiles/{zoom}/{x}/{y}

דוגמה: https://airquality.googleapis.com/v1/mapTypes/BAQI_INDIGO_PERSIAN/heatmapTiles/1/1/1

שדות
map_type

MapType

חובה. סוג מפת החום של איכות האוויר. מגדיר את המזהם שהמפה תייצג באופן גרפי.

Allowed values:
- UAQI_RED_GREEN (UAQI, red-green palette)
- UAQI_INDIGO_PERSIAN (UAQI, indigo-persian palette)
- PM25_INDIGO_PERSIAN
- GBR_DEFRA
- DEU_UBA
- CAN_EC
- FRA_ATMO
- US_AQI
zoom

int32

חובה. המרחק מהתצוגה של המפה. מגדיר את הגודל או הקטן של התוכן של מפה בתצוגת מפה.

רמת מרחק מתצוגה 0 מייצגת את העולם כולו במשבצת אחת. רמה 1 של מרחק התצוגה מייצגת את העולם כולו ב-4 משבצות. רמה 2 של מרחק התצוגה מייצגת את העולם כולו ב-16 אריחים. רמת זום 16 מציגה את העולם כולו ב-65,536 אריחים.

ערכים מותרים: 0-16
x

int32

חובה. מגדיר את הנקודה המזרחית-מערבית באריח המבוקש.
y

int32

חובה. מגדיר את הנקודה מצפון-דרום באריח המבוקש.

LookupHistoryRequest

אובייקט הבקשה של ממשק ה-API של היסטוריית איכות האוויר.

שדות
page_size

int32

זה שינוי אופציונלי. המספר המקסימלי של רשומות מידע שעתיות שיש להחזיר בכל דף. ברירת המחדל היא 72 והערך המקסימלי הוא 168 (נתונים של 7 ימים).
page_token

string

זה שינוי אופציונלי. אסימון דף שהתקבל משיחה קודמת בנושא היסטוריה. הוא משמש לאחזור הדף הבא.

שימו לב שכאשר מזינים ערך לפרמטר הזה, כל שאר הפרמטרים חייבים להתאים לקריאה שסיפקה את אסימון הדף (הקריאה הקודמת).
location

LatLng

חובה. קווי האורך והרוחב שעבורם ה-API מחפש נתונים היסטוריים של איכות האוויר.
extra_computations[]

ExtraComputation

זה שינוי אופציונלי. תכונות נוספות שאפשר להפעיל. ציון חישובים נוספים יגרום להחזרת הרכיבים והשדות הרלוונטיים בתגובה.
uaqi_color_palette

ColorPalette

זה שינוי אופציונלי. ההגדרה הזו קובעת את לוח הצבעים של הנתונים שמצוינים ב 'מדד איכות האוויר האוניברסלי' (UAQI). לוח הצבעים הזה רלוונטי רק ל-UAQI, ל-AQI אחרים יש לוח צבעים קבוע מראש שאי אפשר לשלוט בו.
custom_local_aqis[]

CustomLocalAqi

זה שינוי אופציונלי. מבטא את הקשר 'מדינה/אזור ל-AQI'. התאמה של מדינה/אזור עם AQI רצוי כדי שנתוני איכות האוויר הנדרשים למדינה או לאזור האלה יוצגו בהתאם ל-AQI שנבחר. אפשר להשתמש בפרמטר הזה כדי לציין AQI שלא מוגדר כברירת מחדל עבור מדינה מסוימת. לדוגמה, כדי לקבל את מדד EPA של קנדה במקום את אינדקס ברירת המחדל עבור קנדה.
שדה איחוד time_range. טווח הזמן של נתוני איכות האוויר הנדרשים. אם לא מציינים שדה הקשור לטווח זמן כלשהו, תתקבל שגיאת INVALID_ARGUMENT. time_range יכול להיות רק אחת מהאפשרויות הבאות: time_range יכול להיות רק אחד מהבאים:
date_time

Timestamp

חותמת זמן שעבורה יש להחזיר נתונים היסטוריים. חותמת הזמן מעוגלת לשעה הקודמת בדיוק.

הערה: הפעולה הזו תחזיר נתונים שעתיים עבור חותמת הזמן המבוקשת בלבד (כלומר, רכיב מידע אחד לפי שעה). לדוגמה, בקשה שנשלחת שבה הפרמטר dateTime מוגדר כ-2023-01-03T11:05:49Z תעוגל למטה ל-2023-01-03T11:00:00Z.

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: 2014-10-02T15:01:23Z ו-2014-10-02T15:01:23.045123456Z.
hours

int32

מספר בין 1 ל-720 שמציין את טווח השעות של הבקשה. לדוגמה: ערך של 48 יניב נתונים מ-48 השעות האחרונות.
period

Interval

ציון תקופת ההתחלה והסיום שלגביה רוצים לקבל את הנתונים ההיסטוריים. חותמת הזמן מעוגלת לשעה הקודמת בדיוק.
universal_aqi

bool

זה שינוי אופציונלי. אם המדיניות מוגדרת כ-True, ה-AQI האוניברסלי ייכלל בשדה 'אינדקסים' של התשובה. ערך ברירת המחדל הוא True.
language_code

string

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

LookupHistoryResponse

שדות
hours_info[]

HourInfo

זה שינוי אופציונלי. מכילה את המידע על איכות האוויר לכל שעה בטווח המבוקש. לדוגמה, אם הבקשה היא היסטוריה של 48 שעות, יופיעו 48 רכיבים של מידע שעתי.
region_code

string

זה שינוי אופציונלי. קוד ISO_3166-1 alpha-2 של המדינה/האזור התואמים למיקום שצוין בבקשה. יכול להיות שהשדה הזה יושמט מהתשובה אם המיקום שצוין בבקשה נמצא באזור מחלוקת.
next_page_token

string

זה שינוי אופציונלי. האסימון לאחזור הדף הבא.

HourInfo

מכילה את המידע על איכות האוויר לכל שעה בטווח המבוקש. לדוגמה, אם הבקשה היא היסטוריה של 48 שעות, יופיעו 48 רכיבים של מידע שעתי.

שדות
date_time

Timestamp

חותמת זמן מעוגלת למטה שמציינת את השעה שאליה מתייחסים הנתונים בפורמט "זולו" RFC3339 UTC, עם רזולוציית ננו-שנייה ועד תשע ספרות עשרוניות. לדוגמה: 2014-10-02T15:00:00Z.
indexes[]

AirQualityIndex

רשימה זו תכלול (עד) שני מדדים של איכות האוויר, על סמך הפרמטרים של הבקשות:

  • AQI אוניברסלי. הפונקציה תוחזר אם הערך הבוליאני universalAqi מוגדר כ-true.
  • AQI מקומי. הפונקציה תוחזר אם צוין החישוב הנוסף LOCAL_AQI.
pollutants[]

Pollutant

רשימה של מזהמים שמשפיעים על המיקום שצוין בבקשה. הערה: השדה הזה יוחזר רק עבור בקשות שצוינו אחד או יותר מהחישובים הנוספים הבאים: POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION.
health_recommendations

HealthRecommendations

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

MapType

סוג מפת החום של איכות האוויר. מגדיר את המזהם שהמפה תייצג באופן גרפי.

טיפוסים בני מנייה (enums)
MAP_TYPE_UNSPECIFIED ערך ברירת המחדל. השרת מתעלם ממנו אם הוא מועבר כפרמטר.
UAQI_RED_GREEN לוח (אדום-ירוק) של מדד איכות האוויר האוניברסלי.
UAQI_INDIGO_PERSIAN מדד איכות האוויר האוניברסלי (Universal Air Quality Index) בצבע אינדיגו-פרסי.
PM25_INDIGO_PERSIAN מדד PM2.5 לוח צבעים אינדיגו-פרסי.
GBR_DEFRA לוח הצבעים של מדד איכות האוויר היומי (בריטניה).
DEU_UBA לוח הצבעים של מדד איכות האוויר המקומי בגרמניה.
CAN_EC לוח הצבעים של מדד איכות האוויר הקנדי.
FRA_ATMO לוח הצבעים של מדד איכות האוויר בצרפת.
US_AQI לוח הצבעים של מדד איכות האוויר בארה"ב.

חומר מזהם

נתונים לגבי מזהם איכות האוויר.

שדות
code

string

שם הקוד של המזהם. לדוגמה: "so2". כאן אפשר למצוא רשימה של כל הקודים הזמינים.
display_name

string

השם המוצג של המזהם. לדוגמה: NOx.
full_name

string

השם המלא של המזהם. לתרכובות כימיות, זהו השם של IUPAC. דוגמה: "גופרית דו-חמצנית".

מידע נוסף על טבלת השמות של IUPAC זמין בכתובת https://iupac.org/what-we-do/periodic-table-of-elements/
concentration

Concentration

רמת הריכוז של המזהם נמדדת באמצעות אחת מיחידות המדידה הסטנדרטיות של זיהום האוויר.
additional_info

AdditionalInfo

מידע נוסף על המזהם

AdditionalInfo

מקורות הפליטה וההשפעות הבריאותיות של מזהם נתון.

שדות
sources

string

טקסט שמייצג את מקורות הפליטה העיקריים של המזהמים.
effects

string

טקסט שמייצג את ההשפעות הבריאותיות העיקריות של המזהם.

ריכוז

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

שדות
units

Unit

יחידות למדידת ריכוז המזהמים הזה.
value

float

הערך של ריכוז המזהמים.

יחידה

מגדיר את היחידה שמשמשת למדידת ריכוז המזהמים.

טיפוסים בני מנייה (enums)
UNIT_UNSPECIFIED יחידת ריכוז לא מוגדרת.
PARTS_PER_BILLION יחידת הריכוז ppb (חלקים למיליארד).
MICROGRAMS_PER_CUBIC_METER יחידת הריכוז "μg/m^3" (מיקרוגרמים למטר מעוקב).