গ্রাউন্ডওভারলে

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

একটি গ্রাউন্ড ওভারলে একটি চিত্র যা একটি মানচিত্রে স্থির করা হয়। একটি স্থল ওভারলে নিম্নলিখিত বৈশিষ্ট্য আছে:

অবস্থান
স্থল ওভারলে অবস্থান নির্দিষ্ট করার দুটি উপায় আছে:
  • একটি অবস্থান ব্যবহার করা: আপনাকে অবশ্যই গ্রাউন্ড ওভারলে, একটি LatLng এর একটি চিত্র প্রদান করতে হবে যেখানে অ্যাঙ্করটি স্থির করা হবে এবং ওভারলেটির প্রস্থ (মিটারে)। অ্যাঙ্কর হল, ডিফল্টভাবে, ছবির উপরের দিক থেকে 50% এবং ছবির বাম দিক থেকে 50%৷ এই পরিবর্তন করা যেতে পারে. আপনি ঐচ্ছিকভাবে ওভারলে (মিটারে) উচ্চতা প্রদান করতে পারেন। আপনি যদি ওভারলেটির উচ্চতা প্রদান না করেন তবে এটি স্বয়ংক্রিয়ভাবে চিত্রের অনুপাত সংরক্ষণের জন্য গণনা করা হবে।
  • একটি সীমানা ব্যবহার করা: আপনাকে অবশ্যই একটি LatLngBounds প্রদান করতে হবে যাতে ছবিটি থাকবে৷
