मौजूदा स्थितियां

currentConditions एंडपॉइंट, हर घंटे की हवा की क्वालिटी की मौजूदा जानकारी देता है. आपके पास यह कंट्रोल करने का विकल्प होता है कि कौनसी एक्यूआई और ज़रूरी जानकारी दिखानी है. जैसे, प्रदूषण फैलाने वाले कॉम्पोनेंट की मात्रा और सेहत से जुड़े सुझाव.

currentConditions एंडपॉइंट का इस्तेमाल करके, हर घंटे की एयर क्वालिटी का अनुरोध किया जा सकता है. इसके लिए, एचटीटीपी पोस्ट अनुरोध को यहां भेजें:

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 रिस्पॉन्स जनरेट करता है. रिस्पॉन्स डेटा के बारे में ज़्यादा जानकारी के लिए, रिस्पॉन्स डेटा देखें.

ध्यान दें: डिफ़ॉल्ट रूप से, जवाब में यूनिवर्सल एक्यूआई के साथ-साथ एक्यूआई की बुनियादी जानकारी शामिल होती है. एयर क्वालिटी इंडेक्स को हटाया जा सकता है या किसी दूसरे एयर क्वालिटी इंडेक्स से बदला जा सकता है. इसके लिए, उससे जुड़े पैरामीटर सेट करें.

{
  "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": "..."
    }
}