תחילת העבודה

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

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

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

קבלת מפתח API

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

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

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

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

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

השלבים הבאים

יצירת סמן מתקדם שמוגדר כברירת מחדל