पूर्वानुमान

forecast एंडपॉइंट, किसी जगह के लिए 96 घंटे (चार दिन) तक की, हर घंटे के हिसाब से हवा की क्वालिटी के पूर्वानुमान की जानकारी देता है. हर पूर्वानुमान में, हर घंटे के हिसाब से हवा की क्वालिटी के इंडेक्स के साथ-साथ यह जानकारी भी शामिल होती है:

  • अनुमान के लिए, कोई तारीख और समय या समयावधि
  • अनुवाद किए गए फ़ील्ड के लिए भाषा कोड
  • स्थानीय या कस्टम एयर क्वालिटी इंडेक्स (एक्यूआई)
  • सेहत से जुड़े सुझाव
  • मुख्य प्रदूषक
  • प्रदूषक की सांद्रता
  • प्रदूषण फैलाने वाले कॉम्पोनेंट के बारे में अतिरिक्त जानकारी
  • जवाब वाले पेज का साइज़
  • रंग पटल

एपीआई एक्सप्लोरर की मदद से, लाइव अनुरोध किए जा सकते हैं. इससे आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिलती है:

अनुमान के अनुरोधों के बारे में जानकारी

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

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

अनुरोध के मुख्य हिस्से में अपने पैरामीटर शामिल करें. अनुरोध के मुख्य हिस्से में, उस जगह की जानकारी होती है जिसके लिए आपको हर घंटे की एयर क्वालिटी के पूर्वानुमान की जानकारी चाहिए. साथ ही, इसमें ऐसे कई विकल्प होते हैं जिनसे यह कंट्रोल किया जा सकता है कि जवाब में कौनसी अतिरिक्त जानकारी शामिल करनी है.

अनुमान के बारे में जानकारी

जवाब के मुख्य हिस्से में, यूटीसी के हिसाब से तारीख और समय दिया जाता है. इस तारीख और समय के लिए, एयर क्वालिटी के पूर्वानुमान की जानकारी, एयर क्वालिटी इंडेक्स, और ज़रूरत के हिसाब से तैयार की गई अन्य जानकारी दिखाई जाती है. अगर जानकारी, अनुरोध किए गए पेज के साइज़ में फ़िट नहीं होती है, तो जवाब के मुख्य हिस्से में अगले पेज को वापस पाने के लिए एक टोकन भी शामिल होता है.

बुनियादी अनुरोध का उदाहरण

यहां दिए गए कोड में, पूर्वानुमान के लिए अनुरोध बनाने का तरीका बताया गया है. इस उदाहरण में, आपको उस जगह, तारीख, और समय की जानकारी देनी होती है जिसके लिए, हर घंटे के हिसाब से एयर क्वालिटी के पूर्वानुमान की जानकारी दिखानी है. यह जानकारी, अगले घंटे से लेकर 96 घंटे तक के लिए दिखाई जा सकती है.

curl -X POST -d '{
  "location": {
    "latitude": 37.4125333,
    "longitude": -122.0840937
  },
  "dateTime": "2024-02-09T08:00:00Z"
}' \
-H "Content-Type: application/json" \
-H "Accept-Language: *" \
"https://airquality.googleapis.com/v1/forecast:lookup?key=YOUR_API_KEY"

कॉल से यह JSON रिस्पॉन्स जनरेट होता है.

{
  "hourlyForecasts": [
    {
      "dateTime": "2024-02-09T08:00:00Z",
      "indexes": [
        {
          "code": "uaqi",
          "displayName": "Universal AQI",
          "aqi": 80,
          "aqiDisplay": "80",
          "color": {
            "red": 0.34509805,
            "green": 0.74509805,
            "blue": 0.20784314
          },
          "category": "Excellent air quality",
          "dominantPollutant": "pm25"
        }
      ]
    }
  ],
  "regionCode": "us"
}

एक से ज़्यादा पैरामीटर वाले अनुरोध का उदाहरण

