您可以将图片作为图块图层添加在地图上。图块图层以特定缩放级别放置在地图图块之上。有了足够的图块,您就可以在多个缩放级别为整个地图补充 Google 的地图数据。
简介
借助图块图层(有时称为图块叠加层),您可以在 Google 的基本地图图块上叠加图片。这是向应用添加数据(如地图注点或路况信息)和本地图像的绝佳方式。当与 kGMSTypeNone
地图类型结合使用时,图块图层可有效地让您将 Google 的基本地图数据替换为您自己的数据。
如果您想向地图添加大量图像(通常覆盖大片地理区域),图块图层会非常有用。相比之下,如果您想将单个图像固定在地图上的某一点,可以使用地面叠加层。
图块坐标
Maps API 将各缩放级别的图像分解成一组以有序网格形式排列的方形地图图块。当地图滚动到新位置或新的缩放级别时,Maps API 会确定需要哪些图块,并将其转换为要检索的一组图块。
为了便于 Google 实现墨卡托投影法,坐标为 (0,0) 的图块始终位于地图的西北角,x
值从西向东增加,y
值从北向南增加。系统使用基于该原点的 x,y
坐标为图块建立索引。例如,缩放级别为 2 时,地球分成 16 个图块,每个图块都可通过唯一的 x,y
对进行引用:
每个地图图块都是一个256x256的正方形点阵。缩放级别为 0 时,整个世界呈现在单个图块中。缩放级别每增加 1,放大为原来的 2 倍。因此,当缩放级别为 1 时,地图渲染为 2x2 图块网格;缩放级别为 2 时,渲染为 4x4 网格;缩放级别为 3 时,地图渲染为 8x8 网格,依此类推。如果您要为图块图层创建图片,则需要在您希望支持的每个缩放级别下为每个图块创建新的 256x256 点图片。
添加图块图层
- 实例化
GMSURLTileLayer
对象或GMSTileLayer
/GMSSyncTileLayer
的自定义子类。 - (可选)修改
zIndex
属性以调整其相对于其他图块层的位置。 - 通过设置
GMSTileLayer
对象的map
属性,将其分配给地图。
Maps SDK for iOS 提供了三个可用于实现图块图层的类。对于每个类,您都需要定义如何针对一组给定的 {x,y,zoom}
坐标提取正确的地图图块。可用的选项包括:
- 子类
GMSSyncTileLayer
,用于提供可返回UIImage
实例的tileForX:y:zoom
的实现。 - 子类
GMSTileLayer
,用于实现稍后使用图块图片进行回调的异步方法requestTileForX:y:zoom
。 - 使用现有类
GMSURLTileLayer
,通过提供GMSTileURLConstructor
代码块自动从网址中提取图块。GMSURLTileLayer
是无法子类化的具体类。
在创建 GMSSyncTileLayer
或 GMSTileLayer
的子类的情况下,提供 nil
图块结果将告知 Maps SDK for iOS,相应数据当前不可用,但将来可能会提供。或者,也可以返回 kGMSTileLayerNoTile
,以表明此位置没有图块。
对于 GMSURLTileLayer
,从 GMSTileURLConstructor
返回 nil
表示此位置没有图块。
使用“GMS网址TileLayer”从网址提取图块
GMSURLTileLayer
不需要子类化,但您必须实现 GMSTileURLConstructor
代码块。以下代码展示了如何使用 GMSURLTileLayer
显示多层建筑物的楼层平面图。
Swift
let floor = 1 // Implement GMSTileURLConstructor // Returns a Tile based on the x,y,zoom coordinates, and the requested floor let urls: GMSTileURLConstructor = { (x, y, zoom) in let url = "https://www.example.com/floorplans/L\(floor)_\(zoom)_\(x)_\(y).png" return URL(string: url) } // Create the GMSTileLayer let layer = GMSURLTileLayer(urlConstructor: urls) // Display on the map at a specific zIndex layer.zIndex = 100 layer.map = mapView
Objective-C
NSInteger floor = 1; // Create the GMSTileLayer GMSURLTileLayer *layer = [GMSURLTileLayer tileLayerWithURLConstructor:^NSURL * _Nullable(NSUInteger x, NSUInteger y, NSUInteger zoom) { NSString *url = [NSString stringWithFormat:@"https://www.example.com/floorplans/L%ld_%lu_%lu_%lu.png", (long)floor, (unsigned long)zoom, (unsigned long)x, (unsigned long)y]; return [NSURL URLWithString:url]; }]; // Display on the map at a specific zIndex layer.zIndex = 100; layer.map = mapView;
为 GMSSyncTileLayer
创建子类以将图块用作 UIImage
GMSSyncTileLayer
和 GMSTileLayer
是旨在子类化的抽象类。您可以使用这些类将图块用作 UIImage
。以下示例展示了如何通过创建 GMSSyncTileLayer
的子类,在地图上的某些图块上渲染自定义图像。
Swift
class TestTileLayer: GMSSyncTileLayer { override func tileFor(x: UInt, y: UInt, zoom: UInt) -> UIImage? { // On every odd tile, render an image. if (x % 2 == 1) { return UIImage(named: "australia") } else { return kGMSTileLayerNoTile } } }
Objective-C
@interface TestTileLayer : GMSSyncTileLayer @end @implementation TestTileLayer - (UIImage *)tileForX:(NSUInteger)x y:(NSUInteger)y zoom:(NSUInteger)zoom { // On every odd tile, render an image. if (x % 2 == 1) { return [UIImage imageNamed:@"australia"]; } else { return kGMSTileLayerNoTile; } } @end
要将图层添加到地图,请实例化对象并设置其地图属性。
Swift
let layer = TestTileLayer() layer.map = mapView
Objective-C
GMSTileLayer *layer = [[TestTileLayer alloc] init]; layer.map = mapView;
用于Retina设备的高DPI图块
通过将 tileSize
设置为 512,您可以将高 DPI 图片与 GMSSyncTileLayer
或 GMSURLTileLayer
搭配使用。tileSize
属性表示返回的图块图片希望显示的像素数;默认值为 256,这是 Google 地图图块在非 Retina 设备上显示的像素数。
如果您要在高 DPI 设备上显示普通 DPI 图块,则可以通过将 tileSize
设置为 512 来放大图像。请注意,放大图片可能会降低图片质量,尤其是对于细线或文字。为获得最佳效果,请将 tileSize
和图片 DPI 与显示屏进行匹配。在 Retina 设备上显示的地图在tileSize
为 512 的高 DPI 图像时效果最佳;而在非 Retina 设备上显示的地图在采用普通图像和默认的 tileSize
为 256 时的显示效果最好。
清除过时图块
如果图层提供的图块变得“过时”,则应对该图层调用 clearTileCache
方法以强制刷新。这会导致该图层上的所有图块重新加载。
Swift
layer.clearTileCache()
Objective-C
[layer clearTileCache];