區域疊加層

區域疊加層是指固定於地圖上的圖片。區域疊加層的屬性如下：

位置

有兩種方法可指定區域疊加層的位置：

• 使用位置：您必須提供區域疊加層的圖片、固定錨點的 LatLng 以及疊加層的寬度 (單位為公尺)。根據預設，錨點距離圖片頂端 50% 和圖片左側 50%。這項設定無法變更。您也可以視情況提供疊加層的高度 (單位為公尺)。如未提供疊加層的高度，系統會自動計算並維持圖片比例。
• 使用邊界：您必須提供包含圖片的 LatLngBounds。

您必須指定區域疊加層的位置，才能將其加入地圖，否則當區域疊加層加入地圖時，系統將擲回 IllegalArgumentException。此外，您必須使用 GroundOverlayOptions 物件中的其中一種方法指定位置；否則在使用第二個方法指定時，系統會擲回 IllegalStateException。

圖片

要用於此重疊的圖片。BitmapDescriptor系統會根據提供的位置縮放圖片。您必須先指定圖片，才能將區域疊加層加到地圖中；如未將 IllegalArgumentException 加入地圖，系統將擲回。

航向

圖片可順時針旋轉的角度。旋轉的中心是圖片的錨點。此為選用元素，預設航向為 0，即圖片會對齊北方。

zIndex

此區域疊加層相對於其他疊加層 (包括 Polyline 和 TileOverlay，但不是 Marker) 的繪製順序。系統會將 zIndex 較大的疊加層繪製在 zIndex 較少的疊加層上。具有相同 ZIndex 值的疊加層順序為任意順序。這是選用項目，預設的 zIndex 值為 0。

透明度

區域疊加層的透明度在 [0..1] 範圍內，其中 0 表示疊加層不透明，1 表示疊加層完全透明。如果指定的點陣圖已經是部分透明的，則每個像素的透明度都會隨之調整 (例如，如果點陣圖中的像素的 Alpha 值是 200，而區域疊加層的透明度為 0.25，則像素會在螢幕上顯示 Alpha 值為 150)。此屬性的規格為選用項目，預設透明度為 0 (不透明)。

顯示設定

指出區域疊加層是否可見，即是否在地圖上繪製。系統不會繪製隱藏的區域疊加層，但會保留所有其他屬性。這是選用元素，預設的顯示設定為 true，也就是可見的項目。

可點擊性

如要處理使用者點選區域疊加層時觸發的事件，請將這個屬性設為 true。您隨時可以變更這個值。預設值為 false。如果這個屬性設為 true，應用程式將會收到透過 setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener) 註冊的 GoogleMap.OnGroundOverlayClickListener 通知。

標記

與區域疊加層相關聯的 Object。舉例來說，Object 可包含區域疊加層的代表資料。這種做法比儲存單獨的 Map<GroundOverlay, Object> 更輕鬆。另一個例子是，您可以將 String 對應的 ID 與資料集中的 ID 建立關聯。Google Maps SDK for Android 不會讀取或寫入這項屬性。

此類別的方法必須在 Android UI 執行緒上呼叫。否則，系統會在執行階段擲回 IllegalStateException。

範例

GoogleMap map = ...; // get a map.
 BitmapDescriptor imageDescriptor = ...; // get an image.
 LatLngBounds bounds = ...; // get a bounds
 // Adds a ground overlay with 50% transparency.
 GroundOverlay groundOverlay = map.addGroundOverlay(new GroundOverlayOptions()
     .image(imageDescriptor)
     .positionFromBounds(bounds)
     .transparency(0.5));