यह फ़ंक्शन किसी दी गई समयसीमा के दौरान, किसी जगह की एयर क्वालिटी का इतिहास दिखाता है.
एचटीटीपी अनुरोध
POST https://airquality.googleapis.com/v1/history:lookup
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:
जेएसओएन के काेड में दिखाना |
---|
{ "pageSize": integer, "pageToken": string, "location": { object ( |
फ़ील्ड | |
---|---|
pageSize |
ज़रूरी नहीं. हर पेज पर, हर घंटे की जाने वाली जानकारी को रिकॉर्ड करने की ज़्यादा से ज़्यादा संख्या. डिफ़ॉल्ट वैल्यू 72 और ज़्यादा से ज़्यादा वैल्यू 168 (सात दिनों का डेटा) है. |
pageToken |
ज़रूरी नहीं. किसी पुराने इतिहास कॉल से पेज टोकन मिला है. इसका इस्तेमाल बाद वाले पेज को वापस पाने के लिए किया जाता है. ध्यान दें कि इस पैरामीटर के लिए वैल्यू देते समय, दूसरे सभी पैरामीटर, उस कॉल से मेल खाने चाहिए जो पेज टोकन (पिछला कॉल) से मिला था. |
location |
ज़रूरी है. वह अक्षांश और देशांतर जिसके लिए एपीआई, एयर क्वालिटी के इतिहास का डेटा देखता है. |
extraComputations[] |
ज़रूरी नहीं. अन्य सुविधाएं, जिन्हें विकल्प के तौर पर चालू किया जा सकता है. अतिरिक्त कंप्यूटेशन तय करने पर, काम के एलिमेंट और फ़ील्ड दिखाए जाएंगे, ताकि उन्हें जवाब के तौर पर दिखाया जा सके. |
uaqiColorPalette |
ज़रूरी नहीं. 'यूनिवर्सल एयर क्वालिटी इंडेक्स' (UAQI) से मिले डेटा के लिए इस्तेमाल किए जाने वाले रंग पटल को तय करता है. यह कलर पैलेट सिर्फ़ UAQI के लिए काम का है, जबकि अन्य AQI में पहले से तय किए गए रंग पटल होते हैं, जिन्हें कंट्रोल नहीं किया जा सकता. |
customLocalAqis[] |
ज़रूरी नहीं. 'देश/इलाके और AQI के बीच का संबंध' दिखाता है. किसी देश/इलाके को अपनी पसंद के AQI के साथ जोड़ता है, ताकि उस देश/इलाके के लिए ज़रूरी एयर क्वालिटी का डेटा, चुने गए AQI के मुताबिक दिखाया जा सके. इस पैरामीटर का इस्तेमाल, किसी देश के लिए AQI की डिफ़ॉल्ट जानकारी को तय करने के लिए किया जा सकता है. उदाहरण के लिए, कनाडा के डिफ़ॉल्ट इंडेक्स के बजाय, कनाडा के लिए यूएस ईपीए इंडेक्स पाना. |
dateTime |
वह टाइमस्टैंप, जिसके लिए पुराना डेटा दिखाया जाता है. टाइमस्टैंप को पिछले घंटे के ठीक बाद में बदल दिया जाता है. ध्यान दें: यह सिर्फ़ अनुरोध किए गए टाइमस्टैंप के लिए, हर घंटे के हिसाब से डेटा दिखाएगा. जैसे, हर घंटे के लिए जानकारी देने वाला एक एलिमेंट. उदाहरण के लिए, अगर तारीख और समय पैरामीटर 2023-01-03T11:05:49Z पर सेट किया गया है, तो भेजे गए अनुरोध को कम करके 2023-01-03T11:00:00Z पर सेट कर दिया जाएगा. RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड का रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक हो सकते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z". ध्यान दें: अनुरोध में |
hours |
यह 1 से 720 तक की संख्या होती है, जो अनुरोध के खुले होने के समय की जानकारी देती है. उदाहरण के लिए: 48 की वैल्यू, पिछले 48 घंटों का डेटा देगी. |
period |
उस ध्यान दें: अनुरोध में |
universalAqi |
ज़रूरी नहीं. अगर वैल्यू को 'सही है' पर सेट किया जाता है, तो Universal AQI को जवाब के 'इंडेक्स' फ़ील्ड में शामिल किया जाएगा. डिफ़ॉल्ट वैल्यू 'सही' पर सेट होती है. |
languageCode |
ज़रूरी नहीं. क्लाइंट को जवाब के लिए भाषा चुनने की अनुमति देता है. अगर उस भाषा के लिए डेटा नहीं दिया जा सकता, तो एपीआई सबसे नज़दीकी मिलान का इस्तेमाल करता है. स्वीकार की गई वैल्यू, आईईटीएफ़ स्टैंडर्ड के मुताबिक होती हैं. डिफ़ॉल्ट वैल्यू en है. |
जवाब का मुख्य भाग
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{
"hoursInfo": [
{
object ( |
फ़ील्ड | |
---|---|
hoursInfo[] |
ज़रूरी नहीं. इसमें, अनुरोध की गई सीमा में हर घंटे की एयर क्वालिटी की जानकारी होती है. उदाहरण के लिए, अगर अनुरोध 48 घंटों के इतिहास के लिए है, तो हर घंटे की जानकारी के 48 एलिमेंट मिलेंगे. |
regionCode |
ज़रूरी नहीं. अनुरोध में दिए गए देश/इलाके का ISO_3166-1 alpha-2 कोड. अगर अनुरोध में दी गई जगह किसी विवादित देश/इलाके में है, तो इस फ़ील्ड को जवाब में शामिल नहीं किया जा सकता. |
nextPageToken |
ज़रूरी नहीं. अगला पेज फिर से पाने के लिए टोकन. |
अनुमति के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/cloud-platform
ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.
HourInfo
इसमें, अनुरोध की गई सीमा में हर घंटे की एयर क्वालिटी की जानकारी होती है. उदाहरण के लिए, अगर अनुरोध 48 घंटों के इतिहास के लिए है, तो हर घंटे की जानकारी के 48 एलिमेंट मिलेंगे.
जेएसओएन के काेड में दिखाना |
---|
{ "dateTime": string, "indexes": [ { object ( |
फ़ील्ड | |
---|---|
dateTime |
एक राउंड डाउन टाइमस्टैंप, जिससे पता चलता है कि डेटा, RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में है. इसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक शामिल हैं. उदाहरण के लिए: "2014-10-02T15:00:00Z". |
indexes[] |
अनुरोध के पैरामीटर के आधार पर, इस सूची में (ज़्यादा से ज़्यादा) दो एयर क्वालिटी इंडेक्स शामिल होंगे:
|
pollutants[] |
अनुरोध में बताई गई जगह पर असर डालने वाले कॉम्पोनेंट की सूची. ध्यान दें: यह फ़ील्ड सिर्फ़ उन अनुरोधों के लिए दिया जाएगा जिन्होंने आगे दी गई एक या ज़्यादा अतिरिक्त गणनाएं तय की हैं: POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION. |
healthRecommendations |
एयर क्वालिटी की जिस बीमारी की शिकायत की गई है उसके लिए स्वास्थ्य से जुड़ी सलाह और सुझाई गई कार्रवाइयां. जिन लोगों को जोखिम हो सकता है, ऐसे ग्रुप जो प्रदूषण फैलाने वाले कॉम्पोनेंट के प्रति ज़्यादा संवेदनशील हैं, और सामान्य जनसंख्या के लिए, सुझावों को अलग-अलग तरीके से बनाया जाता है. |