روکش زمین

کلاس نهایی عمومی GroundOverlay Object را گسترش می دهد

پوشش زمین تصویری است که روی نقشه ثابت می شود. روکش زمین دارای ویژگی های زیر است:

موقعیت
دو روش برای تعیین موقعیت روکش زمین وجود دارد:
  • استفاده از یک مکان: شما باید تصویری از پوشش زمین، LatLng که لنگر روی آن ثابت می شود و عرض روکش (بر حسب متر) ارائه دهید. لنگر به طور پیش فرض 50% از بالای تصویر و 50% از سمت چپ تصویر است. این را می توان تغییر داد. شما می توانید به صورت اختیاری ارتفاع روکش (به متر) را ارائه دهید. اگر ارتفاع روکش را ارائه نکنید، برای حفظ نسبت های تصویر، به طور خودکار محاسبه می شود.
  • استفاده از یک Bounds: شما باید یک LatLngBounds ارائه دهید که حاوی تصویر باشد.
شما باید موقعیت همپوشانی زمین را قبل از اضافه شدن به نقشه مشخص کنید، در غیر این صورت با اضافه شدن روکش زمین به نقشه، یک IllegalArgumentException پرتاب می شود. علاوه بر این، شما فقط باید موقعیت را با استفاده از یکی از این روش ها در شی GroundOverlayOptions مشخص کنید. در غیر این صورت یک IllegalStateException هنگام تعیین با استفاده از روش دوم پرتاب می شود.
تصویر
تصویر (به عنوان BitmapDescriptor ) که برای این همپوشانی استفاده می شود. تصویر به اندازه موقعیت ارائه شده کوچک می شود. قبل از افزودن همپوشانی زمین به نقشه، باید تصویری را مشخص کنید. در غیر این صورت یک IllegalArgumentException زمانی که به نقشه اضافه می شود پرتاب می شود.
بلبرینگ
مقداری که تصویر باید در جهت عقربه های ساعت بچرخد. مرکز چرخش لنگر تصویر خواهد بود. این اختیاری است و بلبرینگ پیش‌فرض 0 است، یعنی تصویر به‌گونه‌ای تراز شده است که بالا به سمت شمال باشد.
zIndex
ترتیب رسم این روکش زمینی نسبت به سایر روکش ها (از جمله Polyline s و TileOverlay s، اما نه Marker s). یک پوشش با zIndex بزرگتر روی همپوشانی با zIndexهای کوچکتر کشیده می شود. ترتیب همپوشانی ها با مقدار zIndex یکسان دلخواه است. این اختیاری است و zIndex پیش‌فرض 0 است.
شفافیت
شفافیت پوشش زمین در محدوده [0..1] که در آن 0 به معنای مات بودن روکش و 1 به معنای شفاف بودن پوشش کاملاً است. اگر بیت مپ مشخص شده قبلاً تا حدی شفاف باشد، شفافیت هر پیکسل بر این اساس مقیاس می شود (به عنوان مثال، اگر یک پیکسل در بیت مپ دارای مقدار آلفای 200 باشد و شما شفافیت همپوشانی زمین را 0.25 تعیین کنید، پیکسل خواهد شد. با مقدار آلفای 150 روی صفحه نمایش داده شود. مشخصات این ویژگی اختیاری است و شفافیت پیش‌فرض 0 (مادر) است.
دید
نشان می دهد که پوشش زمین قابل مشاهده است یا نامرئی، یعنی اینکه آیا روی نقشه کشیده شده است. روکش زمین نامرئی کشیده نمی شود، اما تمام خصوصیات دیگر خود را حفظ می کند. این اختیاری است و نمای پیش‌فرض true است، یعنی قابل مشاهده است.
قابلیت کلیک
اگر می‌خواهید رویدادهایی را که هنگام کلیک کاربر روی همپوشانی زمین اجرا می‌شوند مدیریت کنید، این ویژگی را روی true تنظیم کنید. شما می توانید این مقدار را در هر زمان تغییر دهید. پیش فرض false است. اگر این ویژگی روی true تنظیم شود، برنامه شما اعلان‌هایی را به GoogleMap.OnGroundOverlayClickListener که از طریق setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener) ثبت شده است، دریافت می‌کند.
برچسب بزنید
یک Object مرتبط با پوشش زمین. به عنوان مثال، Object می تواند حاوی داده هایی در مورد آنچه که پوشش زمین نشان می دهد باشد. این آسان تر از ذخیره کردن یک Map<GroundOverlay, Object> . به عنوان مثال دیگر، می توانید یک شناسه String مربوط به شناسه را از یک مجموعه داده مرتبط کنید. Google Maps SDK برای اندروید این ویژگی را نه می‌خواند و نه می‌نویسد.

