TileOverlay

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

ارائه دهنده کاشی

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 مرتب شده اند.

مختصات کاشی ها از گوشه بالا سمت چپ (شمال غربی) نقشه اندازه گیری می شود. در سطح زوم 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));