GroundOverlay

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

位置

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

• 使用位置：您必須提供區域疊加層的圖片、固定位置的 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> 容易。另一個例子是，您可以將與資料集 ID 對應的 String 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));