شروع به کار

برای راه‌اندازی با نشانگرهای پیشرفته، این مراحل را دنبال کنید.

دریافت کلید میانای برنامه‌سازی کاربردی و فعال کردن Maps JavaScript API

قبل‌از استفاده از نشانگرهای پیشرفته، به پروژه Cloud با حساب صورت‌حساب و Maps JavaScript API فعال‌شده نیاز دارید. برای کسب اطلاعات بیشتر، راه‌اندازی پروژه Google Cloud را ببینید.

دریافت کلید میانای برنامه‌سازی کاربردی

ایجاد شناسه نقشه

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

کد مقداردهی اولیه نقشه را به‌روز کنید

این کار به شناسه نقشه‌ای که تازه ایجاد کرده‌اید نیاز دارد. می‌توانید آن را در صفحه مدیریت Maps پیدا کنید.

1. بار کردن Maps JavaScript API.

2. درصورت نیاز، کتابخانه نشانگرهای پیشرفته را از داخل تابع async بار کنید:

   const { AdvancedMarkerElement } = await google.maps.importLibrary("marker") as google.maps.MarkerLibrary;

3. هنگام نمونه‌سازی نقشه بااستفاده از ویژگی mapId، شناسه نقشه را ارائه دهید. این می‌تواند شناسه نقشه‌ای باشد که شما ارائه می‌دهید، یا DEMO_MAP_ID.

   const map = new
   google.maps.Map(document.getElementById('map'), {
     center: {lat: -34.397, lng: 150.644},
     zoom: 8,
     mapId: 'YOUR_MAP_ID'
   });

بررسی قابلیت‌های نقشه (اختیاری)

نشانگرهای پیشرفته به شناسه نقشه نیاز دارند. اگر شناسه نقشه وجود نداشته باشد، نشانگرهای پیشرفته بار نمی‌شوند. به‌عنوان مرحله عیب‌یابی، می‌توانید شنونده mapcapabilities_changed اضافه کنید تا در تغییرات قابلیت نقشه مشترک شوید. استفاده از «قابلیت‌های نقشه» اختیاری است و فقط برای اهداف آزمایشی و عیب‌یابی یا برای اهداف بازگشت زمان اجرا توصیه می‌شود.

// Optional: subscribe to map capability changes.
map.addListener('mapcapabilities_changed', () => {
  const mapCapabilities = map.getMapCapabilities();

  if (!mapCapabilities.isAdvancedMarkersAvailable) {
    // Advanced markers are *not* available, add a fallback.
  }
});

مراحل بعدی

افزودن نشانگر به نقشه