Data-driven styling

FeatureLayer 介面

google.maps.FeatureLayer 介面

這個介面代表內含特定 FeatureType 地圖項目的地圖樣式，您可以在用戶端覆寫該樣式，或附加事件。
featureType
類型：  FeatureType
與這個 FeatureLayer 相關聯的 FeatureType。
isAvailable
類型：  boolean
指出這個 FeatureLayer 是否可用，也就是這張地圖是否適用資料導向樣式 (在 Google Cloud Console 地圖樣式中啟用這個 FeatureLayer 的向量圖塊會使用地圖 ID)。如果設為 False (或變為 false)，這個 FeatureLayer 的樣式就會恢復預設值，且不會觸發事件。
BetadatasetId optional
類型：  string optional
這個 FeatureLayer 的資料集 ID。只有在 featureType 為 FeatureType.DATASET 時才會顯示。
style optional
FeatureLayer 中的 Feature 樣式。設定樣式後，系統就會套用樣式。如果樣式函式更新，您必須再次設定樣式屬性。當 FeatureStyleFunction 套用至地圖圖塊時，必須傳回一致的結果，且應針對效能進行最佳化。不支援非同步函式。如果使用 FeatureStyleOptions，該圖層的所有地圖項目都會使用相同的 FeatureStyleOptions 設定樣式。將樣式設為 null 即可移除先前設定的樣式。如果無法使用這個 FeatureLayer，設定樣式不會執行任何動作，並記錄錯誤。
addListener
addListener(eventName, handler)
參數： 
  • eventName：string 觀測事件。
  • handler：Function 用於處理事件的函式。
傳回值：  MapsEventListener 產生的事件監聽器。
將指定事件監聽器函式新增至指定事件名稱。傳回可與 event.removeListener 搭配使用的事件監聽器 ID。
click
function(event)
引數： 
使用者點選 FeatureLayer 時，會觸發這個事件。

FeatureType 常數

google.maps.FeatureType 常數

地圖項目類型的 ID。

呼叫 const {FeatureType} = await google.maps.importLibrary("maps") 即可存取。請參閱 Maps JavaScript API 中的程式庫。
ADMINISTRATIVE_AREA_LEVEL_1 表示國家/地區層級底下的第一順位行政實體。
ADMINISTRATIVE_AREA_LEVEL_2 表示國家/地區層級底下的第二順位行政實體。
COUNTRY 表示國家/地區政治實體。
BetaDATASET 代表第三方資料集。
LOCALITY 表示自治城市或鄉鎮的政治實體。
POSTAL_CODE 表示國家/地區郵政地址所使用的郵遞區號。

FeatureStyleFunction 類型

google.maps.FeatureStyleFunction typedef

用於設定 FeatureLayer 的函式。

function(FeatureStyleFunctionOptions): (FeatureStyleOptions optional)

FeatureStyleFunctionOptions 介面

google.maps.FeatureStyleFunctionOptions 介面

傳遞給 FeatureStyleFunction 的選項。
feature
類型：  Feature
將 Feature 傳入 FeatureStyleFunction 以設定樣式。

FeatureStyleOptions 介面

google.maps.FeatureStyleOptions 介面

這些選項會指定如何修改地圖上的 Feature 樣式。
fillColor optional
類型：  string optional
十六進位 RGB 字串 (例如「#00FF00」代表綠色)。僅適用於多邊形幾何圖形。
fillOpacity optional
類型：  number optional
填滿不透明度，範圍介於 0.0 和 1.0 之間。僅適用於多邊形幾何圖形。
strokeColor optional
類型：  string optional
十六進位 RGB 字串 (例如「#00FF00」代表綠色)。
strokeOpacity optional
類型：  number optional
筆劃不透明度，介於 0.0 和 1.0 之間。僅適用於線條和多邊形幾何圖形。
strokeWeight optional
類型：  number optional
筆劃寬度 (以像素為單位)。僅適用於線條和多邊形幾何圖形。

Feature 介面

google.maps.Feature 介面

這個介面代表向量地圖圖塊功能。這些是 FeatureStyleFunction 的輸入。請勿儲存特定 Feature 物件的參照，因為參照將會不穩定。
featureType
類型：  FeatureType
第 FeatureType 個，共 Feature 個。

PlaceFeature 介面

google.maps.PlaceFeature 介面

呈現包含地點 ID 的地圖項目，當中包含 FeatureType.ADMINISTRATIVE_AREA_LEVEL_1、FeatureType.ADMINISTRATIVE_AREA_LEVEL_2、FeatureType.COUNTRY、FeatureType.LOCALITY 和 FeatureType.POSTAL_CODE 類型的地圖項目。

這個介面會擴充 Feature。
placeId
類型：  string
PlaceResult.place_id。
繼承： featureType
fetchPlace
fetchPlace()
參數：無
傳回價值：  Promise<Place>
擷取這個 PlaceFeature 的 Place。產生的 Place 物件將填入 id 和 displayName 屬性。顯示名稱將是使用者在地圖上看到的語言。(你日後可能需要透過 Place.fetchFields() 要求其他欄位，取決於一般的 Places API 啟用和計費功能)。這項功能僅支援同步 FeatureStyleFunctions，因此請勿透過 FeatureStyleFunction 呼叫此方法。如果擷取 Place 時發生錯誤，則遭拒絕。

DatasetFeature 介面

google.maps.DatasetFeature 介面

代表資料集特徵的介面。DatasetFeature 的 featureType 一律為 FeatureType.DATASET。

這個介面會擴充 Feature。
datasetAttributes
類型：  Object<string, string>
地圖項目屬性的鍵/值對應。
datasetId
類型：  string
資料集所屬的資料集 ID。
繼承： featureType

FeatureMouseEvent 介面

google.maps.FeatureMouseEvent 介面

這個物件是從 FeatureLayer 的滑鼠事件傳回。

這個介面會擴充 MapMouseEvent。
features
類型：  Array<Feature>
這個滑鼠事件的 Feature。
繼承： domEvent、latLng
繼承： stop