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