यहां दिए गए कोड में, कई पैरामीटर के साथ अनुरोध का मुख्य हिस्सा बनाने का तरीका बताया गया है. इस उदाहरण में, यह जानकारी दी गई है:

  • जगह
  • वह समयावधि जिसके लिए एयर क्वालिटी के पूर्वानुमान की जानकारी दिखानी है
  • भाषा कोड
  • ज़्यादा कैलकुलेशन (जैसे, सेहत से जुड़े सुझाव, मुख्य प्रदूषक की कॉन्संट्रेशन, और अन्य प्रदूषकों के बारे में जानकारी)
  • रंग पटल
curl -X POST -d '{
    "pageSize": "10",
    "universalAqi": "true",
    "location": {
        "latitude": "40.741895",
        "longitude": "-73.989308"
    },
    "period": {
        "startTime": "2024-02-27T13:58:14+02:00",
        "endTime": "2024-02-28T16:58:14+02:00"
    },
    "languageCode": "en",
    "extraComputations": [
        "HEALTH_RECOMMENDATIONS",
        "DOMINANT_POLLUTANT_CONCENTRATION",
        "POLLUTANT_ADDITIONAL_INFO"
    ],
    "uaqiColorPalette": "RED_GREEN"
}' \
-H "Content-Type: application/json" \
-H "Accept-Language: *" \
"https://airquality.googleapis.com/v1/forecast:lookup?key=YOUR_API_KEY"

कॉल से यह JSON रिस्पॉन्स जनरेट होता है.

{
  {
  "hourlyForecasts": [
    {
      "dateTime": "2024-02-27T11:00:00Z",
      "indexes": [
        {
          "code": "uaqi",
          "displayName": "Universal AQI",
          "aqi": 75,
          "aqiDisplay": "75",
          "color": {
            "red": 0.43137255,
            "green": 0.7764706,
            "blue": 0.20392157
          },
          "category": "Good air quality",
          "dominantPollutant": "pm25"
        }
      ],
      "pollutants": [
        {
          "code": "pm25",
          "displayName": "PM2.5",
          "fullName": "Fine particulate matter (\u003c2.5µm)",
          "concentration": {
            "value": 15.1,
            "units": "MICROGRAMS_PER_CUBIC_METER"
          },
          "additionalInfo": {
            "sources": "...",
            "effects": "..."
          }
        }
      ],
      "healthRecommendations": {
        "generalPopulation": "...",
        "lungDiseasePopulation": "...",
        "heartDiseasePopulation": "...",
        "athletes": "...",
        "pregnantWomen": "..."
      }
    },
    {
      "dateTime": "2024-02-27T12:00:00Z",
      "indexes": [
        {
          "code": "uaqi",
          "displayName": "Universal AQI",
          "aqi": 67,
          "aqiDisplay": "67",
          "color": {
            "red": 0.5882353,
            "green": 0.8392157,
            "blue": 0.16862746
          },
          "category": "Good air quality",
          "dominantPollutant": "pm25"
        }
      ],
      "pollutants": [
        {
          "code": "pm25",
          "displayName": "PM2.5",
          "fullName": "Fine particulate matter (\u003c2.5µm)",
          "concentration": {
            "value": 19.96,
            "units": "MICROGRAMS_PER_CUBIC_METER"
          },
          "additionalInfo": {
            "sources": "...",
            "effects": "..."
          }
        }
      ],
      "healthRecommendations": {
        "generalPopulation": "...",
        "lungDiseasePopulation": "...",
        "heartDiseasePopulation": "...",
        "athletes": "...",
        "pregnantWomen": "...",
        "children": "..."
      }
    },
    /.../
  ]
  }
  "regionCode": "us",
  "nextPageToken": "CjMKEglwCFVq9l5EQBH0aoDSUH9SwBoQCgYI1pDirgYSBgiGiOiuBiABKgMCBAMyAmVuOAEQGA=="
}

