forecast एंडपॉइंट
किसी जगह के लिए हर घंटे के हिसाब से, 96 घंटे (चार दिन) तक की एयर
क्वालिटी के पूर्वानुमान की जानकारी देता है. हर पूर्वानुमान में, हर घंटे के हिसाब से एयर क्वालिटी इंडेक्स के साथ-साथ यह जानकारी भी शामिल होती है:
- पूर्वानुमान के लिए, तय समय और तारीख या समयावधि
- अनुवाद किए गए फ़ील्ड के लिए भाषा कोड
- स्थानीय या कस्टम एयर क्वालिटी इंडेक्स (एक्यूआई)
- सेहत से जुड़े सुझाव
- प्रदूषण फैलाने वाले मुख्य कॉम्पोनेंट
- प्रदूषण फैलाने वाले कॉम्पोनेंट की सांद्रता (कंसंट्रेशन)
- प्रदूषण फैलाने वाले कॉम्पोनेंट के बारे में ज़्यादा जानकारी
- जवाब वाले पेज का साइज़
- रंग पटल
एपीआई एक्सप्लोरर की मदद से, लाइव अनुरोध किए जा सकते हैं. इससे आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिलती है:
पूर्वानुमान के अनुरोधों के बारे में जानकारी
forecast एंडपॉइंट का इस्तेमाल करके, हर घंटे के हिसाब से एयर क्वालिटी के पूर्वानुमान की जानकारी का अनुरोध किया जा सकता है. इसके लिए, इस यूआरएल पर एचटीटीपी पीओएसटी अनुरोध भेजें:
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" }
इसे आज़माएं!
एपीआई एक्सप्लोरर की मदद से, सैंपल अनुरोध किए जा सकते हैं. इससे आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिलती है.
पेज की दाईं ओर मौजूद, एपीआई आइकॉन api को चुनें.
ज़रूरत पड़ने पर, अनुरोध के पैरामीटर में बदलाव करें.
कार्रवाई करें बटन को चुनें. डायलॉग में, वह खाता चुनें जिसका इस्तेमाल करके आपको अनुरोध करना है.
एपीआई एक्सप्लोरर पैनल में, फ़ुलस्क्रीन आइकॉन fullscreen को चुनकर, एपीआई एक्सप्लोरर विंडो को बड़ा करें.