Package google.maps.airquality.v1

فهرست مطالب

کیفیت هوا

خدمات کیفیت هوا

LookupCurrentConditions

rpc LookupCurrentConditions( LookupCurrentConditionsRequest ) returns ( LookupCurrentConditionsResponse )

نقطه پایانی Current Conditions اطلاعات ساعتی کیفیت هوا را در بیش از 100 کشور تا وضوح 500×500 متر ارائه می دهد. شامل بیش از 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 مراجعه کنید.

تاریخچه جستجو

rpc LookupHistory( LookupHistoryRequest ) returns ( LookupHistoryResponse )

تاریخچه کیفیت هوا را برای یک مکان خاص برای یک محدوده زمانی معین برمی گرداند.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

شاخص کیفیت هوا

هدف اصلی برای نمایش معیارهای مختلف کیفیت هوا. هنگامی که این معیارها گرد هم می آیند، تصویری فوری از شرایط فعلی کیفیت هوا ارائه می دهند. شاخص های متعددی در جهان وجود دارد که به اهداف و گروه های مختلف علاقه مند به اندازه گیری جنبه های مختلف کیفیت هوا هستند.

زمینه های
code

string

کد ایندکس این فیلد با استفاده از snake case به جای فاصله، نمایه را برای اهداف برنامه نویسی نشان می دهد. مثال: "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 استفاده کنید.

پالت رنگ

پالت رنگ مورد استفاده برای داده های ارائه شده توسط "شاخص کیفیت هوای جهانی" (UAQI) را تعیین می کند. این پالت رنگ فقط برای UAQI مرتبط است، سایر AQIها یک پالت رنگی از پیش تعیین شده دارند که قابل کنترل نیست.

Enums
COLOR_PALETTE_UNSPECIFIED مقدار پیش فرض اگر به عنوان پارامتر ارسال شود نادیده گرفته می شود.
RED_GREEN تعیین می کند که آیا از پالت قرمز/سبز استفاده شود یا خیر.
INDIGO_PERSIAN_DARK تعیین می کند که آیا از پالت نیلی/فارسی (تم تیره) استفاده شود یا خیر.
INDIGO_PERSIAN_LIGHT تعیین می کند که آیا از پالت نیلی/فارسی (موضوع روشن) استفاده شود یا خیر.

CustomLocalAqi

بیانگر رابطه "کشور/منطقه به AQI". یک کشور/منطقه را با یک AQI دلخواه جفت می‌کند تا داده‌های کیفیت هوای مورد نیاز آن کشور/منطقه مطابق با AQI انتخابی نمایش داده شود.

زمینه های
region_code

string

کشور/منطقه ای که به AQI سفارشی نیاز دارد. مقدار باید با استفاده از کد آلفا-2 ISO 3166-1 ارائه شود.

aqi

string

AQI برای مرتبط کردن کشور/منطقه. مقدار باید یک کد شاخص معتبر باشد.

محاسبات اضافی

ویژگی های اضافی که می توانند به صورت اختیاری فعال شوند. تعیین محاسبات اضافی منجر به بازگشت عناصر و فیلدهای مربوطه در پاسخ می شود.

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 را شامل می شود.

توصیه های بهداشتی

توصیه های بهداشتی برای گروه های مختلف جمعیتی در قالب متن آزاد. این توصیه‌ها از شرایط کیفی هوا ناشی می‌شوند.

زمینه های
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 جهانی در قسمت «شاخص‌ها» پاسخ گنجانده می‌شود. مقدار پیش فرض درست است.

language_code

string

اختیاری. به مشتری امکان می دهد زبان پاسخ را انتخاب کند. اگر داده‌ای برای آن زبان ارائه نشود، API از نزدیک‌ترین تطابق استفاده می‌کند. مقادیر مجاز بر اساس استاندارد IETF است. مقدار پیش فرض en است.

LookupCurrentConditionsResponse

زمینه های
date_time

Timestamp

مهر زمانی گرد شده در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. به عنوان مثال: "2014-10-02T15:00:00Z".

region_code

string

کد ISO_3166-1 آلفا-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

اختیاری. اگر روی درست تنظیم شود، AQI جهانی در قسمت «شاخص‌ها» پاسخ (پیش‌فرض = درست) گنجانده می‌شود.

language_code

string

اختیاری. به مشتری امکان می دهد زبان پاسخ را انتخاب کند. اگر داده‌ای برای آن زبان ارائه نشود، API از نزدیک‌ترین تطابق استفاده می‌کند. مقادیر مجاز به استاندارد IETF (پیش‌فرض = 'en') متکی هستند.

LookupForecastResponse

هدف پاسخ API پیش‌بینی کیفیت هوا.

زمینه های
hourly_forecasts[]

