TileOverlay

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

پوشش کاشی مجموعه ای از تصاویر است که در بالای کاشی های نقشه پایه نمایش داده می شود. این کاشی ها ممکن است شفاف باشند و به شما امکان می دهند ویژگی هایی را به نقشه های موجود اضافه کنید. روکش کاشی دارای ویژگی های زیر است:

ارائه دهنده کاشی
TileProvider تصاویری را ارائه می دهد که در پوشش کاشی استفاده می شود. شما باید ارائه دهنده کاشی را قبل از اضافه شدن به نقشه مشخص کنید. ارائه دهنده کاشی پس از اضافه شدن قابل تغییر نیست. با این حال، می‌توانید رفتار ارائه‌دهنده کاشی را برای بازگرداندن تصاویر مختلف برای مختصات خاص تغییر دهید. اگر کاشی‌های ارائه‌شده توسط ارائه‌دهنده کاشی تغییر کنند، باید پس از آن clearTileCache() فراخوانی کنید تا مطمئن شوید که کاشی‌های قبلی دیگر رندر نمی‌شوند.
Z-Index
ترتیب رسم این روکش کاشی با توجه به پوشش های دیگر (از جمله 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، جهان به 4 کاشی تقسیم می شود که در یک شبکه 2×2 چیده شده اند.
  • ...
  • در سطح زوم N، جهان به 4 کاشی N تقسیم می شود که در یک شبکه 2 N x 2 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 این پوشش کاشی را دریافت می کند.
بین المللی
هش کد ()
بولی
قابل مشاهده است ()
نمایان بودن این پوشش کاشی را دریافت می کند.
خالی
برداشتن ()
این پوشش کاشی را از نقشه حذف می کند.
خالی
setFadeIn (fadeIn بولی)
تعیین می کند که آیا کاشی های روکش باید محو شوند یا خیر.
خالی
setTransparency (شفافیت شناور)
شفافیت این پوشش کاشی را تنظیم می کند.
خالی
setVisible (بولی قابل مشاهده)
نمایان بودن این پوشش کاشی را تنظیم می کند.
خالی
setZIndex (zIndex شناور)
zIndex این پوشش کاشی را تنظیم می کند.

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

روش های عمومی

public void clearTileCache ()

کش کاشی را پاک می کند تا همه کاشی ها دوباره از TileProvider درخواست شوند. کاشی های فعلی از این پوشش کاشی نیز پس از فراخوانی این روش از نقشه پاک می شوند. API یک کش کوچک در حافظه از کاشی ها را حفظ می کند. اگر می‌خواهید کاشی‌ها را برای مدت طولانی‌تری cache کنید، باید یک کش روی دیسک اجرا کنید.

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

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

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

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

متوجه می شود که آیا کاشی های روکش باید محو شوند یا خیر.

برمی گرداند
  • true اگر کاشی ها محو شوند. اگر نیستند false باشند.

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

شناسه این پوشش کاشی را دریافت می کند.

عمومی float getTransparency ()

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

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

عمومی float getZIndex ()

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

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

هش کد عمومی ()

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

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

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

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

این پوشش کاشی را از نقشه حذف می کند.

public void setFadeIn (fadeIn بولی)

تعیین می کند که آیا کاشی های روکش باید محو شوند یا خیر.

مولفه های
fadeIn true که کاشی ها را محو می کند. false تا آنها را فوراً ارائه کنید.

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

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

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

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

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

مولفه های
قابل رویت true تا این پوشش قابل مشاهده باشد. false تا آن را نامرئی کند.

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

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

مولفه های
zIndex zIndex این پوشش کاشی.