متدهای این کلاس باید در رشته رابط کاربری اندروید فراخوانی شوند. اگر نه، یک 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
getPosition ()
محل نقطه لنگر را بدست می آورد.
شیء
getTag ()
برچسب دایره را دریافت می کند.
شناور
شفاف سازی ()
شفافیت این روکش زمین را دریافت می کند.
شناور
getWidth ()
عرض روکش زمین را بدست می آورد.
شناور
getZIndex ()
zIndex این پوشش زمین را دریافت می کند.
بین المللی
کد هش ()
بولی
قابل کلیک است ()
قابلیت کلیک روی پوشش زمین را دریافت می کند.
بولی
قابل مشاهده است ()
دید این پوشش زمین را دریافت می کند.
باطل
حذف ()
این پوشش زمین را از نقشه حذف می کند.
باطل
setBearing (بلبرینگ شناور)
یاتاقان پوشش زمین (جهتی که محور عمودی روکش زمین نشان می دهد) را بر حسب درجه در جهت عقربه های ساعت از شمال تنظیم می کند.
باطل
setClickable (قابل کلیک بولی)
قابلیت کلیک روی پوشش زمین را تنظیم می کند.
باطل
setDimensions (عرض شناور، ارتفاع شناور)
ابعاد روکش زمین را تنظیم می کند.
باطل
setDimensions (عرض شناور)
عرض روکش زمین را تنظیم می کند.
باطل
setImage ( BitmapDescriptor imageDescriptor)
تصویر را برای Ground Overlay تنظیم می کند.
باطل
setPosition ( LatLng latLng)
با تغییر محل نقطه لنگر، موقعیت پوشش زمین را تنظیم می کند.
باطل
setPositionFromBounds (حدود LatLngBounds )
موقعیت همپوشانی زمین را با قرار دادن آن در LatLngBounds داده شده تنظیم می کند.
باطل
setTag (برچسب شی)
برچسب را برای پوشش زمین تنظیم می کند.
باطل
setTransparency (شفافیت شناور)
شفافیت این روکش زمین را تنظیم می کند.
باطل
setVisible (بولی قابل مشاهده)
دید این پوشش زمین را تنظیم می کند.
باطل
setZIndex (zIndex شناور)
zIndex این همپوشانی زمین را تنظیم می کند.

خلاصه روش ارثی

روش های عمومی

بولین عمومی برابر است (Object other)

آزمایش می کند که آیا این GroundOverlay با دیگری برابر است یا خیر.

پارامترها
دیگر یک Object .
برمی گرداند
  • درست است اگر هر دو شیء یک شی باشند، یعنی این == دیگری.

عمومی float getBearing ()

یاتاقان پوشش زمین را بر حسب درجه در جهت عقربه های ساعت از شمال دریافت می کند.

برمی گرداند
  • یاتاقان پوشش زمین

عمومی LatLngBounds getBounds ()

مرزهای پوشش زمین را بدست می آورد. این چرخش روکش زمین را نادیده می گیرد.

برمی گرداند
  • یک LatLngBounds که شامل پوشش زمین است و چرخش را نادیده می گیرد.

دریافت ارتفاع شناور عمومی ()

ارتفاع روکش زمین را بدست می آورد.

برمی گرداند
  • ارتفاع روکش زمین بر حسب متر

رشته عمومی getId ()

شناسه این پوشش زمین را دریافت می کند. شناسه در میان همه روکش‌های زمینی روی نقشه منحصربه‌فرد خواهد بود.

برمی گرداند
  • شناسه این پوشش زمین

عمومی LatLng getPosition ()

محل نقطه لنگر را بدست می آورد.

برمی گرداند
  • موقعیت روی نقشه (یک LatLng ).

دریافت تگ شی عمومی ()

برچسب دایره را دریافت می کند.

برمی گرداند
  • تگ اگر یک برچسب با setTag تنظیم شده باشد. اگر هیچ برچسبی تنظیم نشده باشد، null .

عمومی float getTransparency ()

شفافیت این روکش زمین را دریافت می کند.

برمی گرداند
  • شفافیت این پوشش زمین

عمومی float getWidth ()

عرض روکش زمین را بدست می آورد.

برمی گرداند
  • عرض روکش زمین بر حسب متر

عمومی float getZIndex ()

zIndex این پوشش زمین را دریافت می کند.

برمی گرداند
  • zIndex پوشش زمین.

هش کد عمومی ()

بولی عمومی isClickable ()

قابلیت کلیک روی پوشش زمین را دریافت می کند. اگر روکش زمین قابل کلیک باشد، برنامه شما اعلان هایی را به GoogleMap.OnGroundOverlayClickListener دریافت می کند. OnGroundOverlayClickListener زمانی که کاربر روی پوشش زمین کلیک می کند. شنونده رویداد از طریق setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener) ثبت می شود.

برمی گرداند
  • اگر روکش زمین قابل کلیک باشد true . در غیر این صورت، false را برمی گرداند.

بولی عمومی isVisible ()

دید این پوشش زمین را دریافت می کند. توجه داشته باشید که این نشان می‌دهد که آیا پوشش زمین واقعاً روی صفحه است یا خیر، بلکه نشان می‌دهد که اگر در نمای دوربین وجود داشته باشد، کشیده می‌شود یا خیر.

