圖塊疊加層是顯示在基本地圖圖塊上方的一組圖像。這些資訊方塊 是透明的,可讓您新增地圖項目至現有地圖。圖塊疊加層具有 屬性:
- 圖塊提供者
TileProvider
提供用於圖塊疊加層的圖片。您必須 先指定圖塊提供者,再將其加入地圖。圖塊提供者不得 但立即變更;不過,您可以修改資訊方塊供應器的行為 ,針對特定座標傳回不同的圖片。如果動態磚提供的動態磚 提供者變更,之後您必須呼叫clearTileCache()
才能確保 系統不會再顯示上一個圖塊。- Z 索引
- 此圖塊疊加層與其他疊加層的繪製順序 (包括
GroundOverlay
、Circle
、Polyline
和Polygon
,但不包含Marker
)。系統會將 Z-index 值較大的疊加層繪製在較小的疊加層上 Z 索引。如果疊加層的 Z-index 值相同,則疊加順序是隨機決定的。預設的 zIndex 為 0. - 環境音模式
[0..1]
範圍中的圖塊疊加層透明度,其中0
表示 疊加層為不透明,1
表示疊加層是完全透明的。如果指定 點陣圖已部分透明,因此每個像素的透明度會經過縮放 而不同 (例如,假設點陣圖中的像素值為 200 且您 指定地圖方塊疊加層的透明度為 0.25,則像素會在 Alpha 值為 150 的畫面)。這項屬性為選填項目, 預設的透明度為 0 (不透明)。- 能見度
- 指出圖塊疊加層是可見還是隱藏,亦即是否在
。隱形的地圖方塊疊加層不會繪製,但會保留所有其他屬性。
預設值為
true
,也就是可見。
您只能在主執行緒上呼叫這個類別中的方法。否則將導致
IllegalStateException
。
圖塊座標
請注意,全世界的投影方式是使用麥卡托投影 (請參閱維基百科) 和左側 (西) 側。 對應於經度 -180 度,以及地圖右側 (東) 側。 對應至經度 180 度的方式如要將地圖設為正方形,地圖的上方 (北) 側 地圖對應到經緯度的 85.0511 度與底部 (南) 即可對應 到 -85.0511 度。不顯示這個緯度範圍以外的區域。
在每個縮放等級中,地圖會分成多個圖塊,只有與畫面重疊的圖塊 下載及轉譯。每個圖塊都是正方形,地圖會劃分成圖塊,如下所示:
- 縮放等級為 0 時,一個地圖方塊代表整個世界。該圖塊的座標為 (x、 y) = (0, 0)。
- 縮放等級為 1 時,世界會分成 4 個圖塊,排列方式為 2 x 2 的方格。
- ...
- 縮放等級為 N 時,世界會分成 4 個N 個圖塊,排列順序為 2N x 2N 格。
GoogleMap.getMinZoomLevel
和
最大縮放等級為 GoogleMap.getMaxZoomLevel
。
圖塊的座標是從地圖的左上角 (西北) 開始計算。在
縮放等級 N,圖塊座標的 x
值範圍從 0 到 2N - 1 和
從西到東增加,y
值的範圍從 0 到 2N - 1 和
由北至南增加
範例
GoogleMap map; // ... get a map.
TileProvider tileProvider; // ... create a tile provider.
TileOverlay tileOverlay = map.addTileOverlay(
new TileOverlayOptions().tileProvider(tileProvider));
公用方法摘要
void |
clearTileCache()
清除圖塊快取,讓系統再次向
TileProvider 要求所有圖塊。 |
boolean |
等於(物件其他)
測試此
TileOverlay 是否等於另一個。 |
boolean |
getFadeIn()
取得疊加層圖塊是否應淡入。
|
字串 |
getId()
取得此圖塊疊加層的 ID。
|
float |
getTransparency()
取得此圖塊疊加層的透明度。
|
float |
getZIndex()
取得此圖塊疊加層的 zIndex。
|
int |
hashCode()
|
boolean |
isVisible()
取得此圖塊疊加層的能見度。
|
void |
remove()
從地圖中移除此圖塊疊加層。
|
void |
setFadeIn(boolean fadeIn)
設定疊加層圖塊是否應淡入。
|
void |
setTransparency(浮點透明度)
設定此圖塊疊加層的透明度。
|
void |
setVisible(boolean visible)
設定此圖塊疊加層的顯示設定。
|
void |
setZIndex(浮點 zIndex)
設定這個圖塊疊加層的 zIndex。
|
繼承方法摘要
公用方法
公開 void clearTileCache ()
清除圖塊快取,讓系統再次向 TileProvider
要求所有圖塊。
呼叫此地圖方塊疊加層目前的圖塊時,也會從地圖中清除
方法。API 會保留小型的記憶體內快取。如要快取資訊方塊
建議您執行磁碟快取
公開 布林值 getFadeIn ()
取得疊加層圖塊是否應淡入。
傳回
true
表示圖塊要淡入;如果不是,則為false
。
公開 字串 getId ()
取得此圖塊疊加層的 ID。
公開 浮點值 getTransparency ()
取得此圖塊疊加層的透明度。
傳回
- 此圖塊疊加層的透明度。
公開 浮點值 getZIndex ()
取得此圖塊疊加層的 zIndex。
傳回
- 方塊疊加層的 zIndex。
公開 攔截 hashCode ()
公開 布林值 isVisible ()
取得此圖塊疊加層的能見度。請注意,這不會傳回資訊方塊 疊加層實際上位於螢幕的檢視區中,但如果疊加層 包含在螢幕可視區域中即可
傳回
- 此圖塊疊加層的瀏覽權限。
公開 void 移除 ()
從地圖中移除此圖塊疊加層。
公開 void setFadeIn (布林值淡出)
設定疊加層圖塊是否應淡入。
參數
fadeIn | true :讓圖塊淡入;false ,即可立即顯示網頁。
|
---|
公開 void setTransparency (浮動透明度)
設定此圖塊疊加層的透明度。請參閱這堂課程頂端的說明文件 瞭解詳情
參數
資訊公開 | 介於 [0..1] 範圍中的浮點值,其中 0 代表資訊方塊
疊加層為不透明,1 表示圖塊疊加層是透明的。
|
---|
公開 void setVisible (可見布林值)
設定此圖塊疊加層的顯示設定。不可見時,地圖方塊疊加層並未繪製,而是 會保留所有其他屬性圖塊疊加層預設為顯示。
參數
顯示 | true 以顯示此疊加層;false 即可隱藏內容。
|
---|
公開 void setZIndex (浮點值 zIndex)
設定這個圖塊疊加層的 zIndex。詳情請參閱這堂課程頂端的說明文件 可能不準確或不適當
參數
zIndex | 此地圖方塊疊加層的 zIndex。 |
---|