Package google.maps.airquality.v1

इंडेक्स

AirQuality

एयर क्वालिटी से जुड़ी सेवाएं.

LookupCurrentConditions

rpc LookupCurrentConditions(LookupCurrentConditionsRequest) returns (LookupCurrentConditionsResponse)

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

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

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

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

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

rpc LookupForecast(LookupForecastRequest) returns (LookupForecastResponse)

यह सुविधा, दी गई समयसीमा के दौरान किसी खास जगह की एयर क्वालिटी का पूर्वानुमान दिखाती है.

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

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

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

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

rpc LookupHeatmapTile(LookupHeatmapTileRequest) returns (HttpBody)

यह बाइट कलेक्शन दिखाता है, जिसमें टाइल PNG इमेज का डेटा होता है.

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

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

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

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

rpc LookupHistory(LookupHistoryRequest) returns (LookupHistoryResponse)

यह फ़ंक्शन किसी दी गई समयसीमा के दौरान, किसी जगह की एयर क्वालिटी का इतिहास दिखाता है.

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

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

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

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

AirQualityIndex

एयर क्वालिटी की अलग-अलग मेट्रिक दिखाने के लिए बुनियादी ऑब्जेक्ट. ये मेट्रिक, एयर क्वालिटी की मौजूदा स्थितियों के बारे में जानकारी देती हैं. दुनिया में ऐसे कई इंडेक्स हैं जो अलग-अलग मकसद से काम करते हैं. साथ ही, एयर क्वालिटी के अलग-अलग पहलुओं को जानने में दिलचस्पी रखने वाले ग्रुप हैं.

फ़ील्ड
code

string

इंडेक्स का कोड. यह फ़ील्ड, प्रोग्रामिंग के लिए इंडेक्स को दिखाता है. इसमें स्पेस के बजाय, स्नेक वाले केस का इस्तेमाल किया जाता है. उदाहरण: "uaqi", "fra_atmo".
display_name

string

इंडेक्स के नाम को कोई भी व्यक्ति आसानी से पढ़ सकता है. उदाहरण: "AQI (US)"
aqi_display

string

इंडेक्स न्यूमेरिक स्कोर को टेक्स्ट के तौर पर दिखाया जाता है. इसमें प्रीफ़िक्स या सफ़िक्स सिंबल शामिल हो सकते हैं, जो आम तौर पर सबसे खराब इंडेक्स स्कोर के बारे में बताते हैं. उदाहरण: >100 या 10+.

ध्यान दें: इस फ़ील्ड का इस्तेमाल तब करना चाहिए, जब आपको इंडेक्स स्कोर दिखाना हो. बिना संख्या वाले इंडेक्स के लिए, यह फ़ील्ड खाली होता है.
color

Color

AQI न्यूमेरिक स्कोर दिखाने के लिए इस्तेमाल किया गया रंग.
category

string

इंडेक्स के न्यूमेरिक स्कोर की जानकारी का टेक्स्ट के रूप में कैटगरी. उदाहरण के लिए: "बेहतरीन एयर क्वालिटी".
dominant_pollutant

string

प्रदूषण फैलाने वाले मुख्य कॉम्पोनेंट का रासायनिक चिह्न. उदाहरण के लिए: "CO".
aqi

int32

इंडेक्स का न्यूमेरिक स्कोर. उदाहरण: 10, 100.

इस वैल्यू को नॉर्मलाइज़ किया गया है. इसे सिर्फ़ एयर क्वालिटी इंडेक्स से जुड़े संदर्भ के हिसाब से दिखाया जाना चाहिए. बिना संख्या वाले इंडेक्स के लिए, यह फ़ील्ड नहीं दिखाया जाएगा.

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

ColorPalette

