इस दस्तावेज़ में, आपको रिच Place Search अनुभव बनाने के लिए, Air Quality API को इस्तेमाल करने का तरीका बताया गया है. हम आपको बताएंगे कि एयर क्वालिटी का डेटा, फ़नल की शुरुआत से लेकर आखिर तक, उपयोगकर्ताओं के लिए किस तरह फ़ायदेमंद हो सकता है. साथ ही, हम यह भी बताएंगे कि Air Quality API के डेटा को मौजूदा अनुभवों में कैसे एम्बेड किया जा सकता है.

इस्तेमाल के उदाहरण और ऐडेड वैल्यू
Air Quality API के सिग्नल, खोज के अलग-अलग अनुभवों में फ़िट हो सकते हैं. जैसे, जब उपयोगकर्ता घूमने के लिए कोई जगह खोज रहे हों. Air Quality API में ये सुविधाएं मिलती हैं:
- रीयल टाइम * और पुराना डेटा - नया और सटीक डेटा, जो मौजूदा स्थिति के साथ-साथ पिछले 30 दिनों के डेटा को हर घंटे के रिज़ॉल्यूशन में दिखाता है. (* घर के बाहर की एयर क्वालिटी का हर घंटे का स्नैपशॉट)
- ग्लोबल और स्थानीय डेटा - Air Quality API, 100 से ज़्यादा देशों के पूरे इलाकों को कवर करता है. साथ ही, यह 500 मीटर तक के दायरे में मौजूद इलाकों के लिए, हवा की क्वालिटी का डेटा उपलब्ध कराता है. इससे उपयोगकर्ताओं को अलग-अलग जगहों की तुलना करने और सबसे सही जगह चुनने में मदद मिलती है.

आस-पास की जगहों की एयर क्वालिटी में भी काफ़ी अंतर हो सकता है
सिलसिलेवार तरीके से दिए गए निर्देशों का सैंपल
एयर क्वालिटी का डेटा, खोज के नतीजों में सबसे ऊपर दिखाना
Air Quality API का डेटा दिखाने के दो मुख्य तरीके हैं:
Current conditions / hourly: हर जगह के लिए अलग-अलग वैल्यू पाएं.
(इस सेक्शन पर जाएं: जगह के पिन पर Air Quality API का डेटा दिखाना)हीटमैप टाइल: मैप के ऊपर, घर के बाहर की मौजूदा एयर क्वालिटी को दिखाने वाली रंगीन लेयर ओवरले करें. देश के हिसाब से लेयर इंडेक्स उपलब्ध हैं.
(इस सेक्शन पर जाएं: मैप पर Air Quality API की हीटमैप लेयर दिखाएं)
जगह की जानकारी दिखाने वाली पिन पर, Air Quality API का डेटा दिखाना
- अपनी जगह का इंडेक्स चुनें: यूनिवर्सल एक्यूआई या स्थानीय एक्यूआई. 70 अलग-अलग एयर क्वालिटी इंडेक्स (एक्यूआई) उपलब्ध हैं. एयर क्वालिटी इंडेक्स (एक्यूआई) एक ऐसा स्केल है जिससे कोई देश, जैसे कि अमेरिका का ईपीए, एयर क्वालिटी के अलग-अलग लेवल को कैटगरी में बांटता है. इसके लिए, हिसाब लगाने के अलग-अलग तरीके, डेटा सोर्स, और तय किए गए मकसद इस्तेमाल किए जाते हैं.
- जगह खोजने की सुविधा से, Air Quality API की मुख्य वैल्यू और कलर कोड को सीधे तौर पर विज़ुअलाइज़ करना शुरू करें.
डिफ़ॉल्ट डिसप्ले में सिर्फ़ कलर कोड शामिल हो सकता है.
पिन चुनने पर, 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 की हीटमैप लेयर दिखाना
हीटमैप की रंगीन टाइलें, इन कामों के लिए बेहतरीन तरीका हैं:
- इससे बड़े इलाके की खास जानकारी मिलती है.
- उस इलाके की बारीकियों को तुरंत दिखाने के लिए.

