概览
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 图块层和叠加层之上。 | |
| NSInteger | tileSize |
| 指定返回的图块图像希望显示的像素数（而非点数）。 | |
| 浮点数 | 不透明度 |
| 指定图块层的不透明度。 | |
| BOOL | fadeIn |
| 指定图块是否应淡入。 | |
相关函数 | |
（请注意，这些并非成员函数。） | |
| typedef NS网址 *_Nullable(^) | GMSTileURLConstructor （NSUInteger x、NSUInteger y、NSUInteger 缩放） |
GMSTileURLConstructor 是一个块，它会接受 x、y 和 zoom 并返回 NS网址 或 nil，用以指示该位置没有图块。 | |
成员函数文档
| + (instancetype) tileLayerWithURLConstructor: | (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 NS网址* _Nullable(^ GMSTileURLConstructor)(NSUInteger x, NSUInteger y, NSUInteger 缩放)) [related] |
GMSTileURLConstructor 是一个块，它会接受 x、y 和 zoom 并返回 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] |
指定图块是否应淡入。
默认值为“是”。