মানচিত্রে যোগ করার আগে আপনাকে অবশ্যই গ্রাউন্ড ওভারলেটির অবস্থান নির্দিষ্ট করতে হবে, অন্যথায় ম্যাপে গ্রাউন্ড ওভারলে যোগ করার সময় একটি IllegalArgumentException নিক্ষেপ করা হবে। উপরন্তু, আপনি শুধুমাত্র GroundOverlayOptions অবজেক্টে এই পদ্ধতিগুলির একটি ব্যবহার করে অবস্থান নির্দিষ্ট করতে হবে; অন্যথায় একটি দ্বিতীয় পদ্ধতি ব্যবহার করে নির্দিষ্ট করার সময় একটি IllegalStateException নিক্ষেপ করা হবে।
ছবি
এই ওভারলের জন্য ব্যবহার করা ছবি (একটি BitmapDescriptor হিসাবে)। প্রদত্ত অবস্থানের সাথে মানানসই চিত্রটি স্কেল করা হবে৷ মানচিত্রে গ্রাউন্ড ওভারলে যোগ করার আগে আপনাকে অবশ্যই একটি চিত্র নির্দিষ্ট করতে হবে; যদি না হয় একটি IllegalArgumentException এটি মানচিত্রে যোগ করা হলে নিক্ষেপ করা হবে।
ভারবহন
যে পরিমাণ ছবিটি ঘড়ির কাঁটার দিকে ঘোরানো উচিত। ঘূর্ণনের কেন্দ্রটি চিত্রের অ্যাঙ্কর হবে। এটি ঐচ্ছিক এবং ডিফল্ট বিয়ারিং হল 0, অর্থাৎ, চিত্রটি সারিবদ্ধ করা হয়েছে যাতে উত্তর দিকে থাকে।
zIndex
যে ক্রমে এই গ্রাউন্ড ওভারলে অন্যান্য ওভারলে ( Polyline এবং TileOverlay সহ, কিন্তু Marker s নয়) এর ক্ষেত্রে আঁকা হয়েছে। একটি বড় zIndex সহ একটি ওভারলে ছোট zIndexs সহ ওভারলেগুলির উপর আঁকা হয়। একই zIndex মান সহ ওভারলেগুলির ক্রম নির্বিচারে। এটি ঐচ্ছিক এবং ডিফল্ট zIndex হল 0।
স্বচ্ছতা
পরিসরে গ্রাউন্ড ওভারলের স্বচ্ছতা [0..1] যেখানে 0 মানে ওভারলে অস্বচ্ছ এবং 1 মানে ওভারলে সম্পূর্ণ স্বচ্ছ। যদি নির্দিষ্ট করা বিটম্যাপ ইতিমধ্যেই আংশিকভাবে স্বচ্ছ হয়, তাহলে প্রতিটি পিক্সেলের স্বচ্ছতা সেই অনুযায়ী স্কেল করা হবে (উদাহরণস্বরূপ, যদি বিটম্যাপে একটি পিক্সেলের আলফা মান 200 থাকে এবং আপনি গ্রাউন্ড ওভারলেটির স্বচ্ছতা 0.25 হিসাবে উল্লেখ করেন, তাহলে পিক্সেল 150 এর আলফা মান সহ স্ক্রিনে রেন্ডার করা হবে)। এই সম্পত্তির স্পেসিফিকেশন ঐচ্ছিক এবং ডিফল্ট স্বচ্ছতা 0 (অস্বচ্ছ)।
দৃশ্যমানতা
গ্রাউন্ড ওভারলে দৃশ্যমান বা অদৃশ্য কিনা তা নির্দেশ করে, অর্থাৎ এটি মানচিত্রে আঁকা হয়েছে কিনা। একটি অদৃশ্য স্থল ওভারলে আঁকা হয় না, কিন্তু তার অন্যান্য বৈশিষ্ট্য সব ধরে রাখে। এটি ঐচ্ছিক এবং ডিফল্ট দৃশ্যমানতা true , অর্থাৎ দৃশ্যমান।
ক্লিকযোগ্যতা
আপনি যদি ব্যবহারকারীর গ্রাউন্ড ওভারলে ক্লিক করার সময় ফায়ার করা ইভেন্টগুলি পরিচালনা করতে চান তবে এই সম্পত্তিটিকে true হিসাবে সেট করুন৷ আপনি যেকোনো সময় এই মান পরিবর্তন করতে পারেন। ডিফল্ট false . এই প্রপার্টিটি true সেট করা থাকলে, আপনার অ্যাপটি GoogleMap.OnGroundOverlayClickListenersetOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener) এর মাধ্যমে নিবন্ধিত বিজ্ঞপ্তি পাবে।
ট্যাগ
স্থল ওভারলে সম্পর্কিত একটি Object । উদাহরণস্বরূপ, Object গ্রাউন্ড ওভারলে কী প্রতিনিধিত্ব করে সে সম্পর্কে ডেটা থাকতে পারে। এটি একটি পৃথক Map<GroundOverlay, Object> সংরক্ষণ করার চেয়ে সহজ। আরেকটি উদাহরণ হিসাবে, আপনি একটি ডেটা সেট থেকে আইডির সাথে সম্পর্কিত একটি String আইডি সংযুক্ত করতে পারেন। Android এর জন্য Google Maps SDK এই সম্পত্তিটি পড়তে বা লেখে না।

এই ক্লাসের পদ্ধতিগুলিকে অবশ্যই Android UI থ্রেডে কল করতে হবে। যদি না হয়, রানটাইমে একটি IllegalStateException নিক্ষেপ করা হবে।

উদাহরণ

GoogleMap map = ...; // get a map.
 BitmapDescriptor imageDescriptor = ...; // get an image.
 LatLngBounds bounds = ...; // get a bounds
 // Adds a ground overlay with 50% transparency.
 GroundOverlay groundOverlay = map.addGroundOverlay(new GroundOverlayOptions()
     .image(imageDescriptor)
     .positionFromBounds(bounds)
     .transparency(0.5));
 

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

