از نشانگرها برای جلب توجه کاربر به مکانی روی نقشه استفاده کنید. این راهنما نحوه استفاده و سفارشی‌سازی نشانگرها در نقشه‌های سه‌بعدی را نشان می‌دهد. می‌توانید شکل، اندازه، و رنگ نشانگرها را به‌علاوه ارتفاعی که در آن ظاهر می‌شوند کنترل کنید. مثال زیر نشانگر پایه‌ای را نشان می‌دهد:
«نقشه‌های سه‌بعدی» در Maps JavaScript دو کلاس نشانگر متمایز ارائه می‌دهد که هرکدام برای کاربردهای خاصی بهینه‌سازی شده‌اند. جدول زیر تفاوت‌ها و توازن بین دو کلاس موجود را نشان می‌دهد:
| قابلیت | MarkerElement |
Marker3DElement |
|---|---|---|
| سفارشی‌سازی | بالا (از عناصر HTML سفارشی، میاناهای برنامه‌سازی کاربردی پویانمایی اصلی، و غیره پشتیبانی می‌کند) | کم (سفارشی‌سازی کمتر) |
| عملکرد | عملکرد تعاملی پایین‌تر (کاهش FPS با تعداد زیادی نشانگر) | عملکرد تعاملی بالاتر (بهینه‌شده برای رندر کردن مجموعه داده‌های بزرگ) |
| ظرفیت توصیه‌شده | عملکرد تعاملی قابل‌اطمینان تا حدود ۱۰۰۰ نشانگر | برای مدیریت بیش‌از ۱۰۰۰ نشانگر توصیه می‌شود |
سفارشی‌سازی رنگ، مقیاس، و تصویر نماد
پس‌زمینه، نویسه، رنگ حاشیه، و اندازه نشانگر پیش‌فرض را سفارشی‌سازی کنید.
نماد نشانگر پیش‌فرض را با منبع SVG سفارشی جایگزین کنید.
تنظیم ارتفاع نشانگر
می‌توانید ارتفاع نشانگر را با بیرون کشیدن نشانگر و تنظیم ارتفاع تعیین کنید.
نشانگرها را طوری تنظیم کنید که به رویدادهای کلیک و صفحه‌کلید پاسخ دهند
با افزودن شنونده رویداد click، کاری کنید که نشانگر به کلیک‌ها و رویدادهای صفحه‌کلید پاسخ دهد.
const interactiveMarker = new Marker3DInteractiveElement({ position, gmpPopoverTargetElement: popover, });
تنظیم رفتار تصادم نشانگر
مشخص کنید که نشانگر هنگام برخورد با نشانگر دیگر یا برچسب نقشه چطور باید رفتار کند.
const marker = new Marker3DElement({ position: { lat, lng }, // Try setting a different collision behavior here. collisionBehavior: 'REQUIRED', });
عملکرد نشانگر
نشانگرهای HTML سفارشی (MarkerElement) عملکرد پایین‌تری نسبت به نشانگرهای سه‌بعدی استاندارد (Marker3DElement) دارند. برای برنامه‌هایی با بیش از ۱۰۰۰ نشانگر، کلاس Marker3dElement به‌شدت توصیه می‌شود تا عملکرد بهینه تضمین شود.