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