開始使用

選取平台： Android iOS JavaScript

請按照下列步驟設定界線資料導向樣式。

啟用新版地圖轉譯器

自 Maps SDK for Android 18.0.0 版起，您可以使用升級版地圖轉譯器。這個轉譯器為 Maps SDK for Android 帶來多項改善，包括支援雲端式地圖樣式設定。

隨著 Maps SDK for Android 18.2.0 版推出，Google 將預設轉譯器從舊版改為升級版地圖轉譯器。也就是說，當您建立新應用程式或重建現有應用程式時，現在預設使用的是升級版地圖轉譯器。

注意：如要在應用程式中使用以資料為準樣式設定邊界，建構應用程式時請務必使用升級版地圖轉譯器。如要在現有應用程式中加入界線資料導向樣式，請務必重建應用程式，確保使用升級版地圖轉譯器。詳情請參閱「新版地圖轉譯器」一文。

建立地圖 ID

如要建立新的地圖 ID，請按照「建立地圖 ID」一文中的步驟操作。請務必將地圖類型設定為 Android。

建立新地圖樣式

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

在新地圖樣式中選取地圖項目圖層

在 Google API 控制台中，您可以選取要為新地圖樣式顯示哪些地圖項目圖層。地圖項目圖層會決定哪些界線類型 會出現在地圖上 (例如縣市、州/省等等)。

重要事項：為求最佳效能，請只選取您需要的圖層。

1. 在 Google API 控制台中，前往「地圖樣式」頁面。
2. 畫面出現提示時，請選取專案。
3. 選取地圖樣式。
4. 按一下「地圖項目圖層」下拉式選單，即可新增或移除圖層。
5. 按一下「儲存」，即可儲存您所做的變更並套用到地圖。

更新地圖初始化程式碼

這個步驟需要使用您剛建立的地圖 ID，請前往 地圖管理頁面。

如要在初始化程式碼中加入地圖 ID，請參閱「在應用程式中加入地圖 ID」一文。

使用地圖地圖項目圖層

您使用 FeatureLayer 物件，以代表地圖中每個地圖項目圖層，如：郵遞區號或 縣市地圖項目圖層。如要存取地圖項目圖層物件，請呼叫 GoogleMap.getFeatureLayer()敬上 地圖初始化時：

Java

private FeatureLayer postalCodeLayer;

@Override
public void onMapReady(GoogleMap map) {
  // Get the POSTAL_CODE feature layer.
  postalCodeLayer = map.getFeatureLayer(new FeatureLayerOptions.Builder()
    .featureType(FeatureType.POSTAL_CODE)
    .build());
  ...
}

Kotlin

private var postalCodeLayer: FeatureLayer? = null

override fun onMapReady(googleMap: GoogleMap) {
  // Get the POSTAL_CODE feature layer.
  postalCodeLayer = googleMap.getFeatureLayer(new FeatureLayerOptions.Builder()
    .featureType(FeatureType.POSTAL_CODE)
    .build())
  ...
}

將 FeatureLayerOptions 物件傳遞至 getFeatureLayer()，以指定地圖層的類型。在這個範例中，您要存取 POSTAL_CODE 圖層。為每個要設定樣式的圖層建立不同的 FeatureLayer 物件。

取得 FeatureLayer 物件後，您就可以為該地圖項目中的邊界多邊形套用樣式。

注意： 如果地圖不存在指定類型的 FeatureLayer，或 如果未啟用界線資料導向樣式 這個呼叫會傳回錯誤，但這個呼叫會記錄錯誤。使用 FeatureLayer.isAvailable() 方法判斷是否有 FeatureLayer。

檢查地圖功能 (必要)

如要使用界線資料導向樣式，需要有地圖 ID。如果地圖 ID 缺少或 傳遞的地圖 ID 無效，因此無法載入界線資料導向樣式。您可以使用 MapCapabilities 進行疑難排解，確認系統是否支援界線資料導向樣式。

注意：部分裝置可能不支援新版地圖轉譯器，因此無法顯示邊界資料導向樣式。請務必在執行階段使用 MapCapabilities 檢查是否提供支援。如果 不支援界線資料導向樣式，請定義備用選項。 如要瞭解新版地圖轉譯器的裝置要求，請參閱「支援的裝置」一文。

Kotlin

val capabilities: MapCapabilities = googleMap.getMapCapabilities()
System.out.println("Data-driven Styling is available: " + capabilities.isDataDrivenStylingAvailable())

Java

MapCapabilities capabilities = googleMap.getMapCapabilities();
System.out.println("Data-driven Styling is available: " + capabilities.isDataDrivenStylingAvailable());