Package google.maps.airquality.v1

الفهرس

AirQuality

خدمات جودة الهواء

LookupCurrentConditions

rpc LookupCurrentConditions(LookupCurrentConditionsRequest) returns (LookupCurrentConditionsResponse)

توفّر نقطة نهاية "الظروف الحالية" معلومات عن جودة الهواء كل ساعة في أكثر من 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.
LookupHistory

rpc LookupHistory(LookupHistoryRequest) returns (LookupHistoryResponse)

لعرض سجلّ جودة الهواء لموقع جغرافي محدّد وفي نطاق زمني محدّد

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

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

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.

AirQualityIndex

السمة الأساسية لتمثيل مقاييس جودة الهواء المختلفة عند جمع هذه المقاييس معًا، تقدّم نبذة عن ظروف جودة الهواء الحالية. ثمة فهارس متعددة في العالم تخدم أغراضًا مختلفة ومجموعات مهتمة بقياس الجوانب المختلفة لجودة الهواء.

الحقول
code

string

تمثّل هذه السمة رمز الفهرس. يمثل هذا الحقل الفهرس لأغراض البرمجة باستخدام حالة الثعبان بدلاً من المسافات. أمثلة: "uaqi" و"fra_atmo"
display_name

string

تمثّل هذه السمة تمثيلاً يمكن للإنسان قراءته لاسم الفهرس. مثال: "مؤشر جودة الهواء (الولايات المتحدة)"
aqi_display

string

تمثيل نصي للنتيجة الرقمية للفهرس، والذي قد يتضمّن رموز البادئة أو اللاحقة، والتي تمثل عادةً أسوأ درجة فهرس. على سبيل المثال: >100 أو +10.

ملاحظة: يجب استخدام هذا الحقل عندما تريد عرض نتيجة الفهرس. بالنسبة إلى الفهارس غير الرقمية، يكون هذا الحقل فارغًا.
color

Color

اللون المستخدَم لتمثيل النتيجة الرقمية لمؤشر جودة الهواء.
category

string

التصنيف النصي لتفسير الدرجة الرقمية للفهرس. على سبيل المثال: "جودة الهواء ممتازة".
dominant_pollutant

string

تمثّل هذه السمة الرمز الكيميائي للملوّث السائد. على سبيل المثال: "CO".
aqi

int32

هي النتيجة الرقمية للفهرس. أمثلة: 10، 100.

لم يتم تسوية القيمة ويجب تفسيرها فقط في سياق مؤشر جودة الهواء المرتبط بها. بالنسبة إلى الفهارس غير الرقمية، لن يتم عرض هذا الحقل.

ملاحظة: يجب استخدام هذا الحقل لإجراء العمليات الحسابية وعرض الرسم البياني وما إلى ذلك. ولعرض نتيجة الفهرس، يجب استخدام حقل عرض مؤشر جودة الهواء.

ColorPalette

لتحديد لوحة الألوان المستخدَمة للبيانات المقدَّمة من "مؤشر جودة الهواء العالمي" (UAQI). لوحة الألوان هذه مناسبة لـ UAQI فقط، بينما تحتوي مؤشرات جودة الهواء الأخرى على لوحة ألوان محددة مسبقًا لا يمكن التحكم فيها.

عمليات التعداد
COLOR_PALETTE_UNSPECIFIED القيمة التلقائية. يتم تجاهلها في حال تمريرها كمَعلمة.
RED_GREEN لتحديد ما إذا كان يجب استخدام لوحة ألوان حمراء/خضراء
INDIGO_PERSIAN_DARK لتحديد ما إذا كان سيتم استخدام لوحة ألوان نيلية/فارسية (مظهر داكن).
INDIGO_PERSIAN_LIGHT لتحديد ما إذا كان يجب استخدام لوحة ألوان نيلية/فارسية (مظهر فاتح).

CustomLocalAqi

للتعبير عن علاقة "البلد/المنطقة بمؤشر جودة الهواء". يعمل هذا الخيار على إقران بلد أو منطقة بمؤشر جودة الهواء المطلوب ليتم عرض بيانات جودة الهواء المطلوبة لهذا البلد أو المنطقة وفقًا لمؤشر جودة الهواء الذي تم اختياره.

الحقول
region_code

string

تشير هذه السمة إلى البلد أو المنطقة التي تتطلب مؤشر جودة الهواء المخصّص. ويجب تقديم القيمة باستخدام رمز ISO 3166-1 alpha-2.
aqi

