টাইলওভারলে

পাবলিক ফাইনাল ক্লাস টাইলওভারলে অবজেক্ট প্রসারিত করে

একটি টাইল ওভারলে হল ছবির একটি সেট যা বেস ম্যাপ টাইলসের উপরে প্রদর্শিত হয়। এই টাইলগুলি স্বচ্ছ হতে পারে, যা আপনাকে বিদ্যমান মানচিত্রে বৈশিষ্ট্য যোগ করার অনুমতি দেয়। একটি টালি ওভারলে নিম্নলিখিত বৈশিষ্ট্য আছে:

টালি প্রদানকারী
TileProvider টাইল ওভারলেতে ব্যবহৃত চিত্রগুলি সরবরাহ করে। মানচিত্রে যোগ করার আগে আপনাকে অবশ্যই টাইল প্রদানকারী নির্দিষ্ট করতে হবে। একবার যোগ করা হলে টাইল প্রদানকারী পরিবর্তন করা যাবে না; যাইহোক, আপনি নির্দিষ্ট স্থানাঙ্কের জন্য বিভিন্ন চিত্র ফেরত দিতে টাইল প্রদানকারীর আচরণ পরিবর্তন করতে পারেন। যদি টাইল প্রদানকারীর দ্বারা প্রদত্ত টাইলগুলি পরিবর্তন হয়, তাহলে পূর্ববর্তী টাইলগুলি আর রেন্ডার করা হয়নি তা নিশ্চিত করতে আপনাকে অবশ্যই পরে clearTileCache() কল করতে হবে।
Z-সূচক
যে ক্রমে এই টাইল ওভারলেটি অন্যান্য ওভারলে ( GroundOverlay s, Circle s, Polyline s, এবং Polygon s সহ কিন্তু Marker s নয়) এর ক্ষেত্রে আঁকা হয়েছে। একটি বড় z-সূচক সহ একটি ওভারলে ছোট z-সূচকগুলির সাথে ওভারলেগুলির উপর আঁকা হয়। একই z-সূচক সহ ওভারলেগুলির ক্রম নির্বিচারে। ডিফল্ট zIndex হল 0।
স্বচ্ছতা
পরিসরে টাইল ওভারলের স্বচ্ছতা [0..1] যেখানে 0 মানে ওভারলে অস্বচ্ছ এবং 1 মানে ওভারলে সম্পূর্ণ স্বচ্ছ। যদি নির্দিষ্ট করা বিটম্যাপ ইতিমধ্যেই আংশিকভাবে স্বচ্ছ হয়, তাহলে প্রতিটি পিক্সেলের স্বচ্ছতা সেই অনুযায়ী স্কেল করা হবে (উদাহরণস্বরূপ, যদি বিটম্যাপে একটি পিক্সেলের আলফা মান 200 থাকে এবং আপনি টাইল ওভারলেটির স্বচ্ছতা 0.25 হিসাবে উল্লেখ করেন, তাহলে পিক্সেল 150 এর আলফা মান সহ স্ক্রিনে রেন্ডার করা হবে)। এই সম্পত্তির স্পেসিফিকেশন ঐচ্ছিক এবং ডিফল্ট স্বচ্ছতা 0 (অস্বচ্ছ)।
দৃশ্যমানতা
টাইল ওভারলে দৃশ্যমান বা অদৃশ্য কিনা তা নির্দেশ করে, অর্থাৎ, এটি মানচিত্রে আঁকা হয়েছে কিনা। একটি অদৃশ্য টালি ওভারলে আঁকা হয় না, কিন্তু তার অন্যান্য বৈশিষ্ট্য সব ধরে রাখে। ডিফল্ট true , অর্থাৎ দৃশ্যমান।

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

টাইল স্থানাঙ্ক

উল্লেখ্য যে মার্কেটর প্রজেকশন ( উইকিপিডিয়া দেখুন) ব্যবহার করে বিশ্বকে অনুমান করা হয়েছে মানচিত্রের বাম (পশ্চিম) দিকটি দ্রাঘিমাংশের -180 ডিগ্রি এবং মানচিত্রের ডান (পূর্ব) দিকটি 180 ডিগ্রি দ্রাঘিমাংশের সাথে সম্পর্কিত। মানচিত্রটিকে বর্গাকার করতে, মানচিত্রের উপরের (উত্তর) দিকটি অক্ষাংশের 85.0511 ডিগ্রি এবং মানচিত্রের নীচের (দক্ষিণ) দিকটি অক্ষাংশের -85.0511 ডিগ্রির সাথে মিলে যায়৷ এই অক্ষাংশ সীমার বাইরের অঞ্চলগুলি রেন্ডার করা হয় না৷

