'मौजूदा स्थितियां' एंडपॉइंट, 100 से ज़्यादा देशों में हर घंटे 500 x 500 मीटर तक की एयर क्वालिटी की जानकारी देता है. इसमें 70 से ज़्यादा स्थानीय इंडेक्स, ग्लोबल एयर क्वालिटी इंडेक्स, और कैटगरी शामिल हैं.
एचटीटीपी अनुरोध
POST https://airquality.googleapis.com/v1/currentConditions:lookup
यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में इस तरह का डेटा शामिल होता है:
जेएसओएन के काेड में दिखाना |
---|
{ "location": { object ( |
फ़ील्ड | |
---|---|
location |
ज़रूरी है. वह देशांतर और अक्षांश जहां से एपीआई, एयर क्वालिटी की मौजूदा स्थितियों का डेटा खोजता है. |
extraComputations[] |
ज़रूरी नहीं. ऐसी अन्य सुविधाएं जिन्हें चालू किया जा सकता है. अतिरिक्त कंप्यूटेशन तय करने से, जवाब के तौर पर काम के एलिमेंट और फ़ील्ड दिखाए जाएंगे. |
uaqiColorPalette |
ज़रूरी नहीं. 'यूनिवर्सल एयर क्वालिटी इंडेक्स' (UAQI) से मिले डेटा के लिए इस्तेमाल किए जाने वाले कलर पैलेट को तय करता है. यह रंग पटल सिर्फ़ UAQI के लिए काम का है, अन्य AQI में पहले से तय किए गए रंग पटल हैं, जिन्हें नियंत्रित नहीं किया जा सकता. |
customLocalAqis[] |
ज़रूरी नहीं. 'देश/इलाके से AQI' के संबंध को दिखाता है. किसी देश/इलाके को पसंद के मुताबिक AQI के साथ जोड़ा जा सकता है, ताकि उस देश/इलाके की एयर क्वालिटी का डेटा, चुने गए AQI के मुताबिक दिखाया जा सके. इस पैरामीटर का इस्तेमाल, किसी देश के लिए AQI की डिफ़ॉल्ट वैल्यू तय करने के लिए किया जा सकता है. उदाहरण के लिए, कनाडा के लिए डिफ़ॉल्ट इंडेक्स के बजाय, कनाडा के लिए यूएस ईपीए इंडेक्स पाने के लिए. |
universalAqi |
ज़रूरी नहीं. अगर वैल्यू को 'सही है' पर सेट किया जाता है, तो यूनिवर्सल AQI को जवाब के 'इंडेक्स' फ़ील्ड में शामिल किया जाएगा. डिफ़ॉल्ट वैल्यू 'सही' पर सेट होती है. |
languageCode |
ज़रूरी नहीं. क्लाइंट को जवाब के लिए भाषा चुनने की अनुमति देता है. अगर उस भाषा के लिए डेटा नहीं दिया जा सकता, तो एपीआई सबसे नज़दीकी मिलान का इस्तेमाल करता है. अनुमति वाली वैल्यू, आईईटीएफ़ स्टैंडर्ड पर निर्भर होती हैं. डिफ़ॉल्ट वैल्यू en है. |
जवाब का मुख्य भाग
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{ "dateTime": string, "regionCode": string, "indexes": [ { object ( |
फ़ील्ड | |
---|---|
dateTime |
RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में, नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंकों तक का टाइमस्टैंप. उदाहरण के लिए: "2014-10-02T15:00:00Z". |
regionCode |
अनुरोध में दी गई जगह से जुड़े देश/इलाके का ISO_3166-1 alpha-2 कोड. अगर अनुरोध में दी गई जगह किसी विवादित देश/इलाके में है, तो इस फ़ील्ड को जवाब से हटाया जा सकता है. |
indexes[] |
अनुरोध के पैरामीटर के आधार पर, इस सूची में दो एयर क्वालिटी इंडेक्स शामिल होंगे:
|
pollutants[] |
प्रदूषण फैलाने वाले कॉम्पोनेंट की सूची, जो अनुरोध में बताई गई जगह पर असर डालती है. ध्यान दें: यह फ़ील्ड सिर्फ़ उन अनुरोधों के लिए दिखाया जाएगा जिनमें नीचे दी गई एक या एक से ज़्यादा अतिरिक्त कंप्यूटेशन बताए गए हैं: POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION. |
healthRecommendations |
रिपोर्ट की गई एयर क्वालिटी की समस्याओं के बारे में, स्वास्थ्य से जुड़ी सलाह और सुझाई गई कार्रवाइयां. संवेदनशील सेहत वाले लोगों, प्रदूषण फैलाने वाले कॉम्पोनेंट के प्रति ज़्यादा संवेदनशील होने वाले ग्रुप, और सामान्य जनसंख्या के लिए, सुझावों को अलग-अलग तरीके से तैयार किया जाता है. |
अनुमति देने के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/cloud-platform
ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.