string

مؤشر جودة الهواء (AQI) المطلوب ربط البلد أو المنطقة به يجب أن تكون القيمة رمز فهرس صالح.

ExtraComputation

ميزات إضافية يمكن تفعيلها بشكل اختياري. سيؤدي تحديد عمليات حسابية إضافية إلى عرض العناصر والحقول ذات الصلة في الاستجابة.

عمليات التعداد
EXTRA_COMPUTATION_UNSPECIFIED القيمة التلقائية. ويتجاهلها الخادم في حال تمريرها كمَعلمة.
LOCAL_AQI

تحدد ما إذا كان يجب تضمين مؤشر جودة الهواء المحلي (الوطني) في الموقع الجغرافي المطلوب (البلد) في الاستجابة.

في حال تحديد الاستجابة، ستحتوي الاستجابة على بنية بيانات "air_quality_index" مع جميع البيانات ذات الصلة بمؤشر جودة الهواء المحلي الخاص بالموقع الجغرافي.
HEALTH_RECOMMENDATIONS

تحدِّد هذه السمة ما إذا كانت الاستجابة ستتضمّن النصائح الصحية والإجراءات المقترَحة في ما يتعلّق بحالات مؤشر جودة الهواء الحالية.

هذه الاقتراحات مخصّصة للمجتمع الإحصائي العام والفئات الست من السكان المعرّضين للخطر، والذين يعانون حساسية أكبر من الملوّثات مقارنةً بالمجتمع الإحصائي العام.

وفي حال توفّر البيانات ذات الصلة، ستتم تعبئة الحقل health_recommendations في الردّ.
POLLUTANT_ADDITIONAL_INFO

تحدد ما إذا كان يجب تضمين المعلومات الإضافية لكل ملوِّث في الاستجابة.

في حال تحديد كل عنصر من عناصر مؤشر جودة الهواء ومضمَّن في استجابة حقل "المؤشرات"، سيتضمن الحقل حقل additional_info عند توفُّر البيانات.
DOMINANT_POLLUTANT_CONCENTRATION

لتحديد ما إذا كانت الاستجابة ستشمل تركيزات الملوّثات السائدة وفقًا للمؤشرات العالمية و/أو المحلية.

وإذا حدّد الطلب كلاً من مؤشر جودة الهواء العالمي ومؤشر جودة الهواء المحلي، قد يتم عرض ما يصل إلى رمزَين لملوِّثات.

في حال تحديد عنصر الملوّث السائد الوارد في قائمة "الملوّثات"، سيتضمّن الحقل 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

مطلوبة. تمثّل هذه السمة خط الطول وخط العرض الذي تبحث منه واجهة برمجة التطبيقات عن بيانات أحوال جودة الهواء الحالية.
extra_computations[]

ExtraComputation

اختياريّ. ميزات إضافية يمكن تفعيلها بشكل اختياري. سيؤدي تحديد عمليات حسابية إضافية إلى عرض العناصر والحقول ذات الصلة في الاستجابة.
uaqi_color_palette

ColorPalette

اختياريّ. لتحديد لوحة الألوان المستخدَمة للبيانات المقدَّمة من "مؤشر جودة الهواء العالمي" (UAQI). لوحة الألوان هذه مناسبة لـ UAQI فقط، بينما تحتوي مؤشرات جودة الهواء الأخرى على لوحة ألوان محددة مسبقًا لا يمكن التحكم فيها.
custom_local_aqis[]

CustomLocalAqi

اختياريّ. للتعبير عن علاقة "البلد/المنطقة بمؤشر جودة الهواء". يعمل هذا الخيار على إقران بلد أو منطقة بمؤشر جودة الهواء المطلوب ليتم عرض بيانات جودة الهواء المطلوبة لهذا البلد أو المنطقة وفقًا لمؤشر جودة الهواء الذي تم اختياره. يمكن استخدام هذه المَعلمة لتحديد مؤشر جودة الهواء غير تلقائي لبلد معيّن، مثلاً للحصول على مؤشر وكالة حماية البيئة (EPA) في الولايات المتحدة لكندا بدلاً من المؤشر التلقائي لكندا.
universal_aqi

bool

اختياريّ. وفي حال ضبطها على "صحيح"، سيتم تضمين مؤشر جودة الهواء العالمي في حقل "المؤشرات" ضمن الاستجابة. القيمة التلقائية صحيحة.
language_code

string

