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

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

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

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

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

এমনকি কাছাকাছি স্থানগুলোর মধ্যেও বায়ুর গুণমান ব্যাপকভাবে ভিন্ন হতে পারে।

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

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

বায়ুর গুণমান এপিআই ডেটা দেখানোর দুটি প্রধান উপায় রয়েছে:

• বর্তমান অবস্থা / ঘণ্টাভিত্তিক : প্রতিটি অবস্থানের বিপরীতে প্রদর্শনের জন্য স্বতন্ত্র মানগুলো নিন।
  (বিভাগে যান: অবস্থান পিনগুলিতে বায়ুর গুণমান এপিআই ডেটা প্রদর্শন করুন )
  

• হিটম্যাপ টাইলস : আপনার মানচিত্রের উপরে বর্তমান বাইরের বাতাসের গুণমানের অবস্থা তুলে ধরে এমন একটি রঙিন স্তর স্থাপন করে। দেশ-ভিত্তিক স্তরের সূচক উপলব্ধ আছে।
  (বিভাগে যান: মানচিত্রে বায়ুর গুণমান এপিআই হিটম্যাপ স্তর প্রদর্শন করুন )
  

অবস্থান পিনগুলিতে বায়ুর গুণমান এপিআই ডেটা প্রদর্শন করুন

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

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

পিন নির্বাচনের উপর ভিত্তি করে আরও বায়ু গুণমান এপিআই তথ্য প্রদর্শন করুন:

• সার্বজনীন AQI / স্থানীয় AQI এর অর্থ।
  
• দূষণকারী পদার্থের মাত্রা , যা বাতাসে থাকা কণা ও গ্যাসের পরিমাপ: প্রধান দূষণকারী, ঘনত্ব, উৎস ও প্রভাব।
• স্বাস্থ্য বিষয়ক সুপারিশ , যা বর্তমান বায়ুর গুণগত অবস্থার জন্য প্রস্তাবিত পদক্ষেপসমূহ।

পরামর্শ: কাস্টম মার্কার তৈরি করতে এবং মার্কারের সংঘর্ষ নিয়ন্ত্রণ করতে অ্যাডভান্সড মার্কার ব্যবহার করুন।

• আপনার প্রয়োজন অনুযায়ী আপনি ডিফল্টরূপে প্রদর্শিত তথ্যের মাত্রা সমন্বয় করতে পারেন। মনে রাখবেন যে, কোনো একটি স্থানের তথ্য প্রায়শই অন্যান্য স্থানের তুলনায় বেশি কার্যকর হয়।

বায়ুর গুণমান বিভাগের প্রদর্শনের উদাহরণ

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

{
    "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)

মানচিত্রে বায়ুর গুণমান এপিআই হিটম্যাপ স্তর প্রদর্শন করুন

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

• একটি বৃহৎ এলাকার সার্বিক চিত্র প্রদান করতে।
• সেই এলাকার মধ্যেকার সূক্ষ্ম বিষয়গুলো দ্রুত তুলে ধরতে।

আপনার গুগল ম্যাপের সম্পূর্ণ ভিউপোর্ট জুড়ে প্রয়োজনীয় স্বতন্ত্র টাইলসগুলো প্রদর্শন করতে Maps JavaScript API- এর ImateMapType ব্যবহার করুন। ব্যবহারকারী যখন প্যানিং, জুমিং বা অবস্থান পরিবর্তনের মাধ্যমে ম্যাপটি ব্যবহার করবেন, তখন হিটম্যাপ টাইলসগুলো রিফ্রেশ হবে।

পরামর্শ: যদি আপনি ম্যাপের উপরে বেসম্যাপের আগ্রহের স্থান এবং মার্কারগুলো প্রদর্শন করতে চান, তাহলে deck.gl-এর সাথে GoogleMapsOverlay ব্যবহার করুন এবং একটি নতুন TileLayer তৈরি করুন।

মনে রাখবেন, অনুমোদিত জুম লেভেলের মান সর্বোচ্চ ১৬ পর্যন্ত।
হাইপারলোকাল সার্চের সময় এয়ার কোয়ালিটি এপিআই হিটম্যাপ টাইল লেয়ারটি অদৃশ্য হয়ে যেতে পারে।

আপনি সীমিত সংখ্যক বায়ু গুণমান সূচকের মধ্য থেকে হিটম্যাপের প্রকারভেদ নির্বাচন করতে পারেন:

UAQI_RED_GREEN - সার্বজনীন বায়ু গুণমান সূচকের লাল-সবুজ প্যালেট।

UAQI_INDIGO_PERSIAN - সার্বজনীন বায়ু গুণমান সূচক ইন্ডিগো-পার্সিয়ান প্যালেট।

PM25_INDIGO_PERSIAN - PM2.5 সূচক ইন্ডিগো-পার্সিয়ান প্যালেট।

GBR_DEFRA - দৈনিক বায়ু গুণমান সূচক (যুক্তরাজ্য) রঙের প্যালেট।

DEU_UBA - জার্মান স্থানীয় বায়ুর গুণমান সূচকের রঙের প্যালেট।

CAN_EC - কানাডিয়ান এয়ার কোয়ালিটি হেলথ ইনডেক্স কালার প্যালেট।

FRA_ATMO - ফ্রান্সের বায়ুর গুণমান সূচকের রঙের প্যালেট।

US_AQI - মার্কিন বায়ুর গুণমান সূচকের রঙের প্যালেট।

ব্যবহারকারীরা যাতে এর মান এবং রঙের ক্রম বুঝতে পারে, সেজন্য রঙের স্কেলটি অবশ্যই উল্লেখ করুন:

• গ্রেডিয়েন্ট স্কেল UAQI (০-১০০): খারাপ / চমৎকার

কালার প্যালেট 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 (০-১০০) স্কেলে মূল পয়েন্ট বোঝানোর জন্য একক রঙ: খারাপ / চমৎকার

কোয়েরির সংখ্যা এবং সংশ্লিষ্ট খরচ

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

উপসংহার

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

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

আরও পড়ার জন্য পরামর্শ:

• Nearby Search (নতুন) API-এর মাধ্যমে স্থানীয় অনুসন্ধান উন্নত করুন
• ডেটা-চালিত স্টাইলিংয়ের মাধ্যমে আপনার ডেটা রিয়েল টাইমে দেখুন।

অবদানকারীরা

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

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