Maps JavaScript API का इस्तेमाल ImateMapType के साथ करें, ताकि Google मैप के पूरे व्यूपोर्ट को कवर करने के लिए ज़रूरी अलग-अलग टाइल दिखाई जा सकें. जब उपयोगकर्ता मैप पर पैन, ज़ूम या जगह बदलने जैसी कोई गतिविधि करेगा, तो हीटमैप टाइल रीफ़्रेश हो जाएंगी.

ध्यान रखें कि ज़ूम करने के लेवल की वैल्यू 16 तक हो सकती है.
हाइपरलोकल सर्च के दौरान, Air Quality API के हीटमैप की टाइल लेयर दिखना बंद हो सकती है.

एयर क्वालिटी इंडेक्स के सीमित सेट में, हीटमैप के टाइप चुने जा सकते हैं:
उपयोगकर्ताओं को वैल्यू और उसके रंग की रैंकिंग समझाने के लिए, कलर स्केल ज़रूर दिखाएं:
- ग्रेडिएंट स्केल यूएक्यूआई (0-100):
खराब / बहुत अच्छा
कलर पैलेट का सीएसएस कोड स्निपेट:
.gradient-scale { background: linear-gradient(to right, rgb(99, 20, 161) 0%, /* purple */ rgb(149, 0, 25) 20%, /* red */ rgb(248, 47, 21) 40%, /* orange */ rgb(255, 248, 35) 60%, /* yellow */ rgb(34,163,120) 80%, /* steelblue */ rgb(255,255,255) 100% /* white */ ); }
- UAQI (0-100) स्केल में मुख्य पॉइंट दिखाने के लिए, सॉलिड कलर:
खराब / बहुत अच्छा

क्वेरी की संख्या और उनसे जुड़ी लागत
- Maps JavaScript API: अनुभव लोड होने पर एक मैप.
- Air Quality API:
- हर जगह के लिए एक क्वेरी (सभी जगहें मैप लोड होने पर या सिर्फ़ उपयोगकर्ता के चुनने पर).
- हीटमैप टाइल लेयर: हर टाइल इमेज 256*256 पिक्सल की होती है. मोबाइल डिवाइस या वेब पर दिखाए जाने वाले स्टैंडर्ड मैप को कवर करने के लिए, आपको 12 से 14 टाइल की ज़रूरत होती है. खींची गई हर टाइल को एक एसकेयू यूनिट के तौर पर गिना जाता है.
- आस-पास की जगहों की जानकारी (नया) API: दिखाई गई हर 20 जगहों के लिए एक क्वेरी. क्वेरी के जवाब में शामिल जगह की जानकारी के हिसाब से अलग-अलग बिलिंग.
नतीजा
हमने बताया कि Air Quality API, उपयोगकर्ताओं के लिए एक अहम डेटा पॉइंट हो सकता है. इससे उन्हें किसी जगह पर जाने का फ़ैसला लेने में मदद मिलती है. इसलिए, खोज के नतीजों में एयर क्वालिटी का डेटा जल्द से जल्द दिखना चाहिए. साथ ही, यह ध्यान रखना चाहिए कि एक बार में कितनी जानकारी दिखाई जाए और उसे किस तरह दिखाया जाए.
अगली कार्रवाइयां
इस बारे में और पढ़ें:
- Nearby Search (New) API की मदद से, आस-पास की जगहों की जानकारी खोजने की सुविधा को बेहतर बनाना
- डेटा-ड्रिवन स्टाइलिंग की मदद से, रीयल टाइम में अपना डेटा देखना
योगदानकर्ता
Google इस लेख को मैनेज करता है. इसे मूल रूप से इन योगदान देने वालों ने लिखा है.
मुख्य लेखक:
थॉमस आंग्लारे | सलूशन इंजीनियर