इस दस्तावेज़ में, जगह के बारे में खोज के बेहतर अनुभव देने के लिए, Air Quality API का इस्तेमाल करने का तरीका बताया गया है. हम यह दिखाएंगे कि एयर क्वालिटी, फ़नल की शुरुआत से लेकर आखिर तक उपयोगकर्ताओं के लिए कैसे एक अहम सिग्नल हो सकती है. साथ ही, यह भी दिखाएंगे कि Air Quality API के डेटा को मौजूदा अनुभवों में कैसे एम्बेड किया जा सकता है.
इस्तेमाल के उदाहरण और जोड़ी गई नई जानकारी
Air Quality API के सिग्नल, खोज के अलग-अलग अनुभवों में काम आ सकते हैं. जैसे, जब लोग घूमने के लिए कोई जगह खोज रहे हों. Air Quality API की मदद से ये काम किए जा सकते हैं:
- रीयल टाइम * और पुराना डेटा - नया और सटीक डेटा, जो मौजूदा स्थिति के साथ-साथ पिछले 30 दिनों के डेटा को दिखाता है. यह डेटा, हर घंटे के हिसाब से उपलब्ध होता है. (* घर के बाहर की एयर क्वालिटी की हर घंटे की जानकारी)
- ग्लोबल और स्थानीय डेटा - यह 100 से ज़्यादा देशों के सभी इलाकों को कवर करता है. साथ ही, यह स्थानीय स्तर पर (500 मीटर तक) एयर क्वालिटी एपीआई का डेटा उपलब्ध कराता है. इससे उपयोगकर्ताओं को अहम सिग्नल मिलते हैं, ताकि वे तुलना करके सबसे सही जगह के बारे में फ़ैसले ले सकें.
आस-पास की जगहों की एयर क्वालिटी में भी काफ़ी अंतर हो सकता है
सिलसिलेवार तरीके से दिए गए निर्देशों का सैंपल
उपयोगकर्ता को शुरुआत में ही हवा की क्वालिटी का डेटा दिखाना
Air Quality API का डेटा दिखाने के दो मुख्य तरीके हैं:
मौजूदा मौसम की स्थिति / हर घंटे: हर जगह के लिए अलग-अलग वैल्यू पाएं.
(इस सेक्शन पर जाएं: जगह के पिन पर एयर क्वालिटी एपीआई का डेटा दिखाना)हीटमैप टाइलें: अपने मैप के ऊपर, रंगीन लेयर को ओवरले करें. यह लेयर, घर के बाहर की हवा की क्वालिटी की मौजूदा स्थिति को दिखाती है. देश के हिसाब से लेयर इंडेक्स उपलब्ध हैं.
(इस सेक्शन पर जाएं: मैप पर Air Quality API की हीटमैप लेयर दिखाना)
जगह के पिन पर Air Quality API का डेटा दिखाना
- अपनी जगह का इंडेक्स चुनें: यूनिवर्सल एक्यूआई या स्थानीय एक्यूआई. 70 अलग-अलग एयर क्वालिटी इंडेक्स (एक्यूआई) उपलब्ध हैं. एयर क्वालिटी इंडेक्स (एक्यूआई) एक ऐसा स्केल होता है जिससे कोई देश, जैसे कि U.S. EPA, एयर क्वालिटी के अलग-अलग लेवल को कैटगरी में बांटता है. यह अलग-अलग कैलकुलेशन के तरीकों, डेटा सोर्स, और तय किए गए मकसद के आधार पर किया जाता है.
- जगह की खोज के दौरान ही, एयर क्वालिटी एपीआई की मुख्य वैल्यू और कलर कोड देखना शुरू करें.
डिफ़ॉल्ट डिसप्ले में सिर्फ़ रंग का कोड शामिल हो सकता है.
पिन चुनने पर, Air Quality API की ज़्यादा जानकारी दिखाएं:
- यूनिवर्सल एक्यूआई / लोकल एक्यूआई का मतलब.
- प्रदूषण फैलाने वाले कारकों का लेवल, जो हवा में मौजूद कणों और गैसों को मेज़र करता है: प्रदूषण फैलाने वाला मुख्य कारक, उसकी मात्रा, स्रोत, और असर.
- सेहत से जुड़े सुझाव. ये सुझाव, एयर क्वालिटी की मौजूदा स्थितियों के हिसाब से सुझाई गई कार्रवाइयां होती हैं.
- अपनी ज़रूरतों के हिसाब से, डिफ़ॉल्ट रूप से दिखने वाली जानकारी के लेवल को अडजस्ट किया जा सकता है. ध्यान रखें कि किसी जगह के डेटा पॉइंट, अक्सर दूसरी जगहों के मुकाबले ज़्यादा काम के होते हैं.
एयर क्वालिटी सेक्शन दिखाने का उदाहरण
{
"dateTime": "2023-08-09T10:00:00Z",
"regionCode": "fr",
"indexes": [
{
"code": "uaqi",
"displayName": "Universal AQI",
"aqi": 76,
"aqiDisplay": "76",
"color": {
"red": 0.4117647,
"green": 0.77254903,
"blue": 0.20392157
},
"category": "Good air quality",
"dominantPollutant": "pm10"
},
…
],
"pollutants": [
{
"code": "co",
"displayName": "CO",
"fullName": "Carbon monoxide",
"concentration": {
"value": 95.18,
"units": "PARTS_PER_BILLION"
}...
},
…
],
"healthRecommendations": -{
"generalPopulation": "With this level of air quality, you have no limitations. Enjoy the outdoors!",
"elderly": "If you start to feel respiratory discomfort such as coughing or breathing difficulties, consider red ...",
"lungDiseasePopulation": …
}
}
- इसके अलावा, किसी जगह के साथ इंटरैक्ट करने पर ही एयर क्वालिटी के डेटा के बारे में क्वेरी की जा सकती है.
- आस-पास की जगहों को फ़िल्टर करने के लिए, Air Quality API इंडेक्स का इस्तेमाल किया जा सकता है. जैसे: अगर आपको अपने इलाके में पार्क ढूंढने हैं, तो आपको सिर्फ़ वे पार्क दिखेंगे जहां की एयर क्वालिटी अच्छी है.
एयर क्वालिटी की जानकारी देने वाली सुविधा
... "color":{ "red": 0.9490196, "green": 0.98039216, "blue": 0.019607844 } ...
var red = parseInt(colorResponse.red*255)|| 1; var green = parseInt(colorResponse.green*255)|| 1; var blue = parseInt(colorResponse.blue*255)|| 1; // --> output rgb(241,250,5)
मैप पर Air Quality API की हीटमैप लेयर दिखाना
रंग वाली हीटमैप टाइलें, इन कामों के लिए बहुत अच्छी होती हैं:
- ताकि बड़े इलाके की खास जानकारी दी जा सके.
- ताकि उस इलाके की बारीकियां तुरंत दिखाई जा सकें.
अपने Google मैप के पूरे व्यूपोर्ट को कवर करने के लिए ज़रूरी अलग-अलग टाइल दिखाने के लिए, ImateMapType के साथ Maps JavaScript API का इस्तेमाल करें. उपयोगकर्ता के मैप पर पैन करने, ज़ूम करने या जगह बदलने पर, हीटमैप टाइलें रीफ़्रेश हो जाएंगी.