"यूनिवर्सल एयर क्वालिटी इंडेक्स" (UAQI) से मिले डेटा के लिए इस्तेमाल किए जाने वाले रंग पटल को तय करता है. यह कलर पैलेट सिर्फ़ UAQI के लिए काम का है, जबकि अन्य AQI में पहले से तय किए गए रंग पटल होते हैं, जिन्हें कंट्रोल नहीं किया जा सकता.

Enums
COLOR_PALETTE_UNSPECIFIED डिफ़ॉल्ट वैल्यू. अगर इसे पैरामीटर के तौर पर पास किया जाता है, तो ध्यान नहीं दिया जाता.
RED_GREEN इससे तय होता है कि लाल/हरे रंग के पटल का इस्तेमाल करना है या नहीं.
INDIGO_PERSIAN_DARK इससे तय होता है कि इंडिगो/पर्शन पैलेट (गहरे रंग वाली थीम) का इस्तेमाल करना है या नहीं.
INDIGO_PERSIAN_LIGHT इससे तय होता है कि इंडिगो/पर्शन पैलेट (हल्के रंग वाली थीम) का इस्तेमाल करना है या नहीं.

CustomLocalAqi

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

फ़ील्ड
region_code

string

वह देश/इलाका जहां पसंद के मुताबिक AQI चाहिए. वैल्यू, ISO 3166-1 alpha-2 कोड का इस्तेमाल करके दी जानी चाहिए.
aqi

string

देश/इलाके से जोड़ने के लिए AQI. वैल्यू, मान्य इंडेक्स कोड के तौर पर होनी चाहिए.

ExtraComputation

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

Enums
EXTRA_COMPUTATION_UNSPECIFIED डिफ़ॉल्ट वैल्यू. अगर इसे पैरामीटर के तौर पर पास किया जाता है, तो सर्वर इसे अनदेखा कर देता है.
LOCAL_AQI

इससे यह तय होता है कि जवाब में, अनुरोध की गई जगह (देश) का स्थानीय (राष्ट्रीय) AQI शामिल किया जाए या नहीं.

अगर जानकारी दी गई है, तो जवाब में 'air_क्वालिटी_index' वाला डेटा स्ट्रक्चर होगा, जिसमें जगह के स्थानीय AQI पर मौजूद सारा ज़रूरी डेटा शामिल होगा.
HEALTH_RECOMMENDATIONS

इससे यह तय होता है कि जवाब में स्वास्थ्य से जुड़ी सलाह शामिल की जाएगी या नहीं. साथ ही, AQI की मौजूदा स्थितियों के लिए सुझाई गई कार्रवाइयां भी शामिल की जाएंगी.

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

अगर आपने यह विकल्प चुना है, तो काम का डेटा उपलब्ध होने पर, जवाब में health_recommendations फ़ील्ड में जानकारी अपने-आप भर जाएगी.
POLLUTANT_ADDITIONAL_INFO

तय करता है कि जवाब में, प्रदूषण फैलाने वाले हर कॉम्पोनेंट के लिए, अतिरिक्त जानकारी शामिल की जाए या नहीं.

अगर जानकारी दी जाती है, तो डेटा उपलब्ध होने पर, 'इंडेक्स' फ़ील्ड के रिस्पॉन्स में मौजूद एयर क्वालिटी इंडेक्स के हर ऑब्जेक्ट में additional_info फ़ील्ड शामिल होगा.
DOMINANT_POLLUTANT_CONCENTRATION

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

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

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

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

अगर यह तय किया जाता है, तो डेटा उपलब्ध होने पर, प्रदूषण फैलाने वाले हर ऑब्जेक्ट के 'प्रदूषण फैलाने वाले' फ़ील्ड में concentration फ़ील्ड शामिल होगा.

HealthRecommendations

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

फ़ील्ड
general_population

string

कोई संवेदनशीलता नहीं चाहिए.
elderly

string

सेवानिवृत्त और सामान्य जनसंख्या से बुज़ुर्ग.
lung_disease_population

string

इसमें सांस से जुड़ी समस्याएं और अस्थमा होता है.
heart_disease_population

