מתחילים

כדי להגדיר סמנים מתקדמים, פועלים לפי השלבים הבאים.

קבלת מפתח API והפעלת Maps JavaScript API

כדי להשתמש בסמנים מתקדמים, צריך פרויקט ב-Cloud עם חשבון לחיוב, וצריך להפעיל את Maps JavaScript API. מידע נוסף זמין במאמר הגדרת פרויקט בענן ב-Google Cloud.

קבלת מפתח API

יצירת מזהה מפה

כדי ליצור מזהה מפה חדש, פועלים לפי השלבים שמפורטים במאמר התאמה אישית בענן. מגדירים את סוג המפה ל-JavaScript ובוחרים באפשרות וקטור או רסטר.

עדכון קוד האתחול של המפה

לשם כך, צריך את מזהה המפה שיצרתם. אפשר למצוא אותו בדף ניהול מפות.

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

השלבים הבאים

הוספת סמן למפה