導入 Parcelable
定義區域疊加層的選項。
常數摘要
float | NO_DIMENSION | 未指定高度的尺寸時標記。 |
繼承常數摘要
公用建構函式摘要
GroundOverlayOptions()
建立新的一組區域疊加層選項。
|
公用方法摘要
繼承方法摘要
常數
公開靜態最終浮點值 NO_DIMENSION
未指定高度的尺寸時標記。
公用建構函式
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 座標 |
傳回
- 透過新的錨點集使用這個
GroundOverlayOptions
物件。
public GroundOverlayOptions bearing (float bearing)
以從北順時針方向,指定區域疊加層的方位。系統會對錨點進行旋轉。如未指定,則預設值為 0 (即圖片上方指向北方)。
請注意,系統會在旋轉前套用經緯度邊界。
參數
方位 | 就能從北方順時針旋轉方位範圍 [0, 360) 範圍以外的值會經過正規化處理。 |
---|
傳回
- 這個
GroundOverlayOptions
物件搭配新的軸承組合。
public GroundOverlayOptions clickable (布林值可點擊)
public float getAnchorU ()
水平相對錨點;0.0
和 1.0
分別代表左右邊緣。系統會據此插入其他錨點值。
傳回
- 水平邊緣相對錨點位置。
public float getAnchorV ()
垂直相對錨點;0.0
和 1.0
分別表示頂部和底部邊緣。系統會據此插入其他錨點值。
傳回
- 垂直邊緣相關錨點位置。
公開 LatLngBounds getBounds ()
取得這個 GroundOverlayOptions
物件的邊界。
傳回
- 區域疊加層的界限。如果使用
position(LatLng, float)
或position(LatLng, float, float)
設定位置,此值會是null
public BitmapDescriptor getImage ()
取得這個 GroundOverlayOptions
物件的圖片描述元設定。
傳回
BitmapDescriptor
代表區域疊加層圖片。
public LatLng getLocation ()
取得這個 GroundOverlayOptions
物件的位置設定。
傳回
- 放置區域疊加層錨點的位置。如果使用
positionFromBounds(LatLngBounds)
設定位置,則此值為null
。
public GroundOverlayOptions image (BitmapDescriptor imageDescriptor)
指定此區域疊加層的圖片。
如要將圖像載入為紋理 (用來在地圖上繪製圖片),就必須將圖片轉換成邊長為二次方的圖片。這樣做可以建立 mipmap,以在不同縮放等級算繪紋理。詳情請參閱Mipmap (維基百科)。因此,若要避免這項轉換來節省記憶體,建議圖片尺寸是二的次方。
參數
imageDescriptor | 此區域疊加層要使用的 BitmapDescriptor |
---|
傳回
- 新增圖片集的
GroundOverlayOptions
物件。
public boolean isClickable ()
取得這個 GroundOverlayOptions
物件的可點擊性設定。
傳回
- 如果區域疊加層為可點擊,則為
true
;如果不點擊,則為false
。
public boolean isVisible ()
取得這個 GroundOverlayOptions
物件的瀏覽權限設定。
傳回
- 如果會顯示此區域疊加層,則為
true
;如果不顯示,則為false
。
public GroundOverlayOptions position (LatLng 位置、浮點寬度)
使用錨點 (LatLng
) 和寬度 (以公尺為單位) 指定這個區域疊加層的位置。系統會據此調整高度來維持顯示比例。
參數
位置 | 地圖上 LatLng 的位置,指定圖片中的錨點會保持固定。套用轉換時 (例如 setDimensions、setBearing 等),錨點會保持固定在地面上的位置。 |
---|---|
width | 疊加層的寬度 (單位為公尺)。高度會自動根據圖片的長寬比決定。 |
傳回
- 設定新的位置的
GroundOverlayOptions
物件。
擲回
IllegalArgumentException | 如果錨點是 null |
---|---|
IllegalArgumentException | 如果寬度為負數 |
IllegalStateException | 如果該位置原本是以 positionFromBounds(LatLngBounds) 設定而成,
|
public GroundOverlayOptions position (LatLng 位置、浮點寬度、浮點高度)
使用錨點 (LatLng
)、寬度和高度 (以公尺為單位) 指定這個區域疊加層的位置。算繪後,系統會將圖片調整為符合指定尺寸。
參數
位置 | 地圖上 LatLng 的位置,指定圖片中的錨點會保持固定。套用轉換時 (例如 setDimensions、setBearing 等),錨點會保持固定在地面上的位置。 |
---|---|
width | 疊加層的寬度 (以公尺為單位) |
height | 疊加層的高度 (以公尺為單位) |
傳回
- 設定新的位置的
GroundOverlayOptions
物件。
擲回
IllegalArgumentException | 如果錨點是 null |
---|---|
IllegalArgumentException | 如果寬度或高度為負數 |
IllegalStateException | 如果該位置原本是以 positionFromBounds(LatLngBounds) 設定而成,
|
public GroundOverlayOptions positionFromBounds (LatLngBounds 範圍)
指定此區域疊加層的位置。
參數
邊界 | 用於放置區域疊加層的 LatLngBounds |
---|
傳回
- 設定新的位置的
GroundOverlayOptions
物件。
擲回
IllegalStateException | 如果該位置之前是使用 position(LatLng, float) 或 position(LatLng, float, float) 進行設定,
|
---|
public GroundOverlayOptions transparency (浮點透明度)
指定區域疊加層的透明度。預設的透明度為 0
(不透明)。
參數
資料使用方式 | 範圍為 [0..1] 的浮點數,其中 0 表示區域疊加層不透明,1 表示區域疊加層為透明。 |
---|
傳回
- 支援新的透明度設定的
GroundOverlayOptions
物件。
擲回
IllegalArgumentException | 如果透明度落在 [0..1] 範圍外 |
---|
public GroundOverlayOptions visible (boolean visible)
public GroundOverlayOptions zIndex (float zIndex)
指定區域疊加層的 zIndex,也就是區域的繪製順序。如要進一步瞭解 zIndex,請參閱這個類別頂端的說明文件。
參數
zIndex |
---|
傳回
- 這個
GroundOverlayOptions
物件和新的 zIndex 集組合。