Air Quality API का इस्तेमाल करके, जगहों की एयर क्वालिटी के बारे में जागरूकता

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

केस और ऐडेड वैल्यू का इस्तेमाल करें

Air Quality एपीआई सिग्नल, खोज के अलग-अलग अनुभवों में फ़िट हो सकते हैं. जैसे, जब उपयोगकर्ता किसी जगह पर जाने के लिए खोज रहे हों. Air Quality एपीआई के ऑफ़र:

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

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

सिलसिलेवार निर्देश का सैंपल

प्रयोग के शुरू होने से पहले, एयर क्वालिटी का डेटा दिखाएं

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 की हीटमैप लेयर दिखाना

हीटमैप की रंगीन टाइल का इस्तेमाल करके:

  • का इस्तेमाल करके, बड़े इलाके की खास जानकारी दी जा सकती है.
  • का इस्तेमाल करके, उस इलाके के बारे में तुरंत जानकारी पाएं.

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

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

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

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

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

    • ग्रेडिएंट स्केल UAQI (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 टाइल की ज़रूरत होती है. खींची गई हर टाइल को एक SKU यूनिट के तौर पर गिना जाता है.
    • Nearby Search (नया) API: हर 20 जगहों के लिए एक क्वेरी दिखाई जाती है. क्वेरी के जवाब में शामिल जगह के डेटा के हिसाब से अलग-अलग बिलिंग.

    नतीजा

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

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

    और पढ़ने के लिए सुझाया गया तरीका:

    योगदानकर्ता

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

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