প্রতিটি জুম স্তরে, মানচিত্রটি টাইলগুলিতে বিভক্ত এবং শুধুমাত্র টাইলগুলি যেগুলি স্ক্রীনকে ওভারল্যাপ করে তা ডাউনলোড এবং রেন্ডার করা হয়৷ প্রতিটি টাইল বর্গাকার এবং মানচিত্রটি নিম্নরূপ টাইলগুলিতে বিভক্ত:

  • জুম লেভেল 0 এ, একটি টাইল সমগ্র বিশ্বের প্রতিনিধিত্ব করে। সেই টাইলের স্থানাঙ্কগুলি হল (x, y) = (0, 0)।
  • জুম লেভেল 1 এ, বিশ্বকে 2 x 2 গ্রিডে সাজানো 4টি টাইলে বিভক্ত করা হয়েছে।
  • ...
  • জুম লেভেল N-এ, পৃথিবীকে 2 N x 2 N গ্রিডে সাজানো 4 N টাইলে বিভক্ত করা হয়েছে।
মনে রাখবেন যে ন্যূনতম জুম স্তরটি ক্যামেরা সমর্থন করে (যা বিভিন্ন কারণের উপর নির্ভর করতে পারে) হল GoogleMap.getMinZoomLevel এবং সর্বাধিক জুম স্তর হল GoogleMap.getMaxZoomLevel

টাইলগুলির স্থানাঙ্কগুলি মানচিত্রের উপরের বাম (উত্তর-পশ্চিম) কোণ থেকে পরিমাপ করা হয়। জুম স্তর N-এ, টাইল স্থানাঙ্কের x মান 0 থেকে 2 N - 1 পর্যন্ত এবং পশ্চিম থেকে পূর্বে বৃদ্ধি পায় এবং y মানগুলি 0 থেকে 2 N - 1 পর্যন্ত এবং উত্তর থেকে দক্ষিণে বৃদ্ধি পায়।

উদাহরণ

GoogleMap map; // ... get a map.
 TileProvider tileProvider; // ... create a tile provider.
 TileOverlay tileOverlay = map.addTileOverlay(
     new TileOverlayOptions().tileProvider(tileProvider));
 

পাবলিক পদ্ধতির সারাংশ

অকার্যকর
clearTileCache ()
টাইল ক্যাশে সাফ করে যাতে সমস্ত টাইল আবার TileProvider থেকে অনুরোধ করা হবে।
বুলিয়ান
সমান (অন্য বস্তু)
এই TileOverlay অন্যটির সমান কিনা তা পরীক্ষা করে।
বুলিয়ান
getFadeIn ()
ওভারলে টাইলস বিবর্ণ হওয়া উচিত কিনা তা পায়।
স্ট্রিং
getId ()
এই টাইল ওভারলে এর আইডি পায়।
ভাসা
স্বচ্ছতা পান ()
এই টাইল ওভারলে এর স্বচ্ছতা পায়।
ভাসা
getZIndex ()
এই টাইল ওভারলে এর zIndex পায়।
int
বুলিয়ান
দৃশ্যমান ()
এই টাইল ওভারলে এর দৃশ্যমানতা পায়।
অকার্যকর
অপসারণ ()
মানচিত্র থেকে এই টাইল ওভারলে সরিয়ে দেয়।
অকার্যকর
সেটফেডইন (বুলিয়ান ফেডইন)
ওভারলে টাইলগুলি বিবর্ণ হওয়া উচিত কিনা তা সেট করে৷
অকার্যকর
সেট ট্রান্সপারেন্সি (ফ্লোট ট্রান্সপারেন্সি)
এই টাইল ওভারলে এর স্বচ্ছতা সেট করে।
অকার্যকর
সেটভিজিবল (বুলিয়ান দৃশ্যমান)
এই টাইল ওভারলে এর দৃশ্যমানতা সেট করে।
অকার্যকর
setZIndex (ফ্লোট zIndex)
এই টাইল ওভারলে এর zIndex সেট করে।

উত্তরাধিকারসূত্রে প্রাপ্ত পদ্ধতির সারাংশ

পাবলিক পদ্ধতি

সর্বজনীন অকার্যকর clearTileCache ()

