از نشانگرها برای جلب توجه کاربر به مکان روی نقشه استفاده کنید. این راهنما نحوه استفاده و سفارشی‌سازی نشانگرها در نقشه‌های سه‌بعدی را نشان می‌دهد. علاوه‌بر ارتفاعی که نشانگرها در آن ظاهر می‌شوند، می‌توانید شکل، اندازه، و رنگ نشانگرها را کنترل کنید. مثال زیر نشانگر پایه‌ای را نشان می‌دهد:
3D Maps در 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 به‌شدت توصیه می‌شود تا عملکرد بهینه تضمین شود.