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

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

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

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

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

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

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

शुरुआत में एयर क्वालिटी का डेटा दिखाएं

Air Quality API का डेटा दिखाने के दो मुख्य तरीके हैं:

जगह की जानकारी देने वाले पिन पर, Air Quality API का डेटा दिखाएं

  • लोकेशन इंडेक्स चुनें: Universal AQI या लोकल AQI (70 अलग-अलग एयर क्वालिटी इंडेक्स (AQI) उपलब्ध हैं). एयर क्वालिटी इंडेक्स (एक्यूआई) वह स्केल होता है जिसके आधार पर कोई देश, यू.एस. ईपीए, एयर क्वालिटी के अलग-अलग लेवल को कैटगरी में बांटता है. एयर क्वालिटी का हिसाब लगाने के अलग-अलग तरीकों, डेटा सोर्स, और तय किए गए मकसद के आधार पर यह कैटगरी तय की जाती है.
  • सीधे जगह के खोज अनुभव से, 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 मैप के पूरे व्यूपोर्ट को कवर करने के लिए ज़रूरी अलग-अलग टाइल देखने के लिए, ImateMapType के साथ Maps JavaScript API का इस्तेमाल करें. जब उपयोगकर्ता पैन करके, ज़ूम करके या जगह बदलकर मैप का इस्तेमाल करेगा, तब हीटमैप टाइल रीफ़्रेश हो जाएंगी.

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

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

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

    नतीजा

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

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

    सुझाई गई अतिरिक्त रीडिंग:

    योगदानकर्ता

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

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