টাইল ক্যাশে সাফ করে যাতে সমস্ত টাইল আবার TileProvider থেকে অনুরোধ করা হবে। এই টাইল ওভারলে থেকে বর্তমান টাইলগুলিও এই পদ্ধতিতে কল করার পরে মানচিত্র থেকে সাফ করা হবে। API টাইলগুলির একটি ছোট ইন-মেমরি ক্যাশে বজায় রাখে। আপনি যদি দীর্ঘ সময়ের জন্য টাইলস ক্যাশে করতে চান তবে আপনার একটি অন-ডিস্ক ক্যাশে প্রয়োগ করা উচিত।

পাবলিক বুলিয়ান সমান (অন্য বস্তু)

এই TileOverlay অন্যটির সমান কিনা তা পরীক্ষা করে।

পরামিতি
অন্যান্য একটি Object
রিটার্নস
  • সত্য যদি উভয় বস্তু একই বস্তু হয়, অর্থাৎ, এই == অন্যান্য।

পাবলিক বুলিয়ান getFadeIn ()

ওভারলে টাইলস বিবর্ণ হওয়া উচিত কিনা তা পায়।

রিটার্নস
  • true যদি টাইলস বিবর্ণ হয়; false যদি তারা না হয়.

সর্বজনীন স্ট্রিং getId ()

এই টাইল ওভারলে এর আইডি পায়।

পাবলিক ফ্লোট প্রাপ্ত স্বচ্ছতা ()

এই টাইল ওভারলে এর স্বচ্ছতা পায়।

রিটার্নস
  • এই টাইল ওভারলে এর স্বচ্ছতা।

পাবলিক ফ্লোট getZIndex ()

এই টাইল ওভারলে এর zIndex পায়।

রিটার্নস
  • টাইল ওভারলে এর zIndex.

পাবলিক int হ্যাশকোড ()

সর্বজনীন বুলিয়ান দৃশ্যমান ()

এই টাইল ওভারলে এর দৃশ্যমানতা পায়। মনে রাখবেন যে এটি টাইল ওভারলেটি আসলে স্ক্রিনের ভিউপোর্টের মধ্যে আছে কিনা তা ফেরত দেয় না, তবে এটি স্ক্রিনের ভিউপোর্টে থাকলে এটি আঁকা হবে কিনা।

রিটার্নস
  • এই টাইল ওভারলে এর দৃশ্যমানতা।

সর্বজনীন শূন্যতা অপসারণ ()

মানচিত্র থেকে এই টাইল ওভারলে সরিয়ে দেয়।

সর্বজনীন অকার্যকর সেটফেডইন (বুলিয়ান ফেডইন)

ওভারলে টাইলগুলি বিবর্ণ হওয়া উচিত কিনা তা সেট করে৷

পরামিতি
বিবর্ণ টাইলস বিবর্ণ করতে true ; অবিলম্বে তাদের রেন্ডার false .

সর্বজনীন অকার্যকর সেট ট্রান্সপারেন্সি (ফ্লোট স্বচ্ছতা)

এই টাইল ওভারলে এর স্বচ্ছতা সেট করে। আরও তথ্যের জন্য এই ক্লাসের শীর্ষে ডকুমেন্টেশন দেখুন।

পরামিতি
স্বচ্ছতা পরিসরে একটি ভাসমান [0..1] যেখানে 0 এর অর্থ হল টাইল ওভারলে অস্বচ্ছ এবং 1 এর অর্থ হল টাইল ওভারলে স্বচ্ছ।

সর্বজনীন অকার্যকর সেট দৃশ্যমান (বুলিয়ান দৃশ্যমান)

এই টাইল ওভারলে এর দৃশ্যমানতা সেট করে। দৃশ্যমান না হলে, একটি টালি ওভারলে আঁকা হয় না, কিন্তু এটি তার অন্যান্য বৈশিষ্ট্য রাখে। টাইল ওভারলে ডিফল্টরূপে দৃশ্যমান।

পরামিতি
দৃশ্যমান এই ওভারলে দৃশ্যমান করতে true ; false এটা অদৃশ্য করতে.

সর্বজনীন অকার্যকর সেটZIndex (ফ্লোট zIndex)

এই টাইল ওভারলে এর zIndex সেট করে। আরও তথ্যের জন্য এই ক্লাসের শীর্ষে ডকুমেন্টেশন দেখুন।

পরামিতি
zIndex এই টাইল ওভারলে এর zIndex.