GroundOverlayOptions

透過集合功能整理內容 你可以依據偏好儲存及分類內容。
公開最終類別 GroundOverlayOptions 擴充物件
實作 Parcelable

定義區域疊加層的選項。

常數摘要

浮動 未選取 針對未指定高度的維度時加上標記。

繼承常數摘要

公用建構函式摘要

GroundOverlayOptions()
建立新的一組區域疊加層選項。

公用方法摘要

GroundOverlayOptions
anchor (float u, float v)
指定錨點。
GroundOverlayOptions
軸承(浮點軸承)
指定從地面向北的順時針旋轉角度。
GroundOverlayOptions
clickable (布林值可點擊)
指定區域疊加層是否可點擊。
浮點值
getAnchorU()
水平相對錨點;0.01.0 分別代表左側和右側邊緣。
浮點值
getAnchorV()
垂直相對錨點;0.01.0 分別代表頂端和底部邊緣。
浮點值
getBearing()
取得這個 GroundOverlayOptions 物件的軸承組合。
LatLngBounds
getBounds()
取得這個 GroundOverlayOptions 物件的邊界。
浮點值
getHeight()
取得這個 GroundOverlayOptions 物件的高度。
BitmapDescriptor
getImage()
取得這個 GroundOverlayOptions 物件的圖片描述元集。
LatLng
getLocation()
取得這個 GroundOverlayOptions 物件的位置設定。
浮點值
getTransparency()
取得這個 GroundOverlayOptions 物件的透明度設定。
浮點值
getWidth()
取得這個 GroundOverlayOptions 物件的寬度。
浮點值
getZIndex()
取得這個 GroundOverlayOptions 物件的 zIndex。
GroundOverlayOptions
image(BitmapDescriptor imageDescriptor)
指定這個區域疊加層的圖片。
布林
isClickable()
取得此 GroundOverlayOptions 物件的可點擊設定。
布林
isVisible()
取得這個 GroundOverlayOptions 物件的顯示設定。
GroundOverlayOptions
position(LatLng 位置、浮點寬度)
使用錨點 (LatLng) 和寬度 (公尺) 來指定這個區域疊加層的位置。
GroundOverlayOptions
position (LatLng 位置、浮點寬度、浮點高度)
使用錨點 (LatLng)、寬度和高度 (以公尺為單位) 指定這個區域疊加層的位置。
GroundOverlayOptions
positionFromBounds(LatLngBounds 範圍)
指定這個區域疊加層的位置。
GroundOverlayOptions
transparency (浮點透明度)
指定區域疊加層的透明度。
GroundOverlayOptions
visible(布林值顯示)
指定區域疊加層的顯示設定。
GroundOverlayOptions
zIndex(浮點 zIndex)
指定區域疊加層的 zIndex,也就是繪製繪圖的順序。

繼承方法摘要

常數

公開靜態 浮動值 NO_DIMENSION

針對未指定高度的維度時加上標記。

常數值: -1.0

公用建構函式

public GroundOverlayOptions()

建立新的一組區域疊加層選項。

公用方法

publicGroundOverlayOptionsanchor(float u, float v)

指定錨點。

錨點會與區域疊加層的位置對齊。

錨點位於 2D 連續空間中,其中 (0,0)、(1.0)、(0,1) 和 (1,1) 分別代表左上角、右上方、左下角和右下角。

 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----+-----+
 |     |     |   X |     |   (U, V) = (0.7, 0.6)
 |     |     |     |     |
 *-----+-----+-----+-----*
 

參數
u 錨點的 u 座標
非常 錨點的 v 座標
傳回

公開 GroundOverlayOptions 航向 (浮動軸承)

指定從地面向北的順時針旋轉角度。旋轉會以錨點執行。如未指定,則預設為 0 (即圖片點為北方)。

請注意,緯度在旋轉之前會套用。

參數
方位 方位朝北,順時針旋轉。[0, 360] 範圍外的值會正規化。
傳回

publicGroundOverlayOptionsclickable(布林值可點擊)

指定區域疊加層是否可點擊。預設可點擊屬性為 false

參數
可點擊 新的可點擊設定。
傳回

public float getAnchorU ()

水平相對錨點;0.01.0 分別代表左側和右側邊緣。其他的錨定值會視情況插值。

傳回
  • 水平邊緣的錨點位置。

public float getAnchorV ()

垂直相對錨點;0.01.0 分別代表頂端和底部邊緣。其他的錨定值會視情況插值。

傳回
  • 垂直邊緣的錨定位置。

public float getBearing ()

