כדי להגדיר באמצעות סמנים מתקדמים, צריך לפעול לפי השלבים הבאים.
קבלת מפתח API והפעלת ממשק JavaScript API של מפות Google
כדי להשתמש בסמנים מתקדמים, צריך להיות לכם פרויקט ב-Cloud עם חשבון לחיוב ולהפעיל את JavaScript API של מפות Google. למידע נוסף, קראו את המאמר הגדרת פרויקט ב-Google Cloud.
יצירת מזהה מפה
כדי ליצור מזהה מפה חדש, פועלים לפי השלבים שמפורטים במאמר התאמה אישית של Cloud. מגדירים את סוג המפה ל-JavaScript ובוחרים באפשרות Vector או באפשרות Raster.
עדכון הקוד של אתחול המפה
כדי לעשות את זה צריך את מזהה המפה שיצרתם. תוכלו למצוא אותו בדף ניהול מפות Google.
טוענים את ספריית הסמנים המתקדמים מתוך הפונקציה
async
כשיש צורך:const { AdvancedMarkerElement } = await google.maps.importLibrary("marker") as google.maps.MarkerLibrary;
צריך לספק מזהה מפה כשיוצרים את המפה באמצעות המאפיין
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. } });