מתחילים

הפלטפורמה: Android iOS JavaScript

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

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

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

קבלת מפתח API

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

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

חשוב: לצורך בדיקה, אפשר לדלג על השלב של יצירה והגדרה של מזהה מפה, ולהשתמש ב-mapId: 'DEMO_MAP_ID' בקוד האפליקציה.

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

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

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

שימו לב: במפות לדוגמה של סמנים מתקדמים נעשה שימוש במזהי מפות שמקושרים לסגנון מפה עם מספר מופחת של נקודות עניין. אם אתם משתמשים מחדש בקוד לדוגמה, מומלץ להחליף את מזהי המפות האלה ב-DEMO_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.
  }
});

השלבים הבאים

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