GMSURLTileLayer 類別參考資料

GMSURLTileLayer 類別參考資料

總覽

GMSURLTileProvider 會根據 GMSTileURL 建構函式傳回的網址來擷取圖塊。

例如:

   GMSTileURLConstructor constructor = ^(NSUInteger x, NSUInteger y, NSUInteger zoom) {
     NSString *URLStr =
         [NSString stringWithFormat:"https://example.com/%d/%d/%d.png", x, y, zoom];
     return [NSURL URLWithString:URLStr];
   };
   GMSTileLayer *layer =
       [GMSURLTileLayer tileLayerWithURLConstructor:constructor];
   layer.userAgent = "SDK user agent";
   layer.map = map;
 

GMSURLTileProvider 可能無法建立子類別,只能透過其便利建構函式建立。

繼承GMSTileLayer

公開成員函式

(void) - requestTileForX:y:zoom:receiver:
 requestTileForX:y:zoom:receiver: 會為 GMSTileOverlay 產生影像圖塊。
(void) - clearTileCache
 清除快取,讓系統再次要求所有圖塊。

靜態公開成員函式

(執行個體類型)+ tileLayerWithURL 建構函式:
 便利建構函式。

資源

NSString * userAgent
 指定要描述應用程式的使用者代理程式。
GMSMapView地圖
 顯示這個 GMSTileOverlay 的地圖顯示。
int zIndex
 系統會將較高的 zIndex 值圖塊圖層繪製在較低的 zIndex 值圖塊圖層和疊加層上。
NSIntegertileSize
 指定傳回的圖塊圖片偏好顯示的像素數量 (而非點)。
float 不透明度
 指定圖塊圖層的不透明度。
BOOLfadeIn
 用於指定圖塊是否應淡入,

(請注意,這些並非成員函式)。

typedef NSURL *_Nullable(^ GMSTileURLConstructor )(NSUInteger x, NSUInteger y, NSUInteger 縮放)
 GMSTileURLConstructor 是接受 xyzoom 並傳回 NSURL 的區塊,或 nil (表示該位置沒有圖塊)。

成員函式說明文件

+ (instancetype) tileLayerWithURLPropertiesor: (GMSTileURLConstructor) 建構函式

便利建構函式。

constructor」不得為非 nil。

- (void) requestTileForX: (NSUInteger) x
Y: (NSUInteger) y 鍵
縮放: (NSUInteger) 縮放
接收者: (ID<GMSTileReceiver >) 接收端

requestTileForX:y:zoom:receiver: 會為 GMSTileOverlay 產生影像圖塊。

必須被子類別覆寫。指定 xyzoom 的圖塊必須稍後傳遞至 receiver

如果此位置沒有適用的動態磚,請指定 kGMSTileLayerNoTile;或如果發生暫時性錯誤,可以稍後提供動態磚。

對這個方法的呼叫將在主執行緒上進行。請參閱GMSSyncTileLayer:基本類別,實作未在應用程式主執行緒上執行的封鎖圖塊圖層。

- (void) clearTileCache

清除快取,讓系統再次要求所有圖塊。


- (typedef NSURL* _Nullable(^ GMSTileURLConstructor)(NSUInteger x, NSUInteger y, NSUInteger 縮放) [related]

GMSTileURLConstructor 是接受 xyzoom 並傳回 NSURL 的區塊,或 nil (表示該位置沒有圖塊)。


屬性說明文件

- (NSString*) userAgent [read, write, copy]

指定要描述應用程式的使用者代理程式。

如果為 nil (預設值),則 HTTP 要求會使用預設的 iOS 使用者代理程式。

- (GMSMapView*) map [read, write, assign, inherited]

顯示這個 GMSTileOverlay 的地圖顯示。

設定這個屬性會將圖層加入地圖。設為 nil 即可從地圖中移除這個圖層。圖層在任何特定時間內最多僅能在一張地圖上啟用。

- (int) zIndex [read, write, assign, inherited]

系統會將較高的 zIndex 值圖塊圖層繪製在較低的 zIndex 值圖塊圖層和疊加層上。

相同值會導致未定義繪製順序。

- (NSInteger) tileSize [read, write, assign, inherited]

指定傳回的圖塊圖片偏好顯示的像素數量 (而非點)。

為獲得最佳效果,這個值應為自訂圖塊的邊緣長度。預設值為 256,也就是傳統的 Google 地圖圖塊。

如果值小於 128 點 (例如在 Retina 裝置上為 256 像素),成效可能不佳,因此不建議使用。

舉例來說,應用程式開發人員可能會想在 Retina 裝置上提供 Retina 圖塊 (512 像素邊緣長度),以便讓每個檢視畫面的圖塊數量與預設值 256 相同。

- (浮點) 不透明度 [read, write, assign, inherited]

指定圖塊圖層的不透明度。

這可為資訊方塊圖片的 Alpha 管道提供調節係數。

- (BOOL) fadeIn [read, write, assign, inherited]

用於指定圖塊是否應淡入,

預設值為「是」。