Method: currentConditions.lookup

मौजूदा स्थिति बताने वाला एंडपॉइंट, 100 से ज़्यादा देशों में हर घंटे की एयर क्वालिटी की जानकारी देता है. इसका रिज़ॉल्यूशन 500 x 500 मीटर तक हो सकता है. इसमें 70 से ज़्यादा स्थानीय इंडेक्स और ग्लोबल एयर क्वालिटी इंडेक्स और कैटगरी शामिल हैं.

एचटीटीपी अनुरोध

POST https://airquality.googleapis.com/v1/currentConditions:lookup

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, यहां दिए गए स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना 
{
  "location": {
    object (LatLng)
  },
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "uaqiColorPalette": enum (ColorPalette),
  "customLocalAqis": [
    {
      object (CustomLocalAqi)
    }
  ],
  "universalAqi": boolean,
  "languageCode": string
}
फ़ील्ड
location

object (LatLng)

ज़रूरी है. वह देशांतर और अक्षांश जहां से एपीआई, एयर क्वालिटी की मौजूदा स्थितियों का डेटा खोजता है.
extraComputations[]

enum (ExtraComputation)

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

enum (ColorPalette)

ज़रूरी नहीं. 'यूनिवर्सल एयर क्वालिटी इंडेक्स' से मिले डेटा के लिए इस्तेमाल किए जाने वाले रंग पटल को तय करता है (UAQI). यह कलर पटल सिर्फ़ UAQI के लिए काम का है. अन्य एक्यूआई, पहले से तय किए गए रंग पटल होते हैं. इन्हें कंट्रोल नहीं किया जा सकता.
customLocalAqis[]

object (CustomLocalAqi)

ज़रूरी नहीं. 'देश/इलाके के एक्यूआई' के बारे में बताता है संबंध. यह चुने गए एक्यूआई वाले देश/इलाके को जोड़ता है. इससे उस देश/इलाके के लिए ज़रूरी एयर क्वालिटी का डेटा, चुने गए एक्यूआई के हिसाब से दिखाया जाता है. इस पैरामीटर का इस्तेमाल, किसी देश के ऐसे एक्यूआई की जानकारी देने के लिए किया जा सकता है जो डिफ़ॉल्ट न हो. उदाहरण के लिए, कनाडा के डिफ़ॉल्ट इंडेक्स के बजाय, अमेरिका के ईपीए इंडेक्स का पता लगाने के लिए.
universalAqi

boolean

ज़रूरी नहीं. अगर इसे 'सही है' पर सेट किया जाता है, तो यूनिवर्सल एक्यूआई को 'इंडेक्स' में शामिल किया जाएगा जवाब वाला फ़ील्ड. डिफ़ॉल्ट मान 'सही' है.
languageCode

string

ज़रूरी नहीं. इससे क्लाइंट को जवाब के लिए भाषा चुनने की अनुमति मिलती है. अगर उस भाषा के लिए डेटा नहीं दिया जा सकता, तो एपीआई सबसे करीबी मिलान का इस्तेमाल करता है. अनुमति वाली वैल्यू, आईईटीएफ़ स्टैंडर्ड के हिसाब से होती हैं. डिफ़ॉल्ट वैल्यू en है.

जवाब का मुख्य भाग

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

JSON के काेड में दिखाना 
{
  "dateTime": string,
  "regionCode": string,
  "indexes": [
    {
      object (AirQualityIndex)
    }
  ],
  "pollutants": [
    {
      object (Pollutant)
    }
  ],
  "healthRecommendations": {
    object (HealthRecommendations)
  }
}
फ़ील्ड
dateTime

string (Timestamp format)

RFC3339 यूटीसी "ज़ुलु" में राउंड डाउन किया गया टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण के लिए: "2014-10-02T15:00:00Z".
regionCode

string

अनुरोध में दी गई जगह से जुड़े देश/इलाके का ISO_3166-1 alpha-2 कोड. अगर अनुरोध में दी गई जगह किसी विवादित देश/इलाके में है, तो इस फ़ील्ड को जवाब में शामिल नहीं किया जा सकता.
indexes[]

object (AirQualityIndex)

अनुरोध के पैरामीटर के आधार पर, इस सूची में ज़्यादा से ज़्यादा दो एयर क्वालिटी इंडेक्स शामिल होंगे:

  • यूनिवर्सल एक्यूआई. अगर युनिवर्सलAqi बूलियन सही पर सेट है, तो इसे लौटाया जाएगा.
  • लोकल एक्यूआई. अगर LOCAL_AQI की अतिरिक्त कंप्यूटेशन की जानकारी दी गई हो, तो नतीजे को लौटाया जाएगा.
pollutants[]

object (Pollutant)

प्रदूषण फैलाने वाले उन कॉम्पोनेंट की सूची जो अनुरोध में बताई गई जगह पर असर डालते हैं. ध्यान दें: यह फ़ील्ड सिर्फ़ उन अनुरोधों के लिए लौटाया जाएगा जिन्होंने नीचे दिए गए अतिरिक्त कंप्यूटेशन या इनमें से किसी एक के बारे में बताया है: POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION.
healthRecommendations

object (HealthRecommendations)

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

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/cloud-platform

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.