開始使用

請按照下列步驟設定資料集資料導向樣式 (預先發布版)。

取得 API 金鑰並啟用 API

您需要擁有已連結帳單帳戶的 Cloud 專案,並啟用 Maps JavaScript API 和 Maps Datasets API,才能使用資料集資料導向樣式 (預先發布版)。詳情請參閱「設定 Google Cloud 專案」一文。

取得 API 金鑰

啟用 Maps JavaScript API

啟用 Maps Datasets API

建立地圖 ID

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

將地圖例項化時,請使用 mapId 屬性提供地圖 ID。 地圖 ID 對應的地圖樣式必須與要顯示的資料集相關聯。

const position = new google.maps.LatLng(40.75, -74.05);
const map = new google.maps.Map(document.getElementById('map'), {
  zoom: 11,
  center: position,
  mapId: 'YOUR_MAP_ID',
});

建立向量地圖 ID

建立新地圖樣式

如要建立新地圖樣式,請按照「管理地圖樣式」一文中的說明操作,並將樣式與剛建立的地圖 ID 建立關聯

更新地圖初始化程式碼

如要使用資料集資料導向樣式 (預先發布版),請先在應用程式程式碼中加入內嵌 Bootstrap 載入器來載入 Maps JavaScript API,如下所示 (在 API script 代碼中使用 v=beta):

<script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "beta",
    // Use the 'v' parameter to indicate the version to use (weekly, beta, alpha, etc.).
    // Add other bootstrap parameters as needed, using camel case.
  });
</script>

檢查地圖功能 (選用)

如要使用資料集資料導向樣式,需要有地圖 ID。如果缺少地圖 ID 或傳遞無效的地圖 ID,就無法載入資料地圖項目。如要解決這個問題,您可以加入 mapcapabilities_changed 事件監聽器,訂閱地圖功能變更。這樣一來便可檢查是否符合下列條件:

  • 使用有效的地圖 ID。
  • 地圖 ID 與向量地圖相關聯。

您不一定要使用「地圖功能」。我們建議只在測試、進行疑難排解或執行階段回退時才使用。

// Optional: subscribe to map capability changes.
map.addListener('mapcapabilities_changed', () => {
  const mapCapabilities = map.getMapCapabilities();

  if (!mapCapabilities.isDataDrivenStylingAvailable) {
    // Data-driven styling is *not* available, add a fallback.
    // Existing feature layers are also unavailable.
  }
});

後續步驟