হিটম্যাপ

heatmapTiles এন্ডপয়েন্ট একটি টালি ওভারলে এর মাধ্যমে বাতাসের গুণমান সম্পর্কিত হিটম্যাপ প্রদান করে। একটি টাইল ওভারলে হল PNG ইমেজ টাইলের একটি সংগ্রহ যা Google মানচিত্রের উপরে প্রদর্শিত হতে পারে। প্রতিটি ছবির টাইল (256 x 256 পিক্সেল)।

হিটম্যাপ টাইলস সম্পর্কে

টাইল ওভারলে হল একটি গ্রিড যা টাইলসের সংগ্রহ থেকে একত্রিত হয়, প্রতিটি নির্ধারিত ( X , Y ) স্থানাঙ্ক। স্থানাঙ্ক (0,0) সহ টাইল সর্বদা মানচিত্রের উত্তর-পশ্চিম কোণে থাকে। X মান পশ্চিম থেকে পূর্বে বৃদ্ধি পায়, যখন Y মান উত্তর থেকে দক্ষিণে বৃদ্ধি পায়।

zoom level নির্ধারণ করে যে একটি মানচিত্রের বিষয়বস্তু কত বড় বা ছোট একটি মানচিত্র দৃশ্যে প্রদর্শিত হবে। টাইল গ্রিডের আকার জুম স্তর দ্বারা X এবং Y স্থানাঙ্কগুলিকে ত্বরান্বিতভাবে স্কেলিং করে নির্ধারিত হয়।

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

উদাহরণস্বরূপ, 2 এর জুম স্তরে, মোট 16টি টাইলের জন্য 4 x 4 ম্যাট্রিক্স ব্যবহার করে বিশ্বের মানচিত্রটি উপস্থাপন করা হয়। স্থানাঙ্কের জন্য অনুমোদিত সর্বোচ্চ মান কী তাও জুম নির্ধারণ করে।

নিম্নলিখিত চিত্রটি প্রতিটি টাইলের স্থানাঙ্ক সহ 2 এর জুম স্তর সহ একটি US_AQI হিটম্যাপ দেখায়:

4 বাই 4 গ্রিড হিসাবে সমগ্র বিশ্বের একটি হিটম্যাপ।

অতিরিক্ত বিবরণের জন্য মানচিত্র এবং টাইল স্থানাঙ্ক দেখুন।

হিটম্যাপ এন্ডপয়েন্ট সম্পর্কে

একটি হিটম্যাপ টাইল একটি PNG ইমেজ হিসাবে টাইল ডেটা ধারণকারী একটি বাইট অ্যারে দ্বারা প্রতিনিধিত্ব করা হয়। আপনি একটি HTTP GET অনুরোধ পাঠিয়ে heatmapTiles এন্ডপয়েন্ট ব্যবহার করে বর্তমান বায়ু মানের হিটম্যাপ টাইলসের অনুরোধ করেন:

https://airquality.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY

একটি অনুরোধে সমস্ত অনুরোধের পরামিতি প্রয়োজন:

  • TYPE - টাইপ হিটম্যাপ ফেরত দিতে হবে। অনুমোদিত মান দেখুন।

  • Z - জুম স্তর যা মানচিত্র দৃশ্যে একটি মানচিত্রের বিষয়বস্তু কতটা বড় বা ছোট তা নির্ধারণ করে। অনুমোদিত মানগুলি হল 0-16, যেখানে 0-এর মান একটি একক টাইলে সমগ্র বিশ্বকে প্রদর্শন করে৷

  • X , Y - পুনরুদ্ধার করার জন্য টাইলের স্থানাঙ্ক, উত্তর-পশ্চিম কোণে (0,0)। X মান পশ্চিম থেকে পূর্বে এবং Y মান উত্তর থেকে দক্ষিণে বাড়ছে।

    টাইল স্থানাঙ্কগুলি নির্দিষ্ট জুম স্তরের জন্য বৈধ হতে হবে৷ উদাহরণস্বরূপ, যদি আপনি জুম স্তরটি 2 এ সেট করেন এবং 10,10 এর স্থানাঙ্কে একটি টাইলের অনুরোধ করেন, API একটি ত্রুটি প্রদান করে।

  • YOUR_API_KEY - আপনার অ্যাপ্লিকেশনের API কী। এই কী কোটা ব্যবস্থাপনার উদ্দেশ্যে আপনার আবেদনকে চিহ্নিত করে। আরও তথ্যের জন্য, একটি কী পান দেখুন।

উদাহরণ হিটম্যাপ অনুরোধ

উপরের ছবিটি প্রতিটি টাইলের স্থানাঙ্ক সহ 2 এর জুম স্তর সহ একটি US_AQI হিটম্যাপ দেখায়। নিম্নোক্ত উদাহরণটি হিটম্যাপ থেকে স্থানাঙ্ক 0,1 এ টাইলের অনুরোধ করতে heatmapTiles এন্ডপয়েন্ট ব্যবহার করে:

https://airquality.googleapis.com/v1/mapTypes/US_AQI/heatmapTiles/2/0/1?key=YOUR_API_KEY

টাইল এই হিসাবে প্রদর্শিত হয়:

স্থানাঙ্ক 0,1 এ একটি হিটম্যাপ টাইল।

ডিফল্ট মানচিত্রের উপরে টাইলস ওভারলে করার বিষয়ে আরও তথ্যের জন্য, ওভারলে মানচিত্রের প্রকারগুলি দেখুন।