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

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

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

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) مع معلومات 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"
    }
  ]
}

ملاحظة: إذا كانت قيمة حقل color هي 0، يتم حذف هذا الحقل من الاستجابة.

مثال على طلب يتضمّن مَعلمات متعدّدة

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

توضِّح التعليمة البرمجية التالية كيفية إنشاء نص طلب لطلب 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": "..."
    }
}