বুলিয়ান
সমান (অন্য বস্তু)
এই GroundOverlay অন্যটির সমান কিনা তা পরীক্ষা করে।
ভাসা
getBearing ()
উত্তর থেকে ঘড়ির কাঁটার দিকে ডিগ্রীতে গ্রাউন্ড ওভারলে এর ভারবহন পায়।
LatLngBounds
getBounds ()
স্থল ওভারলে জন্য সীমানা পায়.
ভাসা
উচ্চতা পান ()
স্থল ওভারলে উচ্চতা পায়.
স্ট্রিং
getId ()
এই গ্রাউন্ড ওভারলে এর আইডি পায়।
LatLng
প্রাপ্ত অবস্থান ()
অ্যাঙ্কর পয়েন্টের অবস্থান পায়।
অবজেক্ট
getTag ()
বৃত্তের জন্য ট্যাগ পায়।
ভাসা
স্বচ্ছতা পান ()
এই স্থল ওভারলে স্বচ্ছতা পায়.
ভাসা
getWidth ()
স্থল ওভারলে প্রস্থ পায়.
ভাসা
getZIndex ()
এই গ্রাউন্ড ওভারলে এর zIndex পায়।
int
বুলিয়ান
ক্লিকযোগ্য ()
স্থল ওভারলে ক্লিকযোগ্যতা পায়।
বুলিয়ান
দৃশ্যমান ()
এই স্থল ওভারলে দৃশ্যমানতা পায়.
অকার্যকর
অপসারণ ()
মানচিত্র থেকে এই গ্রাউন্ড ওভারলে সরিয়ে দেয়।
অকার্যকর
সেটবিয়ারিং (ফ্লোট বিয়ারিং)
উত্তর থেকে ঘড়ির কাঁটার দিকে ডিগ্রীতে গ্রাউন্ড ওভারলে (গ্রাউন্ড ওভারলে এর উল্লম্ব অক্ষ যে দিক নির্দেশ করে) এর বিয়ারিং সেট করে।
অকার্যকর
সেট ক্লিকযোগ্য (বুলিয়ান ক্লিকযোগ্য)
স্থল ওভারলে ক্লিকযোগ্যতা সেট করে।
অকার্যকর
সেট মাত্রা (ফ্লোট প্রস্থ, ভাসমান উচ্চতা)
স্থল ওভারলে এর মাত্রা সেট করে।
অকার্যকর
সেট মাত্রা (ফ্লোট প্রস্থ)
স্থল ওভারলে প্রস্থ সেট করে।
অকার্যকর
সেট ইমেজ ( বিটম্যাপডিস্ক্রিপ্টর ইমেজ ডিসক্রিপ্টর)
গ্রাউন্ড ওভারলে এর জন্য ইমেজ সেট করে।
অকার্যকর
সেট পজিশন ( LatLng latLng)
অ্যাঙ্কর পয়েন্টের অবস্থান পরিবর্তন করে গ্রাউন্ড ওভারলে এর অবস্থান সেট করে।
অকার্যকর
setPositionFromBounds ( LatLngBounds সীমানা)
প্রদত্ত LatLngBounds এ ফিট করে গ্রাউন্ড ওভারলে এর অবস্থান সেট করে।
অকার্যকর
সেটট্যাগ (অবজেক্ট ট্যাগ)
স্থল ওভারলে জন্য ট্যাগ সেট করে.
অকার্যকর
সেট ট্রান্সপারেন্সি (ফ্লোট ট্রান্সপারেন্সি)
এই স্থল ওভারলে এর স্বচ্ছতা সেট করে।
অকার্যকর
সেটভিজিবল (বুলিয়ান দৃশ্যমান)
এই গ্রাউন্ড ওভারলে এর দৃশ্যমানতা সেট করে।
অকার্যকর
setZIndex (ফ্লোট zIndex)
এই গ্রাউন্ড ওভারলে এর zIndex সেট করে।

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

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

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

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

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

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

উত্তর থেকে ঘড়ির কাঁটার দিকে ডিগ্রীতে গ্রাউন্ড ওভারলে এর ভারবহন পায়।

রিটার্নস
  • স্থল ওভারলে এর ভারবহন.