string

दिल और परिसंचरण तंत्र से जुड़ी बीमारियां.
athletes

string

खेल-कूद और बाहर जाकर कसरत, खेल-कूद, और इस तरह की अन्य शारीरिक गतिविधियां.
pregnant_women

string

गर्भावस्था के सभी चरणों में महिलाएं.
children

string

युवा लोगों की जनसंख्या. इनमें बच्चे, छोटे बच्चे, और नवजात शिशु शामिल हैं.

LookupCurrentConditionsRequest

अनुरोध में, एयर क्वालिटी की मौजूदा स्थितियों के बारे में जानकारी.

फ़ील्ड
location

LatLng

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

ExtraComputation

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

ColorPalette

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

CustomLocalAqi

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

bool

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

string

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

LookupCurrentConditionsResponse

फ़ील्ड
date_time

Timestamp

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

string

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

AirQualityIndex

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

  • यूनिवर्सल AQI. यूनिवर्सलAqi बूलियन को 'सही' पर सेट करने पर दिखाया जाएगा.
  • स्थानीय AQI. LOCAL_AQI अतिरिक्त कंप्यूटेशन के बताए गए तरीके के आधार पर नतीजे दिए जाएंगे.
pollutants[]

Pollutant

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

HealthRecommendations

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

LookupForecastRequest

एयर क्वालिटी पूर्वानुमान के एपीआई का अनुरोध करने वाला ऑब्जेक्ट.

फ़ील्ड
location

LatLng

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

ExtraComputation

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

ColorPalette

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

CustomLocalAqi

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

int32

ज़रूरी नहीं. हर पेज पर लौटाए जाने वाले, हर घंटे की जानकारी के रिकॉर्ड की ज़्यादा से ज़्यादा संख्या (डिफ़ॉल्ट = 24).
page_token

string

ज़रूरी नहीं. पिछले पूर्वानुमान कॉल से मिला पेज टोकन. इसका इस्तेमाल बाद वाले पेज को वापस पाने के लिए किया जाता है.
यूनियन फ़ील्ड time_range. एयर क्वालिटी के पूर्वानुमान के लिए ज़रूरी डेटा की समयसीमा. रेंज, आने वाले समय में कम से कम एक पूर्णांक में होनी चाहिए. इस फ़ील्ड को दर्ज न कर पाने की स्थिति में INVALID_LABEL गड़बड़ी दिखाई देगी. time_range इनमें से सिर्फ़ एक हो सकती है:
date_time

Timestamp

वह टाइमस्टैंप जिसके लिए किसी खास समय का डेटा दिखाना है. टाइमस्टैंप को पिछले घंटे के ठीक बाद में बदल दिया जाता है.

ध्यान दें: यह सिर्फ़ अनुरोध किए गए टाइमस्टैंप के लिए, हर घंटे के हिसाब से डेटा दिखाएगा. जैसे, हर घंटे के लिए जानकारी देने वाला एक एलिमेंट. उदाहरण के लिए, अगर तारीख_time पैरामीटर को 2023-01-03T11:05:49Z पर सेट किया गया है, तो भेजे गए अनुरोध को कम करके 2023-01-03T11:00:00Z पर सेट कर दिया जाएगा.
period

Interval

उस शुरू और खत्म होने की अवधि को दिखाता है जिसके लिए पूर्वानुमान का डेटा पाना है. टाइमस्टैंप को पिछले घंटे के ठीक बाद में बदल दिया जाता है.
universal_aqi

bool

ज़रूरी नहीं. अगर वैल्यू को 'सही है' पर सेट किया जाता है, तो Universal AQI को रिस्पॉन्स के 'इंडेक्स' फ़ील्ड (डिफ़ॉल्ट = सही) में शामिल किया जाएगा.
language_code

string

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

LookupForecastResponse

एयर क्वालिटी पूर्वानुमान एपीआई का रिस्पॉन्स ऑब्जेक्ट.

