implements Parcelable
定義區域疊加層的選項。
常數摘要
float | NO_DIMENSION | 未指定高度維度時,系統會加上標記。 |
繼承常數摘要
公用建構函式摘要
GroundOverlayOptions()
建立新的一組新的區域疊加層選項。
|
公用方法摘要
繼承方法摘要
常數
公開 靜態 最終 浮點值 NO_DIMENSION
未指定高度維度時會加上標記。
公用建構函式
公開 GroundOverlayOptions ()
建立新的一組新的區域疊加層選項。
公用方法
公開 GroundOverlayOptions 錨定 (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
物件與新的錨點集建立而成。
公開 GroundOverlayOptions 熊熊 (浮點值)
指定從北順時針方向,地面疊加層的方位 (以度為單位)。旋轉角度為 針對錨點所做的變更如未指定,則預設值為 0 (即在圖片上方) 指向北方)。
請注意,經度的邊界會在旋轉之前套用。
參數
方位 | 從北順時針方向以度為單位範圍外的值 [0, 360) 也就是經過正規化處理的程序 |
---|
傳回
- 新的航向集,建立
GroundOverlayOptions
物件。
公開 GroundOverlayOptions 可點擊 (可點擊的布林值)
公開 浮點值 getAnchorU ()
水平相對錨點;0.0
和 1.0
表示左右邊緣
。其他錨點值也會據此內插。
傳回
- 水平邊緣相對錨點位置。
公開 浮點值 getAnchorV ()
垂直相對錨點;0.0
和 1.0
分別表示頂部和底部邊緣。
其他錨點值也會據此內插。
傳回
- 垂直邊緣相對錨點位置。
公開 LatLngBounds getBounds ()
取得為這個 GroundOverlayOptions
物件設定的邊界。
傳回
- 區域疊加層的邊界。如果設定排名,這將是
null
使用position(LatLng, float)
或position(LatLng, float, float)
公開 BitmapDescriptor getImage ()
取得這個 GroundOverlayOptions
物件的圖片描述元集。
傳回
- 代表區域疊加層圖片的
BitmapDescriptor
。
公開 LatLng getLocation ()
取得這個 GroundOverlayOptions
物件設定的位置。
傳回
- 放置區域疊加層錨點的位置。如果發生以下情況,這將是
null
位置是使用positionFromBounds(LatLngBounds)
進行設定。
公開 GroundOverlayOptions 圖片 (BitmapDescriptor imageDescriptor)
指定此區域疊加層的圖片。
如要將圖片載入為紋理 (用於在地圖上繪製圖片),則必須 轉化成包含雙倍數的圖像因此可擷取 mipmap 是為了呈現不同縮放等級的紋理;詳情請參閱 Mipmap (維基百科)。因此, 避免此轉換,以節省記憶體,請注意圖片尺寸 次方正值。
參數
imageDescriptor | 用於此區域疊加層的 BitmapDescriptor |
---|
傳回
- 使用這個
GroundOverlayOptions
物件,並設定新的圖片集。
公開 GroundOverlayOptions 位置 (LatLng 位置、浮點寬度)
使用錨點 (LatLng
) 和
(單位為公尺)。為維持顯示比例,高度會隨之調整。
參數
位置 | 地圖上 LatLng 指定錨點的位置
就會維持固定圖片錨點會保持固定在地面的位置,
則會套用轉換 (例如 setDimensions、setBearing 等)。 |
---|---|
寬度 | 疊加層的寬度 (單位為公尺)。系統會自動決定高度 。 |
傳回
- 這個
GroundOverlayOptions
物件已設定新的位置。
擲回
IllegalArgumentException | 如果錨點為 null |
---|---|
IllegalArgumentException | 如果寬度為負數 |
IllegalStateException | (表示位置已使用 positionFromBounds(LatLngBounds) 設定)
|
公開 GroundOverlayOptions 位置 (LatLng 位置、浮點寬度、浮點高度)
使用錨點 (LatLng
) 指定此區域疊加層的位置
和高度 (兩者皆以公尺為單位)算繪後,系統會將圖片調整為符合尺寸大小。
。
參數
位置 | 地圖上 LatLng 指定錨點的位置
就會維持固定圖片錨點會保持固定在地面的位置,
則會套用轉換 (例如 setDimensions、setBearing 等)。 |
---|---|
寬度 | 疊加層的寬度 (單位為公尺) |
高度 | 疊加層的高度 (單位為公尺) |
傳回
- 這個
GroundOverlayOptions
物件已設定新的位置。
擲回
IllegalArgumentException | 如果錨點為 null |
---|---|
IllegalArgumentException | 如果寬度或高度為負數 |
IllegalStateException | (表示位置已使用 positionFromBounds(LatLngBounds) 設定)
|
公開 GroundOverlayOptions positionFromBounds (LatLngBounds 邊界)
指定此區域疊加層的位置。
參數
界限 | 用於放置區域疊加層的 LatLngBounds |
---|
傳回
- 這個
GroundOverlayOptions
物件已設定新的位置。
擲回
IllegalStateException | (表示位置已使用 position(LatLng, float) 或 position(LatLng, float, float) 設定)
|
---|
公開 GroundOverlayOptions 資訊公開 (浮動透明度)
指定區域疊加層的透明度。預設的透明度為 0
(不透明)。
參數
資訊公開 | 介於 [0..1] 範圍中的浮點值,其中 0 代表地面
疊加層為不透明,1 表示區域疊加層為透明。 |
---|
傳回
- 這個
GroundOverlayOptions
物件會採用新的透明度設定。
擲回
IllegalArgumentException | 如果透明度超出 [0..1] 範圍 |
---|
公開 GroundOverlayOptions 顯示 (可見布林值)
公開 GroundOverlayOptions zIndex (浮點 zIndex)
指定區域疊加層的 zIndex,也就是繪製順序。詳情請參閱 說明文件,進一步瞭解 zIndex。
參數
zIndex |
---|
傳回
- 這個
GroundOverlayOptions
物件含有新的 zIndex 集。