সর্বজনীন LatLngBounds getBounds ()

স্থল ওভারলে জন্য সীমানা পায়. এটি স্থল ওভারলে ঘূর্ণন উপেক্ষা করে।

রিটার্নস
  • একটি LatLngBounds যা ঘূর্ণন উপেক্ষা করে গ্রাউন্ড ওভারলে ধারণ করে।

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

স্থল ওভারলে উচ্চতা পায়.

রিটার্নস
  • মিটারে মাটির উপরিভাগের উচ্চতা।

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

এই গ্রাউন্ড ওভারলে এর আইডি পায়। একটি মানচিত্রের সমস্ত গ্রাউন্ডওভারলেগুলির মধ্যে আইডিটি অনন্য হবে৷

রিটার্নস
  • এই গ্রাউন্ড ওভারলে এর আইডি।

সর্বজনীন LatLng getPosition ()

অ্যাঙ্কর পয়েন্টের অবস্থান পায়।

রিটার্নস
  • মানচিত্রে অবস্থান (একটি LatLng )।

পাবলিক অবজেক্ট getTag ()

বৃত্তের জন্য ট্যাগ পায়।

রিটার্নস
  • ট্যাগ যদি setTag এর সাথে একটি ট্যাগ সেট করা হয়; null যদি কোন ট্যাগ সেট করা না থাকে।

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

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

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

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

স্থল ওভারলে প্রস্থ পায়.

রিটার্নস
  • মিটারে মাটির ওভারলে প্রস্থ।

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

এই গ্রাউন্ড ওভারলে এর zIndex পায়।

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

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

পাবলিক বুলিয়ান ক্লিকযোগ্য ()

স্থল ওভারলে ক্লিকযোগ্যতা পায়। গ্রাউন্ড ওভারলে ক্লিকযোগ্য হলে, ব্যবহারকারী গ্রাউন্ড ওভারলে ক্লিক করলে আপনার অ্যাপ GoogleMap.OnGroundOverlayClickListener এ বিজ্ঞপ্তি পাবে। ইভেন্ট লিসেনার setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener) এর মাধ্যমে নিবন্ধিত হয়।

রিটার্নস
  • true যদি গ্রাউন্ড ওভারলে ক্লিকযোগ্য হয়; অন্যথায়, false ফেরত দেয়।

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

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

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

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

মানচিত্র থেকে এই গ্রাউন্ড ওভারলে সরিয়ে দেয়। একটি গ্রাউন্ড ওভারলে মুছে ফেলার পরে, এর সমস্ত পদ্ধতির আচরণ অনির্ধারিত।

পাবলিক ভ্যায়েড সেটবিয়ারিং (ফ্লোট বিয়ারিং)

উত্তর থেকে ঘড়ির কাঁটার দিকে ডিগ্রীতে গ্রাউন্ড ওভারলে (গ্রাউন্ড ওভারলে এর উল্লম্ব অক্ষ যে দিক নির্দেশ করে) এর বিয়ারিং সেট করে। ঘূর্ণন নোঙ্গর বিন্দু সম্পর্কে সঞ্চালিত হয়.

পরামিতি
ভারবহন উত্তর থেকে ঘড়ির কাঁটার দিকে ডিগ্রী বহন করে

সর্বজনীন অকার্যকর সেট ক্লিকযোগ্য (বুলিয়ান ক্লিকযোগ্য)

স্থল ওভারলে ক্লিকযোগ্যতা সেট করে। গ্রাউন্ড ওভারলে ক্লিকযোগ্য হলে, ব্যবহারকারী গ্রাউন্ড ওভারলে ক্লিক করলে আপনার অ্যাপ GoogleMap.OnGroundOverlayClickListener এ বিজ্ঞপ্তি পাবে। ইভেন্ট লিসেনার setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener) এর মাধ্যমে নিবন্ধিত হয়।

