এয়ার কোয়ালিটি API ব্যবহার করে জায়গাগুলির জন্য বায়ুর গুণমান সচেতনতা

এই ডকুমেন্টে, আপনি দেখবেন কিভাবে Air Quality API ব্যবহার করে সমৃদ্ধ স্থান অনুসন্ধান অভিজ্ঞতা তৈরি করতে হয়। আমরা দেখাবো কিভাবে Funnel এর শুরু থেকে শেষ পর্যন্ত ব্যবহারকারীদের জন্য বায়ুর গুণমান একটি মূল্যবান সংকেত হতে পারে এবং কিভাবে Air Quality API ডেটা বিদ্যমান অভিজ্ঞতায় এম্বেড করা যেতে পারে।

ব্যবহারের ধরণ এবং অতিরিক্ত মূল্য

এয়ার কোয়ালিটি এপিআই সিগন্যাল বিভিন্ন অনুসন্ধান অভিজ্ঞতার সাথে মানানসই হতে পারে, যেমন যখন ব্যবহারকারীরা কোনও স্থান পরিদর্শনের জন্য খুঁজছেন। এয়ার কোয়ালিটি এপিআই অফার করে:

  • রিয়েল টাইম * এবং ঐতিহাসিক তথ্য - তাজা, নির্ভুল তথ্য যা বর্তমান অবস্থা এবং সেই সাথে 30 দিনের মধ্যে প্রতি ঘন্টায় রেজোলিউশনে পূর্ববর্তী সময়ের তথ্য উপস্থাপন করে। (* বাইরের বাতাসের মানের একটি ঘন্টায় স্ন্যাপশট)
  • বিশ্বব্যাপী এবং স্থানীয় তথ্য - ১০০+ দেশের সমগ্র এলাকা কভার করে, কিন্তু অত্যন্ত স্থানীয় (৫০০ মিটার পর্যন্ত)। এয়ার কোয়ালিটি এপিআই ডেটা ব্যবহারকারীদের তুলনা করার এবং সবচেয়ে উপযুক্ত স্থানের বিষয়ে সিদ্ধান্ত নেওয়ার জন্য গুরুত্বপূর্ণ সংকেত প্রদান করে।

কাছাকাছি স্থানের জন্যও বাতাসের মান ব্যাপকভাবে পরিবর্তিত হতে পারে।

নমুনা ওয়াকথ্রু

অভিজ্ঞতার শুরুতেই বায়ুর মানের ডেটা দেখান

এয়ার কোয়ালিটি এপিআই ডেটা দেখানোর দুটি প্রধান উপায় রয়েছে:

লোকেশন পিনে এয়ার কোয়ালিটি API ডেটা প্রদর্শন করুন

  • আপনার অবস্থান সূচক নির্বাচন করুন: সর্বজনীন AQI অথবা একটি স্থানীয় AQI (সর্বাধিক 70টি ভিন্ন বায়ু মানের সূচক (AQI) উপলব্ধ)। একটি বায়ু মানের সূচক (AQI) হল সেই স্কেল যার মাধ্যমে একটি নির্দিষ্ট দেশ, উদাহরণস্বরূপ, মার্কিন EPA , বিভিন্ন গণনা পদ্ধতি, তথ্য উৎস এবং নির্ধারিত উদ্দেশ্যের উপর ভিত্তি করে বিভিন্ন বায়ু মানের স্তরকে শ্রেণীবদ্ধ করে।
  • স্থান অনুসন্ধানের অভিজ্ঞতা থেকে সরাসরি মূল এয়ার কোয়ালিটি এপিআই মান এবং রঙের কোডটি কল্পনা করা শুরু করুন।

ডিফল্ট ডিসপ্লেতে শুধুমাত্র রঙের কোড অন্তর্ভুক্ত থাকতে পারে।