取得這個 GroundOverlayOptions 物件的軸承組合。

傳回
  • 區域疊加層的航向。

public LatLngBoundsgetBounds()

取得這個 GroundOverlayOptions 物件的邊界。

傳回

public float getHeight ()

取得這個 GroundOverlayOptions 物件的高度。

傳回
  • 區域疊加層的高度。

publicBitmapDescriptorgetImage()

取得這個 GroundOverlayOptions 物件的圖片描述元集。

傳回

公開 LatLng getLocation ()

取得這個 GroundOverlayOptions 物件的位置設定。

傳回

public float getTransparency ()

取得這個 GroundOverlayOptions 物件的透明度設定。

傳回
  • 區域疊加層的透明度。

public float getWidth ()

取得這個 GroundOverlayOptions 物件的寬度。

傳回
  • 區域疊加層的寬度。

public float getZIndex ()

取得這個 GroundOverlayOptions 物件的 zIndex。

傳回
  • 區域疊加層的 zIndex。

public GroundOverlayOptions image (BitmapDescriptor imageDescriptor)

指定這個區域疊加層的圖片。

如要以圖片形式載入圖片 (用來在地圖上繪製圖片),您必須將圖片轉換成兩側為 2 的冪次方的圖片。這樣一來,您就能建立 mipmap,以在不同縮放等級轉譯紋理,詳情請參閱mipmap (維基百科)。因此,如要避免系統發生這種轉換,建議您保留圖片的尺寸為 2 的冪次方,藉此節省記憶體。

參數
圖片描述元 用於此區域疊加層的 BitmapDescriptor
傳回

public 布林值 isClickable ()

取得此 GroundOverlayOptions 物件的可點擊設定。

傳回
  • 如果區域疊加層可點擊,請設為 true;否則為 false

公開布林值 isVisible ()

取得這個 GroundOverlayOptions 物件的顯示設定。

傳回
  • 如果此區域疊加層為可見,則為 true;如未顯示,則為 false

public GroundOverlayOptions position (LatLng 位置,浮點寬度)

使用錨點 (LatLng) 和寬度 (公尺) 來指定這個區域疊加層的位置。高度也會配合調整,維持長寬比。

參數
位置 地圖 LatLng 中特定錨點的錨點位置會保持修正的位置。套用轉換時,錨點會固定在地面的位置 (例如 setDimensions、setBearing 等)。
寬度 疊加層的寬度 (單位為公尺)。系統會根據圖片長寬比自動決定高度。
傳回
擲回
IllegalArgumentException 如果錨點為 null
IllegalArgumentException 寬度為負數
IllegalStateException 如果已使用 positionFromBounds(LatLngBounds) 設定這個位置

public GroundOverlayOptions position (LatLng 位置、浮點寬度、浮點高度)

使用錨點 (LatLng)、寬度和高度 (以公尺為單位) 指定這個區域疊加層的位置。轉譯完成後,系統會將圖片調整為符合指定尺寸的大小。

參數
位置 地圖 LatLng 中特定錨點的錨點位置會保持修正的位置。套用轉換時,錨點會固定在地面的位置 (例如 setDimensions、setBearing 等)。
寬度 疊加層的寬度 (單位為公尺)
高度 疊加層的高度 (以公尺為單位)
傳回
擲回
IllegalArgumentException 如果錨點為 null
IllegalArgumentException 如果寬度或高度為負值
IllegalStateException 如果已使用 positionFromBounds(LatLngBounds) 設定這個位置

public GroundOverlayOptions positionFromBounds (LatLngBounds 邊界)

指定這個區域疊加層的位置。

參數
邊界 LatLngBounds:放置區域疊加層的
傳回
擲回
IllegalStateException 如果已經使用 position(LatLng, float)position(LatLng, float, float) 設定位置

公開 GroundOverlayOptions 透明度 (浮動透明度)

指定區域疊加層的透明度。預設透明度為 0 (不透明)。

參數
資訊公開 範圍為 [0..1] 的浮點,其中 0 表示區域疊加層不透明,1 代表區域疊加層為透明。
傳回
擲回
IllegalArgumentException 如果透明度超出範圍 [0..1] 即可。

public GroundOverlayOptions visible (布林值顯示)

指定區域疊加層的顯示設定。預設瀏覽權限為 true

參數
顯示
傳回

publicGroundOverlayOptionszIndex(float zIndex)

指定區域疊加層的 zIndex,也就是繪製繪圖的順序。如要進一步瞭解 zIndex,請參閱這個類別頂端的說明文件。

參數
ZIndex
傳回