फ़ील्ड
hourly_forecasts[]

HourlyForecast

ज़रूरी नहीं. इसमें, अनुरोध की गई सीमा में हर घंटे की एयर क्वालिटी की जानकारी होती है. उदाहरण के लिए, अगर अनुरोध 48 घंटों के पूर्वानुमान के लिए है, तो हर घंटे के पूर्वानुमान के 48 एलिमेंट होंगे.
region_code

string

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

string

ज़रूरी नहीं. अगला पेज फिर से पाने के लिए टोकन.

HourlyForecast

इसमें, अनुरोध की गई सीमा में हर घंटे की एयर क्वालिटी की जानकारी होती है. उदाहरण के लिए, अगर अनुरोध 48 घंटों के पूर्वानुमान के लिए है, तो हर घंटे के पूर्वानुमान के 48 एलिमेंट होंगे.

फ़ील्ड
date_time

Timestamp

एक राउंड डाउन टाइमस्टैंप, जो आरएफ़सी3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में समय (घंटे) के बारे में बताता है. उदाहरण के लिए: "2014-10-02T15:00:00Z".
indexes[]

AirQualityIndex

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

  • यूनिवर्सल AQI. universal_aqi बूलियन को सही पर सेट करने पर दिखाया जाएगा.
  • स्थानीय AQI. LOCAL_AQI अतिरिक्त कंप्यूटेशन के बताए गए तरीके के आधार पर नतीजे दिए जाएंगे.
pollutants[]

Pollutant

अनुरोध में बताई गई जगह पर असर डालने वाले कॉम्पोनेंट की सूची.

ध्यान दें: यह फ़ील्ड सिर्फ़ उन अनुरोधों के लिए दिया जाएगा जिन्होंने आगे दी गई एक या ज़्यादा अतिरिक्त गणनाएं तय की हैं: POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION.
health_recommendations

HealthRecommendations

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

LookupHeatmapTileRequest

हीटमैप टाइल के लिए अनुरोध.

यह स्ट्रक्चर, स्टैंडर्ड टाइल सर्वर जीईटी कॉल का पालन करता है, जैसे कि https://airquality.googleapis.com/v1/mapTypes/{map_type}/heatmapTiles/{zoom}/{x}/{y}

उदाहरण: https://airquality.googleapis.com/v1/mapTypes/BAQI_INDIGO_PERSIAN/heatmapTiles/1/1/1

फ़ील्ड
map_type

MapType

ज़रूरी है. एयर क्वालिटी के हीटमैप का टाइप. प्रदूषण फैलाने वाले उस कॉम्पोनेंट के बारे में बताता है जिसे मैप, ग्राफ़िक के तौर पर दिखाएगा.

Allowed values:
- UAQI_RED_GREEN (UAQI, red-green palette)
- UAQI_INDIGO_PERSIAN (UAQI, indigo-persian palette)
- PM25_INDIGO_PERSIAN
- GBR_DEFRA
- DEU_UBA
- CAN_EC
- FRA_ATMO
- US_AQI
zoom

int32

ज़रूरी है. मैप का ज़ूम लेवल. इससे तय होता है कि मैप व्यू में, मैप का कॉन्टेंट कितना बड़ा या छोटा होगा.

ज़ूम लेवल 0 पूरी दुनिया को एक ही टाइल में देख सकता है. ज़ूम लेवल 1 पूरी दुनिया को चार टाइल में देख सकता है. ज़ूम लेवल 2 पूरी दुनिया को 16 टाइल में बदल देता है. Zoom के लेवल 16 पर मौजूद पूरी दुनिया 65,536 टाइल में बदल जाएगी.

मंज़ूर किए गए मान: 0-16
x

int32

ज़रूरी है. अनुरोध की गई टाइल में, पूर्व-पश्चिम पॉइंट की जानकारी देता है.
y

int32

ज़रूरी है. अनुरोध की गई टाइल में उत्तर-दक्षिण की जानकारी देता है.