পিন নির্বাচনের উপর আরও এয়ার কোয়ালিটি 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": …
    }
}

  • বিকল্পভাবে, আপনি শুধুমাত্র কোনও অবস্থানের সাথে মিথস্ক্রিয়ার ভিত্তিতে বায়ু মানের ডেটা জিজ্ঞাসা করতে পারেন।

  • আপনি কাছাকাছি স্থানগুলি ফিল্টার করার জন্য এয়ার কোয়ালিটি এপিআই সূচক ব্যবহার করতে পারেন, যেমন: আপনি যদি আপনার এলাকায় পার্ক খুঁজছেন, তাহলে আপনাকে শুধুমাত্র ভালো বায়ু মানের পার্কগুলি দেখাবে।

বায়ু মানের প্রতিক্রিয়া

...
"color":{
  "red": 0.9490196,
  "green": 0.98039216,
  "blue": 0.019607844
}
...
RGB তে রূপান্তর করুন
  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)

একটি মানচিত্রে এয়ার কোয়ালিটি API হিটম্যাপ স্তর প্রদর্শন করুন

হিটম্যাপ রঙিন টাইলস একটি দুর্দান্ত উপায়:

  • একটি বৃহৎ এলাকার সারসংক্ষেপ প্রদান করতে।
  • দ্রুত সেই এলাকার সূক্ষ্মতা প্রদর্শন করতে।