اختياريّ. السماح للعميل باختيار لغة الردّ إذا تعذّر توفير بيانات لتلك اللغة، ستستخدم واجهة برمجة التطبيقات أقرب تطابق. تعتمد القيم المسموح بها على معيار مجموعة مهندسي شبكة الإنترنت (IETF). القيمة التلقائية هي en.

LookupCurrentConditionsResponse

الحقول
date_time

Timestamp

طابع زمني مقرَّب بتنسيق RFC3339 UTC "Zulu"، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. على سبيل المثال: "2014-10-02T15:00:00Z".
region_code

string

تمثّل هذه السمة رمز ISO_3166-1 alpha-2 للبلد أو المنطقة المتوافق مع الموقع الجغرافي المقدَّم في الطلب. قد يتم حذف هذا الحقل من الرد إذا كان الموقع الجغرافي المقدَّم في الطلب يقع في منطقة متنازع عليها.
indexes[]

AirQualityIndex

استنادًا إلى معلَمات الطلب، ستشمل هذه القائمة (ما يصل إلى) مؤشرَين لجودة الهواء:

  • مؤشر جودة الهواء العالمي سيتمّ عرضها إذا تم ضبط القيمة المنطقية universalAqi على "صحيح".
  • مؤشر جودة الهواء المحلي سيتم إرجاعه في حالة تحديد العملية الحسابية الإضافية LOCAL_AQI.
pollutants[]

Pollutant

قائمة بالملوّثات التي تؤثر في الموقع الجغرافي المحدَّد في الطلب ملاحظة: سيتم عرض هذا الحقل فقط للطلبات التي أدت إلى تحديد عملية واحدة أو أكثر من العمليات الحسابية الإضافية التالية: POLLUTANT_ADDITIONAL_INFO وDOINANT_POLLUTANT_CONCENTRATION وPOLLUTANT_CONCENTRATION.
health_recommendations

HealthRecommendations

النصائح الصحية والإجراءات المقترَحة ذات الصلة بظروف جودة الهواء التي تم الإبلاغ عنها يتم تصميم الاقتراحات بشكل مختلف حسب الفئات المعرّضة للخطر والمجموعات الأكثر حساسية من الملوّثات وعموم السكان.

LookupForecastRequest

عنصر الطلب لواجهة برمجة التطبيقات الخاصة بتوقعات جودة الهواء

الحقول
location

LatLng

مطلوبة. تمثّل هذه السمة خط العرض وخط الطول الذي تبحث عنه واجهة برمجة التطبيقات عن بيانات جودة الهواء.
extra_computations[]

ExtraComputation

اختياريّ. ميزات إضافية يمكن تفعيلها بشكل اختياري. سيؤدي تحديد عمليات حسابية إضافية إلى عرض العناصر والحقول ذات الصلة في الاستجابة.
uaqi_color_palette

ColorPalette

اختياريّ. لتحديد لوحة الألوان المستخدَمة للبيانات المقدَّمة من "مؤشر جودة الهواء العالمي" (UAQI). لوحة الألوان هذه مناسبة لـ UAQI فقط، بينما تحتوي مؤشرات جودة الهواء الأخرى على لوحة ألوان محددة مسبقًا لا يمكن التحكم فيها.
custom_local_aqis[]

CustomLocalAqi

اختياريّ. للتعبير عن علاقة "البلد/المنطقة بمؤشر جودة الهواء". يعمل هذا الخيار على إقران بلد أو منطقة بمؤشر جودة الهواء المطلوب ليتم عرض بيانات جودة الهواء المطلوبة لهذا البلد أو المنطقة وفقًا لمؤشر جودة الهواء الذي تم اختياره. يمكن استخدام هذه المَعلمة لتحديد مؤشر جودة الهواء غير تلقائي لبلد معيّن، مثلاً للحصول على مؤشر وكالة حماية البيئة (EPA) في الولايات المتحدة لكندا بدلاً من المؤشر التلقائي لكندا.
page_size

int32

اختياريّ. الحد الأقصى لعدد سجلات المعلومات التي يمكن عرضها في كل ساعة (العدد التلقائي = 24).
page_token

string

اختياريّ. رمز مميّز للصفحة تم تلقّيه من استدعاء سابق للتوقعات. ويتم استخدامه لاسترداد الصفحة التالية.
حقل الاتحاد time_range النطاق الزمني للبيانات المطلوبة لتوقّعات جودة الهواء يجب أن يكون النطاق ساعة واحدة على الأقل في المستقبل. سيؤدي عدم تحديد هذا الحقل إلى ظهور خطأ POINTS_{9}. يمكن أن يكون الحقل "time_range" واحدًا فقط مما يلي:
date_time

