heatmapTiles এন্ডপয়েন্টটি একটি টাইল ওভারলে-এর মাধ্যমে বায়ুর গুণমান সম্পর্কিত হিটম্যাপ প্রদান করে। টাইল ওভারলে হল PNG ছবির টাইলের একটি সংগ্রহ যা Google Maps-এর উপরে প্রদর্শিত হতে পারে। প্রতিটি ছবির টাইলের আকার (256 x 256 পিক্সেল)।
হিটম্যাপ টাইলস সম্পর্কে
টাইল ওভারলে হল একটি গ্রিড যা টাইলসের সংগ্রহ থেকে একত্রিত হয়, প্রতিটি স্থানাঙ্ক ( X , Y ) দিয়ে নির্ধারিত হয়। স্থানাঙ্ক (0,0) সহ টাইলটি সর্বদা মানচিত্রের উত্তর-পশ্চিম কোণে থাকে। X মান পশ্চিম থেকে পূর্ব দিকে বৃদ্ধি পায়, যখন Y মান উত্তর থেকে দক্ষিণে বৃদ্ধি পায়।
zoom level নির্ধারণ করে যে ম্যাপের বিষয়বস্তু ম্যাপ ভিউতে কত বড় বা ছোট প্রদর্শিত হবে। টাইল গ্রিডের আকার নির্ধারণ করা হয় জুম লেভেল দ্বারা X এবং Y স্থানাঙ্কগুলিকে সূচকীয়ভাবে স্কেল করে।
gridSizeX = XzoomLevel gridSizeY = YzoomLevel
উদাহরণস্বরূপ, ২ জুম লেভেলে, বিশ্ব মানচিত্র ৪ x ৪ ম্যাট্রিক্স ব্যবহার করে দেখানো হয়, মোট ১৬টি টাইলসের জন্য। জুম স্থানাঙ্কের জন্য অনুমোদিত সর্বোচ্চ মান কী তাও নির্ধারণ করে।
নিচের ছবিতে প্রতিটি টাইলের স্থানাঙ্ক সহ 2 জুম লেভেল সহ একটি US_AQI হিটম্যাপ দেখানো হয়েছে:
আরও তথ্যের জন্য মানচিত্র এবং টাইল স্থানাঙ্ক দেখুন।
হিটম্যাপ এন্ডপয়েন্ট সম্পর্কে
একটি হিটম্যাপ টাইলকে একটি বাইট অ্যারে দ্বারা উপস্থাপন করা হয় যার মধ্যে একটি PNG চিত্র হিসেবে টাইলের ডেটা থাকে। আপনি heatmapTiles এন্ডপয়েন্ট ব্যবহার করে বর্তমান বায়ু মানের হিটম্যাপ টাইলগুলির জন্য একটি HTTP GET অনুরোধ পাঠিয়ে অনুরোধ করতে পারেন:
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 কী। এই কীটি কোটা ব্যবস্থাপনার উদ্দেশ্যে আপনার অ্যাপ্লিকেশনটিকে সনাক্ত করে। আরও তথ্যের জন্য, get a key দেখুন।
হিটম্যাপ অনুরোধের উদাহরণ
উপরের ছবিতে প্রতিটি টাইলের স্থানাঙ্ক সহ 2 জুম লেভেল সহ একটি US_AQI হিটম্যাপ দেখানো হয়েছে। নিম্নলিখিত উদাহরণে হিটম্যাপ থেকে 0,1 স্থানাঙ্কে টাইল অনুরোধ করার জন্য heatmapTiles এন্ডপয়েন্ট ব্যবহার করা হয়েছে:
https://airquality.googleapis.com/v1/mapTypes/US_AQI/heatmapTiles/2/0/1?key=YOUR_API_KEY
টাইলটি এইভাবে দেখাচ্ছে:
ডিফল্ট মানচিত্রের উপরে টাইলস ওভারলে করার বিষয়ে আরও তথ্যের জন্য, ওভারলে মানচিত্রের ধরণ দেখুন।