برمی گرداند
  • دید این پوشش زمین

خلأ عمومی حذف ()

این پوشش زمین را از نقشه حذف می کند. پس از حذف یک پوشش زمین، رفتار همه روش های آن تعریف نشده است.

عمومی void setBearing (بلبرینگ شناور)

یاتاقان پوشش زمین (جهتی که محور عمودی روکش زمین نشان می دهد) را بر حسب درجه در جهت عقربه های ساعت از شمال تنظیم می کند. چرخش در مورد نقطه لنگر انجام می شود.

پارامترها
بلبرینگ تحمل بر حسب درجه در جهت عقربه های ساعت از شمال

public void setClickable (قابل کلیک بولین)

قابلیت کلیک روی پوشش زمین را تنظیم می کند. اگر روکش زمین قابل کلیک باشد، برنامه شما اعلان هایی را به GoogleMap.OnGroundOverlayClickListener دریافت می کند. OnGroundOverlayClickListener زمانی که کاربر روی پوشش زمین کلیک می کند. شنونده رویداد از طریق setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener) ثبت می شود.

پارامترها
قابل کلیک تنظیم جدید قابلیت کلیک برای روکش زمین.

مجموعه فضای خالی عمومی (عرض شناور، ارتفاع شناور)

ابعاد روکش زمین را تنظیم می کند. تصویر کشیده خواهد شد تا متناسب با ابعاد باشد.

پارامترها
عرض عرض بر حسب متر
ارتفاع ارتفاع بر حسب متر

مجموعه فضای خالی عمومی (عرض شناور)

عرض روکش زمین را تنظیم می کند. ارتفاع روکش زمین بر این اساس برای حفظ نسبت ابعاد تطبیق داده می شود.

پارامترها
عرض عرض بر حسب متر

public void setImage ( BitmapDescriptor imageDescriptor)

تصویر را برای Ground Overlay تنظیم می کند. تصویر جدید همان محدوده های تصویر قدیمی را اشغال می کند.

پارامترها
تصویر توصیفگر BitmapDescriptor برای استفاده برای این همپوشانی زمین.

مجموعه پوزیشن عمومی ( LatLng latLng)

با تغییر محل نقطه لنگر، موقعیت پوشش زمین را تنظیم می کند. تمام خصوصیات دیگر تصویر را حفظ می کند.

پارامترها
latLng یک LatLng که مکان جدید برای قرار دادن نقطه لنگر است.

public void setPositionFromBounds (حدود LatLngBounds )

موقعیت همپوشانی زمین را با قرار دادن آن در LatLngBounds داده شده تنظیم می کند. این روش هنگام قرار دادن روکش زمین، چرخش (بارینگ) را نادیده می گیرد، اما در هنگام کشیدن آن از یاتاقان استفاده می شود.

پارامترها
محدوده یک LatLngBounds که در آن روکش زمین قرار می گیرد

setTag خالی عمومی (برچسب شی)

برچسب را برای پوشش زمین تنظیم می کند.

می توانید از این ویژگی برای مرتبط کردن یک Object دلخواه با این همپوشانی زمین استفاده کنید. به عنوان مثال، Object می تواند حاوی داده هایی در مورد آنچه که پوشش زمین نشان می دهد باشد. این آسان تر از ذخیره کردن یک Map<GroundOverlay, Object> . به عنوان مثال دیگر، می توانید یک شناسه String مربوط به شناسه را از یک مجموعه داده مرتبط کنید. Google Maps SDK برای اندروید این ویژگی را نه می‌خواند و نه می‌نویسد. این مسئولیت شماست که setTag(null) را فراخوانی کنید تا وقتی دیگر به آن نیاز ندارید، برچسب را پاک کنید تا از نشت حافظه در برنامه خود جلوگیری کنید.

پارامترها
برچسب زدن اگر null باشد، تگ پاک می شود.

مجموعه خالی عمومی شفافیت (شفافیت شناور)

شفافیت این پوشش زمین را تنظیم می کند. برای اطلاعات بیشتر به مستندات بالای این کلاس مراجعه کنید.

پارامترها
شفافیت یک شناور در محدوده [0..1] که در آن 0 به این معنی است که روکش زمین مات است و 1 به معنای شفاف بودن پوشش زمین است.

public void setVisible (بولی قابل مشاهده)

دید این پوشش زمین را تنظیم می کند. هنگامی که قابل مشاهده نیست، روکش زمین کشیده نمی شود، اما تمام ویژگی های دیگر خود را حفظ می کند.

پارامترها
قابل مشاهده است اگر true ، پوشش زمین قابل مشاهده است. اگر false باشد، نیست

setZIndex خالی عمومی (float zIndex)

zIndex این همپوشانی زمین را تنظیم می کند. برای اطلاعات بیشتر به مستندات بالای این کلاس مراجعه کنید.

پارامترها
zIndex zIndex این روکش زمین