Timestamp

طابع زمني يتم عرض البيانات له عند نقطة زمنية محدّدة. ويتم تقريب الطابع الزمني إلى الساعة السابقة بالضبط.

ملاحظة: سيؤدي ذلك إلى عرض بيانات كل ساعة للطابع الزمني المطلوب فقط (أي عنصر معلومات واحد كل ساعة). على سبيل المثال، سيتم تقريب الطلب الذي تم إرساله حيث تم ضبط المَعلمة date_time على 2023-01-03T11:05:49Z إلى 2023-01-03T11:00:00Z.
period

Interval

يشير إلى فترة البدء والانتهاء التي يمكن الحصول على بيانات التوقّعات بشأنها. ويتم تقريب الطابع الزمني إلى الساعة السابقة بالضبط.
universal_aqi

bool

اختياريّ. وفي حال ضبطها على "صحيح"، سيتم تضمين مؤشر جودة الهواء العام في حقل "الفهارس" بالاستجابة (القيمة التلقائية = صحيح).
language_code

string

اختياريّ. السماح للعميل باختيار لغة الردّ إذا تعذّر توفير بيانات لتلك اللغة، ستستخدم واجهة برمجة التطبيقات أقرب تطابق. تعتمد القيم المسموح بها على معيار مجموعة مهندسي شبكة الإنترنت (IETF) (القيمة التلقائية = 'en').

LookupForecastResponse

عنصر الاستجابة لواجهة برمجة التطبيقات الخاصة بتوقعات جودة الهواء

الحقول
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 "Zulu". على سبيل المثال: "2014-10-02T15:00:00Z".
indexes[]

AirQualityIndex

استنادًا إلى معلَمات الطلب، ستشمل هذه القائمة (ما يصل إلى) مؤشرَين لجودة الهواء:

  • مؤشر جودة الهواء العالمي سيتم عرضها إذا تم ضبط القيمة المنطقية universal_aqi على "صحيح".
  • مؤشر جودة الهواء المحلي سيتم إرجاعه في حالة تحديد العملية الحسابية الإضافية LOCAL_AQI.
pollutants[]

Pollutant

قائمة بالملوّثات التي تؤثر في الموقع الجغرافي المحدَّد في الطلب

ملاحظة: سيتم عرض هذا الحقل فقط للطلبات التي أدت إلى تحديد عملية واحدة أو أكثر من العمليات الحسابية الإضافية التالية: POLLUTANT_ADDITIONAL_INFO وDOINANT_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 من Zoom في 65,536 مربّعًا.

القيم المسموح بها: 0-16
x

int32

مطلوبة. تحدّد النقطة الشرقية والغربية في المربّع المطلوب.
y

int32

مطلوبة. تحدِّد هذه السمة النقطة الشمالية والجنوبية في المربّع المطلوب.

LookupHistoryRequest

عنصر الطلب الخاص بواجهة برمجة التطبيقات لسجلّ جودة الهواء.

الحقول
page_size

int32

اختياريّ. الحد الأقصى لعدد سجلّات المعلومات المعروضة كل ساعة المطلوب عرضها لكل صفحة القيمة التلقائية هي 72، والحد الأقصى للقيمة هو 168 (7 أيام من البيانات).
page_token

string

اختياريّ. رمز مميز للصفحة تم استلامه من مكالمة سابقة في السجلّ. ويتم استخدامه لاسترداد الصفحة التالية.

تجدر الإشارة إلى أنّه عند توفير قيمة لهذه المَعلمة، يجب أن تتطابق جميع المَعلمات الأخرى المقدّمة مع الطلب الذي قدَّم الرمز المميّز للصفحة (الاستدعاء السابق).
location

LatLng

مطلوبة. تمثّل هذه السمة خط العرض وخط الطول الذي تبحث عنه واجهة برمجة التطبيقات عن بيانات سجلّ جودة الهواء.
extra_computations[]

ExtraComputation

اختياريّ. ميزات إضافية يمكن تفعيلها بشكل اختياري. سيؤدي تحديد عمليات حسابية إضافية إلى عرض العناصر والحقول ذات الصلة في الاستجابة.
uaqi_color_palette

ColorPalette

