GMS网址TileLayer 类参考

GMS网址TileLayer 类参考

概览

GMS网址TileProvider 会根据从 GMSTile网址Constructor 返回的网址提取图块。

例如:

   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;
 

GMS网址TileProvider 不可子类化,而仅应通过其便捷构造函数创建。

此类继承GMSTileLayer

公开成员函数

(void) - requestTileForX:y:zoom:receiver:
 requestTileForX:y:zoom:receiver:为 GMSTileOverlay 生成图像图块。
(void) -clearTileCacheclearTileCache
 清除缓存,以便再次请求所有图块。

静态公开成员函数

(instancetype)+ tileLayerWithURLConstructor:
 便捷的构造函数。

属性

NSString * userAgent
 指定用户代理来描述您的应用。
GMSMapView *map
 显示此 GMSTileOverlay 的地图。
整数zIndex
 值较高的 zIndex 图块层将绘制在值较低的 zIndex 图块层和叠加层之上。
NSIntegertileSize
 指定返回的图块图像希望显示的像素数(而非点数)。
浮点数不透明度
 指定图块层的不透明度。
BOOL fadeIn
 指定图块是否应淡入。

(请注意,这些并非成员函数。)

typedef NS网址 *_Nullable(^)GMSTileURLConstructor (NSUInteger x、NSUInteger y、NSUInteger 缩放)
 GMSTileURLConstructor 是一个块,它会接受 xyzoom 并返回 NS网址 或 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,了解可以实现不会在应用的主线程上运行的阻塞图块层的基类。

- (void) clearTileCache

清除缓存,以便再次请求所有图块。


- (typedef NS网址* _Nullable(^ GMSTileURLConstructor)(NSUInteger x, NSUInteger y, NSUInteger 缩放)) [related]

GMSTileURLConstructor 是一个块,它会接受 xyzoom 并返回 NS网址 或 nil,用以指示该位置没有图块。


属性说明

- (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 点的值(例如,视网膜显示设备上为 256 像素)可能效果不佳,因此不推荐使用。

例如,应用开发者可能希望在视网膜显示设备上提供视网膜图块(边缘长度为 512 像素),以使每个视图保持的图块数量与非视网膜显示设备上的默认值 256 相同。

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

指定图块层的不透明度。

这会提升图块图片的 Alpha 通道的倍数。

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

指定图块是否应淡入。

默认值为“是”。