總覽
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 顯示的地圖。 | |
int | zIndex |
較高的 zIndex 值圖塊圖層會繪製在較低的 zIndex 值圖塊圖層和疊加層之上。 | |
NSInteger | tileSize |
指定傳回的圖塊圖片偏好的顯示方式像素數 (非點)。 | |
float | 不透明度 |
指定圖塊圖層的不透明度。 | |
BOOL | fadeIn |
指定圖塊是否應淡入, | |
相關函式 | |
(請注意,這些不是成員函式)。 | |
typedef NSURL *_Nullable(^ | GMSTileURLConstructor )(NSUInteger x、NSUInteger y、NSUInteger 變焦) |
GMSTileURLConstructor 是擷取 x 、y 和 zoom 的區塊,並傳回 NSURL,或表示沒有該位置的圖塊。 |
成員函式說明文件
+ (instancetype) tileLayerWithURLBuildingor: | (GMSTileURLConstructor) | 建構函式 |
便利建構函式。
constructor
必須為非 nil。
- (void) requestTileForX: | (NSUInteger) | x | |
Y: | (NSUInteger) | 年 | |
縮放: | (NSUInteger) | 放大 | |
接收器: | (id<GMSTileReceiver >) | 接收端 | |
requestTileForX:y:zoom:receiver:為 GMSTileOverlay 產生影像圖塊。
必須由子類別覆寫。指定 x
、y
和 zoom
的圖塊稍後_必須_傳遞至 receiver
。
如果沒有此位置適用的動態磚,請指定 kGMSTileLayerNoTile;如果發生暫時性錯誤,並且可以稍後取得地圖方塊,則指定 nil。
對這個方法的呼叫將在主執行緒上進行。請參閱GMSSyncTileLayer的基礎類別,做為實作一個不在應用程式主執行緒上執行的阻塞地圖方塊圖層。
- (void) clearTileCache |
清除快取,讓系統再次要求所有圖塊。
好友與相關職務說明文件
- (typedef NSURL* _Nullable(^ GMSTileURLConstructor)(NSUInteger x、NSUInteger y、NSUInteger 縮放)) [related] |
GMSTileURLConstructor
是擷取 x
、y
和 zoom
的區塊,並傳回 NSURL,或表示沒有該位置的圖塊。
資源說明文件
- (NSString*) userAgent [read, write, copy] |
指定使用者代理程式來描述您的應用程式。
如果這個值為 nil (預設值),HTTP 要求會使用預設的 iOS 使用者代理程式。
- (GMSMapView*) 地圖 [read, write, assign, inherited] |
這個 GMSTileOverlay 顯示的地圖。
設定此屬性會將圖層加入地圖。設為 nil 會移除地圖中的這個圖層。無論何時,圖層在最多一個地圖中仍為有效。
- (整數) 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] |
指定圖塊是否應淡入,
預設值為「是」。