اختياريّ. لتحديد لوحة الألوان المستخدَمة للبيانات المقدَّمة من "مؤشر جودة الهواء العالمي" (UAQI). لوحة الألوان هذه مناسبة لـ UAQI فقط، بينما تحتوي مؤشرات جودة الهواء الأخرى على لوحة ألوان محددة مسبقًا لا يمكن التحكم فيها.
custom_local_aqis[]

CustomLocalAqi

اختياريّ. للتعبير عن علاقة "البلد/المنطقة بمؤشر جودة الهواء". يعمل هذا الخيار على إقران بلد أو منطقة بمؤشر جودة الهواء المطلوب ليتم عرض بيانات جودة الهواء المطلوبة لهذا البلد أو المنطقة وفقًا لمؤشر جودة الهواء الذي تم اختياره. يمكن استخدام هذه المَعلمة لتحديد مؤشر جودة الهواء غير تلقائي لبلد معيّن، مثلاً للحصول على مؤشر وكالة حماية البيئة (EPA) في الولايات المتحدة لكندا بدلاً من المؤشر التلقائي لكندا.
حقل الاتحاد time_range النطاق الزمني لبيانات جودة الهواء المطلوبة سيؤدي عدم تحديد أي حقل ذي صلة بالنطاق الزمني إلى ظهور خطأ POINTS_...[. ويمكن أن يكون النطاق الزمني واحدًا فقط مما يلي: يمكن أن يكون الحقل 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

اختياريّ. وفي حال ضبطها على "صحيح"، سيتم تضمين مؤشر جودة الهواء العالمي في حقل "المؤشرات" ضمن الاستجابة. القيمة التلقائية صحيحة.
language_code

string

اختياريّ. السماح للعميل باختيار لغة الردّ إذا تعذّر توفير بيانات لتلك اللغة، ستستخدم واجهة برمجة التطبيقات أقرب تطابق. تعتمد القيم المسموح بها على معيار مجموعة مهندسي شبكة الإنترنت (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 "Zulu"، مع دقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. على سبيل المثال: "2014-10-02T15:00:00Z".
indexes[]

AirQualityIndex

استنادًا إلى معلَمات الطلب، ستشمل هذه القائمة (ما يصل إلى) مؤشرَين لجودة الهواء:

  • مؤشر جودة الهواء العالمي سيتمّ عرضها إذا تم ضبط القيمة المنطقية universalAqi على "صحيح".
  • مؤشر جودة الهواء المحلي سيتم إرجاعه في حالة تحديد العملية الحسابية الإضافية LOCAL_AQI.
pollutants[]

Pollutant

قائمة بالملوّثات التي تؤثر في الموقع الجغرافي المحدَّد في الطلب ملاحظة: سيتم عرض هذا الحقل فقط للطلبات التي أدت إلى تحديد عملية واحدة أو أكثر من العمليات الحسابية الإضافية التالية: POLLUTANT_ADDITIONAL_INFO وDOINANT_POLLUTANT_CONCENTRATION وPOLLUTANT_CONCENTRATION.
health_recommendations

HealthRecommendations

النصائح الصحية والإجراءات المقترَحة ذات الصلة بظروف جودة الهواء التي تم الإبلاغ عنها يتم تصميم الاقتراحات بشكل مختلف حسب الفئات المعرّضة للخطر والمجموعات الأكثر حساسية من الملوّثات وعموم السكان.

MapType

نوع خريطة التمثيل اللوني لجودة الهواء. تحدد الملوّث الذي ستمثله الخريطة بيانيًا.

عمليات التعداد
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

معلومات إضافية عن الملوّث

AdditionalInfo

مصادر الانبعاثات والآثار الصحية لملوّث معيّن

الحقول
sources

string

نص يمثّل مصادر الانبعاثات الرئيسية للملوّث
effects

string

نص يمثّل الآثار الصحية الرئيسية للملوّث

تركيز المادة

تركيز ملوِّث معيّن في الهواء.

الحقول
units

Unit

وحدات قياس تركيز الملوّث هذا
value

float

قيمة تركيز الملوّثات

الوحدة

تحدِّد هذه السمة الوحدة المستخدَمة لقياس تركيز الملوّث.

عمليات التعداد
UNIT_UNSPECIFIED وحدة تركيز غير محدّدة
PARTS_PER_BILLION وحدة تركيز ppb (أجزاء لكل مليار).
MICROGRAMS_PER_CUBIC_METER وحدة التركيز "ميكروغرام/م^3" (ميكروغرام لكل متر مكعب)