الأحوال الجوية الحالية

توفّر نقطة نهاية currentConditions معلومات حالية عن جودة الهواء كل ساعة. يمكنك تحديد مؤشرات جودة الهواء والمعلومات ذات الصلة التي يتم عرضها (مثلاً، مستوى تركيز الملوّثات واقتراحات الصحة).

يمكنك طلب معلومات جودة الهواء الحالية كل ساعة من خلال نقطة النهاية currentConditions عن طريق إرسال طلب HTTP POST إلى:

https://airquality.googleapis.com/v1/currentConditions:lookup?key=YOUR_API_KEY

أدرِج خيارات طلبك في نص طلب JSON. يتضمّن نص الطلب الموقع الجغرافي الذي تريد الاطّلاع فيه على أحوال جودة الهواء الحالية وخيارات مختلفة للتحكّم في المعلومات المتعلقة بجودة الهواء التي يجب تضمينها في الاستجابة.

مثال على طلب أساسي

نص الطلب الأساسي

يوضح الرمز التالي كيفية إنشاء نص طلب أساسي لطلب currentConditions. في هذا المثال، يمكنك ضبط الموقع الجغرافي فقط.

curl -X POST -d '{
  "location": {
    "latitude": 37.419734,
    "longitude": -122.0827784
  }
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/currentConditions:lookup?key=YOUR_API_KEY'

ردّ أساسي على الطلب

تنشئ المكالمة الواردة أعلاه استجابة JSON التالية. لمزيد من التفاصيل حول بيانات الرد، يمكنك الاطّلاع على بيانات الرد.

ملاحظة: بشكل تلقائي، تتضمّن الاستجابة مؤشر جودة الهواء العالمي مع معلومات مؤشر جودة الهواء الأساسية. يمكن إزالة مؤشر جودة الهواء (AQI) أو استبداله بمؤشر جودة مختلف من خلال ضبط المعلَمات المناسبة.

{
  "dateTime": "2023-10-26T18:00:00Z",
  "regionCode": "us",
  "indexes": [
    {
      "code": "uaqi",
      "displayName": "Universal AQI",
      "aqi": 52,
      "aqiDisplay": "52",
      "color": {
        "red": 0.9490196,
        "green": 0.98039216,
        "blue": 0.019607844
      },
      "category": "Moderate air quality",
      "dominantPollutant": "no2"
    }
  ]
}

مثال على طلب بمعلَمات متعددة

طلب معلمات متعددة

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

curl -X POST -d '{
  "universalAqi": true,
  "location": {
    "latitude": 37.419734,
    "longitude": -122.0827784
  },
  "extraComputations": [
    "HEALTH_RECOMMENDATIONS",
    "DOMINANT_POLLUTANT_CONCENTRATION",
    "POLLUTANT_CONCENTRATION",
    "LOCAL_AQI",
    "POLLUTANT_ADDITIONAL_INFO"
  ],
  "languageCode": "en"
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/currentConditions:lookup?key=YOUR_API_KEY'

استجابة عدة معلمات

تنشئ المكالمة الواردة أعلاه استجابة JSON التالية. لمزيد من التفاصيل حول بيانات الرد، يمكنك الاطّلاع على بيانات الرد.

{
    "dateTime": "2023-06-15T10:00:00Z",
    "regionCode": "us",
    "indexes": [
        {
            "code": "uaqi",
            "displayName": "Universal AQI",
            "aqi": 89,
            "aqiDisplay": "89",
            "color": {
                "red": 48,
                "green": 175,
                "blue": 55,
                "alpha": 255
            },
            "category": "Excellent air quality",
            "dominantPollutant": "o3"
        },
        {
            "code": "usa_epa",
            "displayName": "AQI (US)",
            "aqi": 41,
            "aqiDisplay": "41",
            "color": {
                "green": 228,
                "alpha": 255
            },
            "category": "Good air quality",
            "dominantPollutant": "pm25"
        }
    ],
    "pollutants": [
        {
            "code": "co",
            "displayName": "CO",
            "fullName": "Carbon monoxide",
            "concentration": {
                "value": 334.24,
                "units": "PARTS_PER_BILLION"
            },
            "additionalInfo": {
                "sources": "Typically originates from incomplete combustion...",
                "effects": "When inhaled, carbon monoxide can prevent the blood from..."
            }
        },
        {
            "code": "no2",
            "displayName": "NO2",
            "fullName": "Nitrogen dioxide",
            "concentration": {
                "value": 13.12,
                "units": "PARTS_PER_BILLION"
            },
            "additionalInfo": {
                "sources": "Main sources are fuel burning processes, such as...",
                "effects": "Exposure may cause increased bronchial reactivity..."
            }
        },
        {
            "code": "o3",
            "displayName": "O3",
            "fullName": "Ozone",
            "concentration": {
                "value": 13.88,
                "units": "PARTS_PER_BILLION"
            },
            "additionalInfo": {
                "sources": "Ozone is created in a chemical reaction between atmospheric oxygen...",
                "effects": "Ozone can irritate the airways and cause coughing, a burning..."
            }
        },
        {
            "code": "pm10",
            "displayName": "PM10",
            "fullName": "Inhalable particulate matter (<10µm)",
            "concentration": {
                "value": 5.07,
                "units": "MICROGRAMS_PER_CUBIC_METER"
            },
            "additionalInfo": {
                "sources": "Main sources are combustion processes (e.g. indoor heating, wildfires)...",
                "effects": "Inhalable particles can penetrate into the lungs. Short term exposure..."
            }
        },
        {
            "code": "pm25",
            "displayName": "PM2.5",
            "fullName": "Fine particulate matter (<2.5µm)",
            "concentration": {
                "value": 2.83,
                "units": "MICROGRAMS_PER_CUBIC_METER"
            },
            "additionalInfo": {
                "sources": "Main sources are combustion processes (e.g. power plants, indoor heating...",
                "effects": "Fine particles can penetrate into the lungs and bloodstream. Short term..."
            }
        },
        {
            "code": "so2",
            "displayName": "SO2",
            "fullName": "Sulfur dioxide",
            "concentration": {
                "value": 0.02,
                "units": "PARTS_PER_BILLION"
            },
            "additionalInfo": {
                "sources": "Main sources are burning processes of sulfur-containing fuel in industry...",
                "effects": "Exposure causes irritation of the respiratory tract, coughing and generates..."
            }
        }
    ],
    "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...",
        "lungDiseasePopulation": "...",
        "heartDiseasePopulation": "...",
        "athletes": "...",
        "pregnantWomen": "...",
        "children": "..."
    }
}