نمای کلی نشانگرها

پلاتفرم را انتخاب کنید: Android iOS JavaScript

از نشانگرها برای نمایش مکان‌های تکی روی نقشه استفاده کنید. این راهنما به شما نشان می‌دهد که چگونه از نشانگرهای پیشرفته استفاده کنید. با نشانگرهای پیشرفته می‌توانید نشانگرهایی با عملکرد بسیار بالا ایجاد و سفارشی‌سازی کنید، و نشانگرهای دسترسی‌پذیری بسازید که به رویدادهای gmp-click و ورودی صفحه‌کلید پاسخ می‌دهند. برای سفارشی‌سازی عمیق‌تر، نشانگرهای پیشرفته از HTML و CSS سفارشی پشتیبانی می‌کنند، ازجمله توانایی ایجاد نشانگرهای کاملاً سفارشی. برای برنامه‌های سه‌بعدی می‌توانید ارتفاعی را که نشانگر در آن ظاهر می‌شود کنترل کنید. نشانگرهای پیشرفته هم در نقشه‌های شطرنجی و هم در نقشه‌های بُرداری پشتیبانی می‌شوند (هرچند برخی‌از ویژگی‌ها در نقشه‌های شطرنجی دردسترس نیستند). برای استفاده از «نشانگرهای پیشرفته» به شناسه نقشه نیاز است (می‌توان از DEMO_MAP_ID استفاده کرد).

شروع به کار با نشانگرهای پیشرفته

سفارشی‌سازی رنگ، مقیاس، و تصویر نماد

پس‌زمینه، نویسه، و رنگ حاشیه نشانگر پیش‌فرض را سفارشی‌سازی کنید و اندازه نشانگر را تنظیم کنید.

نماگرفتی که چند نشانگر سفارشی‌شده را نشان می‌دهد.

نماد نشانگر پیش‌فرض را با تصویر SVG یا PNG سفارشی جایگزین کنید.

نماگرفتی که نشانگرهای SVG سفارشی را نشان می‌دهد.

ایجاد نشانگرهای HTML سفارشی

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

نماگرفتی که نشانگر HTML سفارشی را نشان می‌دهد.

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

با افزودن شنونده رویداد gmp-click، نشانگر را به کلیک‌ها و رویدادهای صفحه‌کلید پاسخگو کنید.

function initMap() {
  const map = new google.maps.Map(document.getElementById('map'), {
    center: {lat: 37.4239163, lng: -122.0947209},
    zoom: 17,
    mapId: 'DEMO_MAP_ID',
  });

  const marker = new google.maps.marker.AdvancedMarkerElement({
    map,
    position: {lat: 37.4239163, lng: -122.0947209},
  });

  marker.addEventListener('gmp-click', (event) => {
    // Handle the click event.
    // ...
  });
}

تنظیم ارتفاع نشانگر و رفتار تصادم

ارتفاع نشانگر را تنظیم کنید تا به‌درستی با عناصر سه‌بعدی نقشه نمایش داده شود، و مشخص کنید که نشانگر هنگام برخورد با نشانگر یا برچسب نقشه دیگر چگونه باید رفتار کند. ارتفاع نشانگر فقط در نقشه‌های بُرداری پشتیبانی می‌شود.

نماگرفتی که نشانگر تنظیم‌شده براساس ارتفاع را نشان می‌دهد.

مرحله بعدی