GroundOverlayOptions

公開最終類別 GroundOverlayOptions 擴充物件
導入 Parcelable

定義區域疊加層的選項。

常數摘要

float NO_DIMENSION 未指定高度的尺寸時標記。

繼承常數摘要

公用建構函式摘要

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

公用方法摘要

GroundOverlayOptions
anchor(float u, float v)
指定錨定標記。
GroundOverlayOptions
bearing(浮動方位)
以從北順時針方向,指定區域疊加層的方位。
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
透明度(浮點透明度)
指定區域疊加層的透明度。
GroundOverlayOptions
visible(布林值可見)
指定區域疊加層的顯示設定。
GroundOverlayOptions
zIndex(float zIndex)
指定區域疊加層的 zIndex,也就是區域的繪製順序。

繼承方法摘要

常數

公開靜態最終浮點值 NO_DIMENSION

未指定高度的尺寸時標記。

常數值: -1.0

公用建構函式

public GroundOverlayOptions ()

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

公用方法

public GroundOverlayOptions anchor (float u, float v)

指定錨定標記。

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

錨點是以 2D 連續空間指定,其中 (0,0)、(1,0)、(0,1) 和 (1,1) 分別表示左上角、右上角、左下和右下角。

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

參數
u 錨定標記的 u 座標
v 錨定標記的 v 座標
傳回

public GroundOverlayOptions bearing (float bearing)

以從北順時針方向,指定區域疊加層的方位。系統會對錨點進行旋轉。如未指定,則預設值為 0 (即圖片上方指向北方)。

請注意,系統會在旋轉前套用經緯度邊界。

參數
方位 就能從北方順時針旋轉方位範圍 [0, 360) 範圍以外的值會經過正規化處理。
傳回

public GroundOverlayOptions clickable (布林值可點擊)

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

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

public float getAnchorU ()

水平相對錨點;0.01.0 分別代表左右邊緣。系統會據此插入其他錨點值。

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

public float getAnchorV ()

垂直相對錨點;0.01.0 分別表示頂部和底部邊緣。系統會據此插入其他錨點值。

傳回
  • 垂直邊緣相關錨點位置。

public float getBearing ()

取得此 GroundOverlayOptions 物件的方位集。

傳回
  • 區域疊加層的方位。

公開 LatLngBounds getBounds ()

取得這個 GroundOverlayOptions 物件的邊界。

傳回

public float getHeight ()

取得為此 GroundOverlayOptions 物件設定的高度。

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

public BitmapDescriptor getImage ()

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

傳回

public LatLng getLocation ()

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

傳回

public float getTransparency ()

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

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

public float getWidth ()

取得這個 GroundOverlayOptions 物件的寬度。

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

public float getZIndex ()

取得這個 GroundOverlayOptions 物件的 zIndex 集。

傳回
  • 區域疊加層的 zIndex。

public GroundOverlayOptions image (BitmapDescriptor imageDescriptor)

指定此區域疊加層的圖片。

如要將圖像載入為紋理 (用來在地圖上繪製圖片),就必須將圖片轉換成邊長為二次方的圖片。這樣做可以建立 mipmap,以在不同縮放等級算繪紋理。詳情請參閱Mipmap (維基百科)。因此,若要避免這項轉換來節省記憶體,建議圖片尺寸是二的次方。

參數
imageDescriptor 此區域疊加層要使用的 BitmapDescriptor
傳回

public boolean isClickable ()

取得這個 GroundOverlayOptions 物件的可點擊性設定。

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

public boolean isVisible ()

取得這個 GroundOverlayOptions 物件的瀏覽權限設定。

傳回
  • 如果會顯示此區域疊加層,則為 true;如果不顯示,則為 false

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

使用錨點 (LatLng) 和寬度 (以公尺為單位) 指定這個區域疊加層的位置。系統會據此調整高度來維持顯示比例。

參數
位置 地圖上 LatLng 的位置,指定圖片中的錨點會保持固定。套用轉換時 (例如 setDimensions、setBearing 等),錨點會保持固定在地面上的位置。
width 疊加層的寬度 (單位為公尺)。高度會自動根據圖片的長寬比決定。
傳回
擲回
IllegalArgumentException 如果錨點是 null
IllegalArgumentException 如果寬度為負數
IllegalStateException 如果該位置原本是以 positionFromBounds(LatLngBounds) 設定而成,

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

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

參數
位置 地圖上 LatLng 的位置,指定圖片中的錨點會保持固定。套用轉換時 (例如 setDimensions、setBearing 等),錨點會保持固定在地面上的位置。
width 疊加層的寬度 (以公尺為單位)
height 疊加層的高度 (以公尺為單位)
傳回
擲回
IllegalArgumentException 如果錨點是 null
IllegalArgumentException 如果寬度或高度為負數
IllegalStateException 如果該位置原本是以 positionFromBounds(LatLngBounds) 設定而成,

public GroundOverlayOptions positionFromBounds (LatLngBounds 範圍)

指定此區域疊加層的位置。

參數
邊界 用於放置區域疊加層的 LatLngBounds
傳回
擲回
IllegalStateException 如果該位置之前是使用 position(LatLng, float)position(LatLng, float, float) 進行設定,

public GroundOverlayOptions transparency (浮點透明度)

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

參數
資料使用方式 範圍為 [0..1] 的浮點數,其中 0 表示區域疊加層不透明,1 表示區域疊加層為透明。
傳回
擲回
IllegalArgumentException 如果透明度落在 [0..1] 範圍外

public GroundOverlayOptions visible (boolean visible)

指定區域疊加層的顯示設定。預設的顯示設定為 true

參數
顯示
傳回

public GroundOverlayOptions zIndex (float zIndex)

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

參數
zIndex
傳回