जगहों के लिए एयर क्वालिटी

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

इस्तेमाल के उदाहरण और ऐडेड वैल्यू

Air Quality API के सिग्नल, खोज के अलग-अलग अनुभवों में काम आ सकते हैं. जैसे, जब लोग घूमने के लिए कोई जगह खोज रहे हों. Air Quality API की मदद से ये काम किए जा सकते हैं:

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

आस-पास की जगहों की एयर क्वालिटी में भी काफ़ी अंतर हो सकता है

सिलसिलेवार तरीके से दिए गए निर्देशों का सैंपल

उपयोगकर्ता को शुरुआत में ही हवा की क्वालिटी का डेटा दिखाना

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 का इस्तेमाल करें. जब उपयोगकर्ता मैप पर पैन, ज़ूम या जगह बदलने जैसी कार्रवाइयां करेगा, तब हीटमैप टाइलें रीफ़्रेश होंगी.

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

एयर क्वालिटी इंडेक्स के सीमित सेट में, हीटमैप मैप टाइप चुने जा सकते हैं:

  • UAQI_RED_GREEN - यूनिवर्सल एयर क्वालिटी इंडेक्स का लाल-हरा पैलेट.
  • UAQI_INDIGO_PERSIAN - यूनिवर्सल एयर क्वालिटी इंडेक्स इंडिगो-पर्शिया पैलेट.
  • PM25_INDIGO_PERSIAN - PM2.5 इंडेक्स इंडिगो-पर्शियन पैलेट.
  • GBR_DEFRA - Daily एयर क्वालिटी इंडेक्स (UK) कलर पैलेट.
  • DEU_UBA - जर्मन लोकल एयर क्वालिटी इंडेक्स की कलर पैलेट.
  • CAN_EC - Canadian Air Quality Health Index की कलर पैलेट.
  • FRA_ATMO - फ़्रांस के एयर क्वालिटी इंडेक्स का कलर पैलेट.
  • US_AQI - यूएस एयर क्वालिटी इंडेक्स के लिए कलर पैलेट.

    • पक्का करें कि आपने उपयोगकर्ताओं के लिए कलर स्केल दिया हो, ताकि वे वैल्यू और उसकी कलर रैंकिंग को समझ सकें:

    • ग्रेडिएंट स्केल यूएक्यूआई (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 */
   );
}

    • यूएक्यूआई (0-100) स्केल में मुख्य पॉइंट दिखाने के लिए, गहरे रंगों का इस्तेमाल किया जाता है: खराब / बहुत अच्छा

    क्वेरी की संख्या और उससे जुड़ी लागत

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

    नतीजा

    हमने दिखाया कि Air Quality API, उपयोगकर्ताओं के लिए एक अहम डेटा पॉइंट हो सकता है. इससे वे यह तय कर सकते हैं कि उन्हें कहां जाना है. इसलिए, एयर क्वालिटी का डेटा, सर्च के नतीजों में जल्द से जल्द दिखना चाहिए. साथ ही, यह भी ध्यान रखना चाहिए कि एक बार में कितनी जानकारी दिखाई जाए और उसे कैसे दिखाया जाए.

    अगली कार्रवाइयां

    इसके बारे में और पढ़ें:

    योगदानकर्ता

    Google इस लेख को मैनेज करता है. इस लेख को इन लोगों ने लिखा है.
    मुख्य लेखक:

    थॉमस ऐंगलरेट | सलूशन इंजीनियर