شروع به کار

پلتفرم مورد نظر را انتخاب کنید: اندروید، iOS، جاوا اسکریپت

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

یک کلید API دریافت کنید و API جاوا اسکریپت نقشه‌ها را فعال کنید

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

دریافت کلید API

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

برای ایجاد یک شناسه نقشه جدید، مراحل موجود در سفارشی‌سازی ابر را دنبال کنید. نوع نقشه را روی جاوا اسکریپت تنظیم کنید و یکی از گزینه‌های برداری (Vector) یا رستری (Raster) را انتخاب کنید.

مهم: برای آزمایش، می‌توانید با استفاده از mapId: 'DEMO_MAP_ID' در کد برنامه خود، از مرحله ایجاد و پیکربندی شناسه نقشه صرف نظر کنید.

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

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

1. 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'
   });

احتیاط: نقشه‌های نمونه برای نشانگرهای پیشرفته از شناسه‌های نقشه‌ای استفاده می‌کنند که به یک سبک نقشه با POI کاهش‌یافته پیوند داده شده‌اند. اگر از کد نمونه دوباره استفاده می‌کنید، توصیه می‌کنیم این شناسه‌های نقشه را با DEMO_MAP_ID یا با شناسه نقشه خودتان جایگزین کنید.

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

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

// 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.
  }
});

مراحل بعدی

یک نشانگر پیشرفته پیش‌فرض ایجاد کنید