LookupHistoryRequest

एयर क्वालिटी हिस्ट्री एपीआई के अनुरोध का ऑब्जेक्ट.

फ़ील्ड
page_size

int32

ज़रूरी नहीं. हर पेज पर, हर घंटे की जाने वाली जानकारी को रिकॉर्ड करने की ज़्यादा से ज़्यादा संख्या. डिफ़ॉल्ट वैल्यू 72 और ज़्यादा से ज़्यादा वैल्यू 168 (सात दिनों का डेटा) है.
page_token

string

ज़रूरी नहीं. किसी पुराने इतिहास कॉल से पेज टोकन मिला है. इसका इस्तेमाल बाद वाले पेज को वापस पाने के लिए किया जाता है.

ध्यान दें कि इस पैरामीटर के लिए वैल्यू देते समय, दूसरे सभी पैरामीटर, उस कॉल से मेल खाने चाहिए जो पेज टोकन (पिछला कॉल) से मिला था.
location

LatLng

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

ExtraComputation

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

ColorPalette

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

CustomLocalAqi

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

Timestamp

वह टाइमस्टैंप, जिसके लिए पुराना डेटा दिखाया जाता है. टाइमस्टैंप को पिछले घंटे के ठीक बाद में बदल दिया जाता है.

ध्यान दें: यह सिर्फ़ अनुरोध किए गए टाइमस्टैंप के लिए, हर घंटे के हिसाब से डेटा दिखाएगा. जैसे, हर घंटे के लिए जानकारी देने वाला एक एलिमेंट. उदाहरण के लिए, अगर तारीख और समय पैरामीटर 2023-01-03T11:05:49Z पर सेट किया गया है, तो भेजे गए अनुरोध को कम करके 2023-01-03T11:00:00Z पर सेट कर दिया जाएगा.

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

int32

यह 1 से 720 तक की संख्या होती है, जो अनुरोध के खुले होने के समय की जानकारी देती है. उदाहरण के लिए: 48 की वैल्यू, पिछले 48 घंटों का डेटा देगी.
period

Interval

उस शुरू और खत्म होने की अवधि को दिखाता है जिसका पुराना डेटा पाना है. टाइमस्टैंप को पिछले घंटे के ठीक बाद में बदल दिया जाता है.
universal_aqi

bool

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

string

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

LookupHistoryResponse

फ़ील्ड
hours_info[]

HourInfo

ज़रूरी नहीं. इसमें, अनुरोध की गई सीमा में हर घंटे की एयर क्वालिटी की जानकारी होती है. उदाहरण के लिए, अगर अनुरोध 48 घंटों के इतिहास के लिए है, तो हर घंटे की जानकारी के 48 एलिमेंट मिलेंगे.
region_code

string

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

string

ज़रूरी नहीं. अगला पेज फिर से पाने के लिए टोकन.

HourInfo

इसमें, अनुरोध की गई सीमा में हर घंटे की एयर क्वालिटी की जानकारी होती है. उदाहरण के लिए, अगर अनुरोध 48 घंटों के इतिहास के लिए है, तो हर घंटे की जानकारी के 48 एलिमेंट मिलेंगे.

फ़ील्ड
date_time

Timestamp

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

AirQualityIndex

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

  • यूनिवर्सल AQI. यूनिवर्सलAqi बूलियन को 'सही' पर सेट करने पर दिखाया जाएगा.
  • स्थानीय AQI. LOCAL_AQI अतिरिक्त कंप्यूटेशन के बताए गए तरीके के आधार पर नतीजे दिए जाएंगे.
pollutants[]

Pollutant

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

HealthRecommendations

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

MapType

एयर क्वालिटी के हीटमैप का टाइप. प्रदूषण फैलाने वाले उस कॉम्पोनेंट के बारे में बताता है जिसे मैप, ग्राफ़िक के तौर पर दिखाएगा.