HourlyForecast

اختیاری. حاوی اطلاعات کیفیت هوا برای هر ساعت در محدوده درخواستی است. به عنوان مثال، اگر درخواست 48 ساعت پیش بینی باشد، 48 عنصر پیش بینی ساعتی وجود خواهد داشت.

region_code

string

اختیاری. کد ISO_3166-1 آلفا-2 کشور/منطقه مربوط به مکان ارائه شده در درخواست. اگر مکان ارائه شده در درخواست در یک منطقه مورد مناقشه قرار داشته باشد، ممکن است این قسمت از پاسخ حذف شود.

next_page_token

string

اختیاری. نشانه برای بازیابی صفحه بعدی.

پیش بینی ساعتی

حاوی اطلاعات کیفیت هوا برای هر ساعت در محدوده درخواستی است. به عنوان مثال، اگر درخواست 48 ساعت پیش بینی باشد، 48 عنصر پیش بینی ساعتی وجود خواهد داشت.

زمینه های
date_time

Timestamp

یک مهر زمانی گرد شده که زمان (ساعت) مورد اشاره داده ها را در قالب RFC3339 UTC "Zulu" نشان می دهد. به عنوان مثال: "2014-10-02T15:00:00Z".

indexes[]

AirQualityIndex

بر اساس پارامترهای درخواست، این لیست شامل (تا) دو شاخص کیفیت هوا خواهد بود:

  • جهانی AQI. اگر universal_aqi boolean روی 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 کل جهان در 65536 کاشی است.

مقادیر مجاز: 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 "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z".

hours

int32

عدد از 1 تا 720 که محدوده ساعات درخواست را نشان می دهد. به عنوان مثال: مقدار 48 داده های 48 ساعت گذشته را به دست می دهد.

period

Interval

دوره شروع و پایانی را نشان می دهد که داده های تاریخی برای آن بدست می آید. مهر زمانی به ساعت دقیق قبلی گرد می شود.

universal_aqi

bool

اختیاری. اگر روی true تنظیم شود، AQI جهانی در قسمت «شاخص‌ها» پاسخ گنجانده می‌شود. مقدار پیش فرض درست است.

language_code

string

اختیاری. به مشتری امکان می دهد زبان پاسخ را انتخاب کند. اگر داده‌ای برای آن زبان ارائه نشود، API از نزدیک‌ترین تطابق استفاده می‌کند. مقادیر مجاز بر اساس استاندارد IETF است. مقدار پیش فرض en است.

LookupHistoryResponse

زمینه های
hours_info[]

HourInfo

اختیاری. حاوی اطلاعات کیفیت هوا برای هر ساعت در محدوده درخواستی است. به عنوان مثال، اگر درخواست برای 48 ساعت سابقه باشد، 48 عنصر اطلاعات ساعتی وجود خواهد داشت.

region_code

string

اختیاری. کد ISO_3166-1 آلفا-2 کشور/منطقه مربوط به مکان ارائه شده در درخواست. اگر مکان ارائه شده در درخواست در یک منطقه مورد مناقشه قرار داشته باشد، ممکن است این قسمت از پاسخ حذف شود.

next_page_token

string

اختیاری. نشانه برای بازیابی صفحه بعدی.

اطلاعات ساعت

حاوی اطلاعات کیفیت هوا برای هر ساعت در محدوده درخواستی است. به عنوان مثال، اگر درخواست برای 48 ساعت سابقه باشد، 48 عنصر اطلاعات ساعتی وجود خواهد داشت.

زمینه های
date_time

Timestamp

یک مهر زمانی گرد شده که نشان‌دهنده زمان ارجاع داده‌ها در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری است. به عنوان مثال: "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 پالت نیلی-پرشین شاخص جهانی کیفیت هوا.
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

اطلاعات تکمیلی در مورد آلاینده

اطلاعات اضافی

منابع انتشار و اثرات سلامتی یک آلاینده معین

زمینه های
sources

string

متنی که منابع اصلی انتشار آلاینده را نشان می دهد.

effects

string

متنی که نشان دهنده اثرات اصلی آلاینده بر سلامتی است.

تمرکز

غلظت یک آلاینده معین در هوا.

زمینه های
units

Unit

واحدهای اندازه گیری غلظت این آلاینده.

value

float

ارزش غلظت آلاینده

واحد

واحد مورد استفاده برای اندازه گیری غلظت آلاینده را تعریف می کند.

Enums
UNIT_UNSPECIFIED واحد غلظت نامشخص
PARTS_PER_BILLION واحد غلظت ppb (قسمت در میلیارد).
MICROGRAMS_PER_CUBIC_METER واحد غلظت "μg/m^3" (میکروگرم بر متر مکعب).