আপনার গুগল ম্যাপের সম্পূর্ণ ভিউপোর্ট কভার করার জন্য প্রয়োজনীয় পৃথক টাইলগুলি প্রদর্শন করতে ImateMapType সহ Maps JavaScript 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): খারাপ / চমৎকার

    রঙ প্যালেট CSS কোড স্নিপেট:

    .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) স্কেলে মূল বিষয়টি বোঝাতে কঠিন রঙ: খারাপ / চমৎকার

    প্রশ্নের সংখ্যা এবং সংশ্লিষ্ট খরচ

    • ম্যাপস জাভাস্ক্রিপ্ট এপিআই : অভিজ্ঞতা লোড করার সময় ১টি ম্যাপ।
    • বায়ুর গুণমান API :
      • প্রতিটি স্থানে ১টি করে প্রশ্ন (সমস্ত মানচিত্র লোডে অথবা শুধুমাত্র ব্যবহারকারী নির্বাচনের উপর)।
      • হিটম্যাপ টাইল স্তর: প্রতিটি টাইল চিত্র 256*256px এবং একটি মোবাইল ডিভাইস বা ওয়েবে উপস্থাপিত একটি স্ট্যান্ডার্ড মানচিত্র কভার করতে আপনার 12-14 টি টাইল প্রয়োজন। টানা প্রতিটি টাইল 1 SKU ইউনিট হিসাবে গণনা করা হয়।
    • কাছাকাছি অনুসন্ধান (নতুন) API : প্রতি ২০টি স্থানে ১টি করে কোয়েরি প্রদর্শিত হয়। কোয়েরি প্রতিক্রিয়ার অংশ হিসেবে স্থানের ডেটা অনুসারে বিভিন্ন বিলিং।

    উপসংহার

    আমরা দেখিয়েছি যে ব্যবহারকারীদের ভ্রমণের স্থান নির্ধারণের জন্য এয়ার কোয়ালিটি এপিআই একটি গুরুত্বপূর্ণ ডেটা পয়েন্ট হতে পারে। অতএব, অনুসন্ধানের অভিজ্ঞতায় এয়ার কোয়ালিটি ডেটা যত তাড়াতাড়ি সম্ভব দৃশ্যমান হওয়া উচিত, একবারে প্রদর্শিত তথ্যের পরিমাণ এবং এটি কীভাবে দৃশ্যমান করা হবে সেদিকে খেয়াল রেখে।

    পরবর্তী পদক্ষেপ

    আরও পড়ার জন্য প্রস্তাবিত:

    অবদানকারীরা

    গুগল এই নিবন্ধটি সংরক্ষণ করে। নিম্নলিখিত অবদানকারীরা মূলত এটি লিখেছিলেন।
    প্রধান লেখক:

    টমাস অ্যাংলারেট | সলিউশন ইঞ্জিনিয়ার

    ,

    এই ডকুমেন্টে, আপনি দেখবেন কিভাবে Air Quality API ব্যবহার করে সমৃদ্ধ স্থান অনুসন্ধান অভিজ্ঞতা তৈরি করতে হয়। আমরা দেখাবো কিভাবে Funnel এর শুরু থেকে শেষ পর্যন্ত ব্যবহারকারীদের জন্য বায়ুর গুণমান একটি মূল্যবান সংকেত হতে পারে এবং কিভাবে Air Quality API ডেটা বিদ্যমান অভিজ্ঞতায় এম্বেড করা যেতে পারে।

    ব্যবহারের ধরণ এবং অতিরিক্ত মূল্য

    এয়ার কোয়ালিটি এপিআই সিগন্যাল বিভিন্ন অনুসন্ধান অভিজ্ঞতার সাথে মানানসই হতে পারে, যেমন যখন ব্যবহারকারীরা কোনও স্থান পরিদর্শনের জন্য খুঁজছেন। এয়ার কোয়ালিটি এপিআই অফার করে:

    • রিয়েল টাইম * এবং ঐতিহাসিক তথ্য - তাজা, নির্ভুল তথ্য যা বর্তমান অবস্থা এবং সেই সাথে 30 দিনের মধ্যে প্রতি ঘন্টায় রেজোলিউশনে পূর্ববর্তী সময়ের তথ্য উপস্থাপন করে। (* বাইরের বাতাসের মানের একটি ঘন্টায় স্ন্যাপশট)
    • বিশ্বব্যাপী এবং স্থানীয় তথ্য - ১০০+ দেশের সমগ্র এলাকা কভার করে, কিন্তু অত্যন্ত স্থানীয় (৫০০ মিটার পর্যন্ত)। এয়ার কোয়ালিটি এপিআই ডেটা ব্যবহারকারীদের তুলনা করার এবং সবচেয়ে উপযুক্ত স্থানের বিষয়ে সিদ্ধান্ত নেওয়ার জন্য গুরুত্বপূর্ণ সংকেত প্রদান করে।

    কাছাকাছি স্থানের জন্যও বাতাসের মান ব্যাপকভাবে পরিবর্তিত হতে পারে।

    নমুনা ওয়াকথ্রু

    অভিজ্ঞতার শুরুতেই বায়ুর মানের ডেটা দেখান

    এয়ার কোয়ালিটি এপিআই ডেটা দেখানোর দুটি প্রধান উপায় রয়েছে:

    লোকেশন পিনে এয়ার কোয়ালিটি API ডেটা প্রদর্শন করুন

    • আপনার অবস্থান সূচক নির্বাচন করুন: সর্বজনীন AQI অথবা একটি স্থানীয় AQI (সর্বাধিক 70টি ভিন্ন বায়ু মানের সূচক (AQI) উপলব্ধ)। একটি বায়ু মানের সূচক (AQI) হল সেই স্কেল যার মাধ্যমে একটি নির্দিষ্ট দেশ, উদাহরণস্বরূপ, মার্কিন EPA , বিভিন্ন গণনা পদ্ধতি, তথ্য উৎস এবং নির্ধারিত উদ্দেশ্যের উপর ভিত্তি করে বিভিন্ন বায়ু মানের স্তরকে শ্রেণীবদ্ধ করে।
    • স্থান অনুসন্ধানের অভিজ্ঞতা থেকে সরাসরি মূল এয়ার কোয়ালিটি এপিআই মান এবং রঙের কোডটি কল্পনা করা শুরু করুন।

    ডিফল্ট ডিসপ্লেতে শুধুমাত্র রঙের কোড অন্তর্ভুক্ত থাকতে পারে।


    পিন নির্বাচনের উপর আরও এয়ার কোয়ালিটি 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": …
        }
    }
    
    
    • বিকল্পভাবে, আপনি শুধুমাত্র কোনও অবস্থানের সাথে মিথস্ক্রিয়ার ভিত্তিতে বায়ু মানের ডেটা জিজ্ঞাসা করতে পারেন।

    • আপনি কাছাকাছি স্থানগুলি ফিল্টার করার জন্য এয়ার কোয়ালিটি এপিআই সূচক ব্যবহার করতে পারেন, যেমন: আপনি যদি আপনার এলাকায় পার্ক খুঁজছেন, তাহলে আপনাকে শুধুমাত্র ভালো বায়ু মানের পার্কগুলি দেখাবে।

    বায়ু মানের প্রতিক্রিয়া

    ...
    "color":{
      "red": 0.9490196,
      "green": 0.98039216,
      "blue": 0.019607844
    }
    ...
    RGB তে রূপান্তর করুন
      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)

    একটি মানচিত্রে এয়ার কোয়ালিটি API হিটম্যাপ স্তর প্রদর্শন করুন

    হিটম্যাপ রঙিন টাইলস একটি দুর্দান্ত উপায়:

    • একটি বৃহৎ এলাকার সারসংক্ষেপ প্রদান করতে।
    • দ্রুত সেই এলাকার সূক্ষ্মতা প্রদর্শন করতে।

    আপনার গুগল ম্যাপের সম্পূর্ণ ভিউপোর্ট কভার করার জন্য প্রয়োজনীয় পৃথক টাইলগুলি প্রদর্শন করতে ImateMapType সহ Maps JavaScript 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): খারাপ / চমৎকার

    রঙ প্যালেট CSS কোড স্নিপেট:

    .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) স্কেলে মূল বিষয়টি বোঝাতে কঠিন রঙ: খারাপ / চমৎকার

    প্রশ্নের সংখ্যা এবং সংশ্লিষ্ট খরচ

    • ম্যাপস জাভাস্ক্রিপ্ট এপিআই : অভিজ্ঞতা লোড করার সময় ১টি ম্যাপ।
    • বায়ুর গুণমান API :
      • প্রতিটি স্থানে ১টি করে প্রশ্ন (সমস্ত মানচিত্র লোডে অথবা শুধুমাত্র ব্যবহারকারী নির্বাচনের উপর)।
      • হিটম্যাপ টাইল স্তর: প্রতিটি টাইল চিত্র 256*256px এবং একটি মোবাইল ডিভাইস বা ওয়েবে উপস্থাপিত একটি স্ট্যান্ডার্ড মানচিত্র কভার করতে আপনার 12-14 টি টাইল প্রয়োজন। টানা প্রতিটি টাইল 1 SKU ইউনিট হিসাবে গণনা করা হয়।
    • কাছাকাছি অনুসন্ধান (নতুন) API : প্রতি ২০টি স্থানে ১টি করে কোয়েরি প্রদর্শিত হয়। কোয়েরি প্রতিক্রিয়ার অংশ হিসেবে স্থানের ডেটা অনুসারে বিভিন্ন বিলিং।

    উপসংহার

    আমরা দেখিয়েছি যে ব্যবহারকারীদের ভ্রমণের স্থান নির্ধারণের জন্য এয়ার কোয়ালিটি এপিআই একটি গুরুত্বপূর্ণ ডেটা পয়েন্ট হতে পারে। অতএব, অনুসন্ধানের অভিজ্ঞতায় এয়ার কোয়ালিটি ডেটা যত তাড়াতাড়ি সম্ভব দৃশ্যমান হওয়া উচিত, একবারে প্রদর্শিত তথ্যের পরিমাণ এবং এটি কীভাবে দৃশ্যমান করা হবে সেদিকে খেয়াল রেখে।

    পরবর্তী পদক্ষেপ

    আরও পড়ার জন্য প্রস্তাবিত:

    অবদানকারীরা

    গুগল এই নিবন্ধটি সংরক্ষণ করে। নিম্নলিখিত অবদানকারীরা মূলত এটি লিখেছিলেন।
    প্রধান লেখক:

    টমাস অ্যাংলারেট | সলিউশন ইঞ্জিনিয়ার