Enums
MAP_TYPE_UNSPECIFIED डिफ़ॉल्ट वैल्यू. अगर इसे पैरामीटर के तौर पर पास किया जाता है, तो सर्वर इसे अनदेखा कर देता है.
UAQI_RED_GREEN यूनिवर्सल एयर क्वालिटी इंडेक्स के लिए लाल-हरा पैलेट.
UAQI_INDIGO_PERSIAN यूनिवर्सल एयर क्वालिटी इंडेक्स इंडिगो-पर्शन पैलेट.
PM25_INDIGO_PERSIAN PM2.5 इंडेक्स इंडिगो-पर्शन पैलेट.
GBR_DEFRA डेली एयर क्वालिटी इंडेक्स (यूनाइटेड किंगडम) का रंग पटल.
DEU_UBA जर्मनी के लोकल एयर क्वालिटी इंडेक्स का रंग पटल.
CAN_EC कनेडियन एयर क्वालिटी हेल्थ इंडेक्स का रंग पटल.
FRA_ATMO फ़्रांस के एयर क्वालिटी इंडेक्स का रंग पटल.
US_AQI यूएस एयर क्वालिटी इंडेक्स का रंग पटल.

प्रदूषक

एयर क्वालिटी प्रदूषण फैलाने वाले कॉम्पोनेंट का डेटा.

फ़ील्ड
code

string

प्रदूषण फैलाने वाले कोड का नाम. उदाहरण के लिए: "so2". सभी उपलब्ध कोड की सूची यहां देखी जा सकती है.
display_name

string

प्रदूषण फैलाने वाले कॉम्पोनेंट का डिसप्ले नेम. उदाहरण के लिए: "NOx".
full_name

string

प्रदूषण फैलाने वाले कॉम्पोनेंट का पूरा नाम. रासायनिक यौगिकों के लिए, यह IUPAC का नाम है. उदाहरण: "सल्फ़र डाइऑक्साइड".

IUPAC की नाम वाली टेबल के बारे में ज़्यादा जानने के लिए, https://iupac.org/what-we-do/periodic-table-of-elements/ देखें
concentration

Concentration

वायु प्रदूषण को मापने वाली किसी स्टैंडर्ड यूनिट से, प्रदूषण फैलाने वाले कॉम्पोनेंट की मात्रा को मापा जाता है.
additional_info

AdditionalInfo

प्रदूषण फैलाने वाले कॉम्पोनेंट के बारे में ज़्यादा जानकारी.

AdditionalInfo

प्रदूषण फैलाने वाले किसी कॉम्पोनेंट के उत्सर्जन के सोर्स और सेहत पर होने वाले असर.

फ़ील्ड
sources

string

प्रदूषण फैलाने वाले मुख्य सोर्स की जानकारी देने वाला टेक्स्ट.
effects

string

प्रदूषण फैलाने वाले कॉम्पोनेंट से होने वाली मुख्य समस्या के बारे में जानकारी देने वाला टेक्स्ट.

मात्रा

हवा में, प्रदूषण फैलाने वाले किसी कॉम्पोनेंट की मात्रा.

फ़ील्ड
units

Unit

प्रदूषण फैलाने वाले इस कॉम्पोनेंट की मात्रा को मापने की इकाइयां.
value

float

प्रदूषण फैलाने वाले कॉम्पोनेंट की मात्रा का मान.

इकाई

प्रदूषण फैलाने वाले कॉम्पोनेंट की मात्रा को मापने के लिए इस्तेमाल की जाने वाली इकाई के बारे में बताता है.

Enums
UNIT_UNSPECIFIED सांद्रता की यूनिट तय नहीं है.
PARTS_PER_BILLION ppb (प्रति अरब हिस्से) सांद्रता की इकाई.
MICROGRAMS_PER_CUBIC_METER "μg/m^3" (माइक्रोग्राम प्रति घन मीटर) सांद्रता की इकाई.