開始使用

請按照下列步驟設定進階標記預覽。

取得 API 金鑰並啟用 Maps JavaScript API

您需要擁有已連結帳單帳戶的 Cloud 專案，並啟用 Maps JavaScript API，才能使用進階標記預覽。詳情請參閱「設定 Google Cloud 專案」一文。

取得 API 金鑰

建立地圖 ID

如要建立新的地圖 ID，請按照「雲端自訂功能」一文中的步驟操作。請將地圖類型設為「JavaScript」，然後選取「向量」或「光柵」選項。

建立向量地圖 ID

更新地圖初始化程式碼

這項操作需要使用您剛建立的地圖 ID，(可在「地圖管理」頁面中找到)。

  1. 在 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>

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

後續步驟

建立預設進階標記