TileOverlay

公開最終課 TileOverlay 擴充物件

圖塊疊加層是顯示在基本地圖圖塊上方的一組圖像。這些資訊方塊 是透明的,可讓您新增地圖項目至現有地圖。圖塊疊加層具有 屬性:

圖塊提供者
TileProvider 提供用於圖塊疊加層的圖片。您必須 先指定圖塊提供者,再將其加入地圖。圖塊提供者不得 但立即變更;不過,您可以修改資訊方塊供應器的行為 ,針對特定座標傳回不同的圖片。如果動態磚提供的動態磚 提供者變更,之後您必須呼叫 clearTileCache() 才能確保 系統不會再顯示上一個圖塊。
Z 索引
此圖塊疊加層與其他疊加層的繪製順序 (包括 GroundOverlayCirclePolylinePolygon,但不包含 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
boolean
isVisible()
取得此圖塊疊加層的能見度。
void
remove()
從地圖中移除此圖塊疊加層。
void
setFadeIn(boolean fadeIn)
設定疊加層圖塊是否應淡入。
void
setTransparency(浮點透明度)
設定此圖塊疊加層的透明度。
void
setVisible(boolean visible)
設定此圖塊疊加層的顯示設定。
void
setZIndex(浮點 zIndex)
設定這個圖塊疊加層的 zIndex。

繼承方法摘要

公用方法

公開 void clearTileCache ()

清除圖塊快取,讓系統再次向 TileProvider 要求所有圖塊。 呼叫此地圖方塊疊加層目前的圖塊時,也會從地圖中清除 方法。API 會保留小型的記憶體內快取。如要快取資訊方塊 建議您執行磁碟快取

公開 布林值 等於 (其他物件)

測試此 TileOverlay 是否等於另一個。

參數
其他 Object
傳回
  • 如果兩個物件是同一個物件,也就是 == other。

公開 布林值 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。