請按照下列步驟設定進階標記預覽。
取得 API 金鑰並啟用 Maps JavaScript API
您需要擁有已連結帳單帳戶的 Cloud 專案,並啟用 Maps JavaScript API,才能使用進階標記預覽。詳情請參閱「設定 Google Cloud 專案」一文。
建立地圖 ID
如要建立新的地圖 ID,請按照「雲端自訂功能」一文中的步驟操作。請將地圖類型設為「JavaScript」,然後選取「向量」或「光柵」選項。
更新地圖初始化程式碼
這項操作需要使用您剛建立的地圖 ID,(可在「地圖管理」頁面中找到)。
在 API
script
標記中使用v=beta
和libraries=marker
。舉例來說:<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&v=beta&libraries=marker&callback=initMap"></script>
使用
mapId
屬性執行地圖個體化時,請提供地圖 ID。這個 ID 可以是您提供的地圖 ID,也可以是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' });
檢查地圖功能 (選用)
進階標記需要地圖 ID。如果缺少地圖 ID 或傳遞無效的地圖 ID,就無法載入進階標記。為了解決這個問題,您可以加入 mapcapabilities_changed
事件監聽器來訂閱地圖功能變更。這樣一來便可檢查是否符合下列條件:
- 使用有效的地圖 ID。
- 如果使用需要向量地圖的功能,地圖 ID 會與向量地圖建立關聯。
您不一定要使用「地圖功能」。我們建議只在測試、進行疑難排解或執行階段回退時才使用。
// 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. } });