पूर्वानुमान की जानकारी का अगला पेज देखने के लिए, रिस्पॉन्स बॉडी के आखिर में nextPageToken पास करें:

curl -X POST -d '{
    "universalAqi": "true",
    "location": {
        "latitude": "40.741895",
        "longitude": "-73.989308"
    },
    "period": {
        "startTime": "2024-02-27T13:58:14+02:00",
        "endTime": "2024-02-28T16:58:14+02:00"
    },
    "languageCode": "en",
    "extraComputations": [
        "HEALTH_RECOMMENDATIONS",
        "DOMINANT_POLLUTANT_CONCENTRATION",
        "POLLUTANT_ADDITIONAL_INFO"
    ],
    "uaqiColorPalette": "RED_GREEN",
    "pageToken": "CjMKEglwCFVq9l5EQBH0aoDSUH9SwBoQCgYI1pDirgYSBgiGiOiuBiABKgMCBAMyAmVuOAEQGA=="
}' \
-H "Content-Type: application/json" \
-H "Accept-Language: *" \
"https://airquality.googleapis.com/v1/forecast:lookup?key=YOUR_API_KEY"

इससे पूर्वानुमान की जानकारी वाला अगला पेज दिखता है:

{
  "hourlyForecasts": [
    {
      "dateTime": "2024-02-27T21:00:00Z",
      "indexes": [
        {
          "code": "uaqi",
          "displayName": "Universal AQI",
          "aqi": 74,
          "aqiDisplay": "74",
          "color": {
            "red": 0.44705883,
            "green": 0.78431374,
            "blue": 0.2
          },
          "category": "Good air quality",
          "dominantPollutant": "o3"
        }
      ],
      "pollutants": [
        {
          "code": "o3",
          "displayName": "O3",
          "fullName": "Ozone",
          "concentration": {
            "value": 32.07,
            "units": "PARTS_PER_BILLION"
          },
          "additionalInfo": {
            "sources": "...",
            "effects": "..."
          }
        }
      ],
      "healthRecommendations": {
        "generalPopulation": "...",
        "elderly": "...",
        "lungDiseasePopulation": "...",
        "heartDiseasePopulation": "...",
        "athletes": "...",
        "pregnantWomen": "...",
        "children": "..."
      }
    },
    {
      "dateTime": "2024-02-27T22:00:00Z",
      "indexes": [
        {
          "code": "uaqi",
          "displayName": "Universal AQI",
          "aqi": 75,
          "aqiDisplay": "75",
          "color": {
            "red": 0.43137255,
            "green": 0.7764706,
            "blue": 0.20392157
          },
          "category": "Good air quality",
          "dominantPollutant": "o3"
        }
      ],
      "pollutants": [
        {
          "code": "o3",
          "displayName": "O3",
          "fullName": "Ozone",
          "concentration": {
            "value": 30.94,
            "units": "PARTS_PER_BILLION"
          },
          "additionalInfo": {
            "sources": "...",
            "effects": "..."
          }
        }
      ],
      "healthRecommendations": {
        "generalPopulation": "...",
        "lungDiseasePopulation": "...",
        "heartDiseasePopulation": "...",
        "athletes": "...",
        "pregnantWomen": "...",
        "children": "..."
      }
    },
    /.../
  ]
  "regionCode": "us"
}

इसे आज़माएं!

APIs Explorer की मदद से, सैंपल अनुरोध किए जा सकते हैं. इससे आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिलती है.

  1. पेज की दाईं ओर मौजूद, एपीआई आइकॉन api चुनें.

  2. अनुरोध के पैरामीटर में बदलाव करें. यह ज़रूरी नहीं है.

  3. लागू करें बटन को चुनें. डायलॉग बॉक्स में, वह खाता चुनें जिसका इस्तेमाल करके आपको अनुरोध करना है.

  4. APIs Explorer पैनल में, फ़ुलस्क्रीन आइकॉन fullscreen को चुनें, ताकि APIs Explorer विंडो को बड़ा किया जा सके.