পরামিতি
ক্লিকযোগ্য গ্রাউন্ড ওভারলের জন্য নতুন ক্লিকযোগ্যতা সেটিং।

সর্বজনীন অকার্যকর সেট মাত্রা (ফ্লোট প্রস্থ, ভাসমান উচ্চতা)

স্থল ওভারলে এর মাত্রা সেট করে। চিত্রটি মাত্রা মাপসই প্রসারিত করা হবে.

পরামিতি
প্রস্থ মিটারে প্রস্থ
উচ্চতা মিটারে উচ্চতা

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

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

পরামিতি
প্রস্থ মিটারে প্রস্থ

সর্বজনীন অকার্যকর সেট ইমেজ ( বিটম্যাপডিস্ক্রিপ্টর ইমেজ ডিসক্রিপ্টর)

গ্রাউন্ড ওভারলে এর জন্য ইমেজ সেট করে। নতুন চিত্রটি পুরানো চিত্রের মতো একই সীমানা দখল করবে।

পরামিতি
চিত্র বর্ণনাকারী এই গ্রাউন্ড ওভারলে ব্যবহার করার জন্য BitmapDescriptor .

সর্বজনীন অকার্যকর সেট অবস্থান ( LatLng latLng)

অ্যাঙ্কর পয়েন্টের অবস্থান পরিবর্তন করে গ্রাউন্ড ওভারলে এর অবস্থান সেট করে। ছবির অন্যান্য সমস্ত বৈশিষ্ট্য সংরক্ষণ করে।

পরামিতি
latLng একটি LatLng যেটি অ্যাঙ্কর পয়েন্ট স্থাপনের জন্য নতুন অবস্থান।

সর্বজনীন অকার্যকর সেটPositionFromBounds ( LatLngBounds সীমানা)

প্রদত্ত LatLngBounds এ ফিট করে গ্রাউন্ড ওভারলে এর অবস্থান সেট করে। এই পদ্ধতিটি গ্রাউন্ড ওভারলেকে অবস্থান করার সময় ঘূর্ণন (বেয়ারিং) উপেক্ষা করবে, তবে এটি আঁকার সময় বিয়ারিং ব্যবহার করা হবে।

পরামিতি
সীমানা একটি LatLngBounds যাতে স্থল ওভারলে স্থাপন করা হয়

পাবলিক ভ্যাইড সেটট্যাগ (অবজেক্ট ট্যাগ)

স্থল ওভারলে জন্য ট্যাগ সেট করে.

আপনি এই গ্রাউন্ড ওভারলে সঙ্গে একটি নির্বিচারে Object সংযুক্ত করতে এই সম্পত্তি ব্যবহার করতে পারেন. উদাহরণস্বরূপ, Object গ্রাউন্ড ওভারলে কী প্রতিনিধিত্ব করে সে সম্পর্কে ডেটা থাকতে পারে। এটি একটি পৃথক Map<GroundOverlay, Object> সংরক্ষণ করার চেয়ে সহজ। আরেকটি উদাহরণ হিসাবে, আপনি একটি ডেটা সেট থেকে আইডির সাথে সম্পর্কিত একটি String আইডি সংযুক্ত করতে পারেন। Android এর জন্য Google Maps SDK এই সম্পত্তিটি পড়তে বা লেখে না। আপনার অ্যাপে মেমরি ফাঁস রোধ করার জন্য যখন আপনার আর প্রয়োজন নেই তখন ট্যাগটি সাফ করার জন্য setTag(null) কল করা আপনার দায়িত্ব৷

পরামিতি
ট্যাগ শূন্য হলে, ট্যাগটি সাফ করা হয়।

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

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

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

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

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

পরামিতি
দৃশ্যমান যদি true , তাহলে গ্রাউন্ড ওভারলে দৃশ্যমান হয়; যদি false , তা নয়

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

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

পরামিতি
zIndex এই স্থল ওভারলে এর zIndex