GroundOverlay

區域疊加層是指固定於地圖上的圖片。區域疊加層的特點如下： 資源：

職位

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

• 使用位置：你必須提供區域疊加層的圖片，即 LatLng 錨點的固定，以及疊加層的寬度 (單位為公尺)。 錨點的預設位置為圖片頂端 50%，距離圖片左側 50% 圖片。這項設定可以變更。您可以視需要提供疊加層的高度 ( 公尺)。若您未提供疊加層的高度，則系統會自動定位。 為維持圖像比例
• 使用邊界：您必須提供要包含圖片的 LatLngBounds。

，瞭解如何調查及移除這項存取權。 您必須先指定區域疊加層的位置，才能將其加入地圖。 否則，系統會在區域疊加層IllegalArgumentException 已新增至地圖。此外，只有在您指定位置時， GroundOverlayOptions 物件中的方法；否則當使用第二個方法指定時，將會擲回 IllegalStateException。

圖片

要用於此疊加層的圖片 (以 BitmapDescriptor 表示)。圖片會是 縮放到符合指定位置的大小必須先指定圖片才能新增地面 疊加到地圖；否則會在 IllegalArgumentException 已新增至地圖。

航向

圖片應順時針方向旋轉的幅度。AI 開發原則的 旋轉則會是圖像的錨點。這是選用欄位，預設方位為 0，即 圖片對齊方式，也就是北方朝上。

zIndex

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

環境音模式

[0..1] 範圍中的區域疊加層透明度，其中 0 表示 疊加層為不透明，1 表示疊加層是完全透明的。如果指定 點陣圖已部分透明，因此每個像素的透明度會經過縮放 而不同 (例如，假設點陣圖中的像素值為 200 且您 將區域疊加層的透明度指定為 0.25，則像素會在 Alpha 值為 150 的畫面)。這項屬性為選填項目， 預設的透明度為 0 (不透明)。

能見度

指出區域疊加層是否可見或隱藏，亦即是否已在圖像上繪製 。隱形的區域疊加層不會繪製，但會保留所有其他屬性。 這是選用項目，預設瀏覽權限為 true，也就是可見。

可點擊屬性

如要處理使用者點選區域疊加層時觸發的事件，請設定這個 設為 true。您隨時可以變更這個值。預設值為 false。如果這個屬性設為 true，應用程式就會傳送通知給 GoogleMap.OnGroundOverlayClickListener已透過「setOnGroundOverlayClickListener(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));