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
 清除快取,讓系統再次要求所有地圖方塊。

靜態公開成員函式

(instancetype)+ tileLayerWithURLConstructor:
 便利的建構函式。

房源

NSString *userAgent
 指定使用者代理程式來描述您的應用程式。
GMSMapView *地圖
 顯示此 GMSTileOverlay 的地圖。
攔截zIndex
 較高的 zIndex 值圖塊圖層會繪製在較低的 zIndex 值圖塊圖層和疊加層之上。
NSIntegertileSize
 指定傳回的圖塊圖片偏好的顯示像素數量 (不是點)。
浮點值不透明度
 指定圖塊圖層的不透明度。
BOOLfadeIn
 用於指定圖塊是否應淡入,

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

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

成員職能說明文件

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

便利的建構函式。

constructor 不得為 nil。

- (void) requestTileForX: (NSUInteger) x
Y: (NSUInteger)
縮放: (NSUInteger) 縮放
接收方: (id< GMSTileReceiver >) 接收器

requestTileForX:y:zoom:receiver: 產生 GMSTileOverlay 的圖片圖塊。

必須由子類別覆寫。指定的 xyzoom 的圖塊之後必須再傳遞至 receiver

如果沒有適用於此位置的動態磚,請指定 kGMSTileLayerNoTile;或 nil。

此方法將在主執行緒上進行呼叫。請參閱GMSSyncTileLayer,瞭解實作的封鎖方塊圖層而不是在應用程式主執行緒上執行的基礎類別。

- (避免) clearTileCache

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


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

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


屬性說明文件

- (NSString*) <使用者代理程式>userAgent [read, write, copy]

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

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

- (GMSMapView*) 地圖 [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 裝置上提供視網膜圖塊 (長度為 512 像素的邊緣邊緣),讓每次檢視畫面的圖塊數量與非 Retina 裝置的預設大小相同。

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

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

這可以為圖塊圖片的 Alpha 通道提供調節係數。

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

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

預設值為「是」。