אני רוצה לנסות

בחירת פלטפורמה: Android iOS JavaScript

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

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

כדי להשתמש בסמנים מתקדמים, צריך להיות לכם פרויקט ב-Cloud עם חשבון לחיוב ולהפעיל את JavaScript API של מפות Google. למידע נוסף, קראו את המאמר הגדרת פרויקט ב-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.
  }
});

השלבים הבאים

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