图块图层

请选择平台: Android iOS JavaScript

您可以将图片作为图块图层添加在地图上。图块图层以特定的缩放级别放置在地图图块之上。有了足够的图块,您就可以在多个缩放级别为整个地图补充 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 点的新图片。

添加图块图层

  1. 实例化 GMSURLTileLayer 对象或 GMSTileLayer/GMSSyncTileLayer 的自定义子类。
  2. (可选)修改 zIndex 属性,以调整它相对于其他图块图层的位置。
  3. 通过设置 GMSTileLayer 对象 map 属性,将其分配给地图。

Maps SDK for iOS 提供了三个可用于实现图块图层的类。对于每个类,您都需要定义如何为一组给定的 {x,y,zoom} 坐标提取正确的地图图块。可用的选项包括:

  • 子类 GMSSyncTileLayer,提供返回 UIImage 实例的 tileForX:y:zoom 的实现。
  • 子类 GMSTileLayer,提供异步方法 requestTileForX:y:zoom 的实现,该方法稍后会使用图块图片进行回调。
  • 使用现有类 GMSURLTileLayer 通过提供 GMSTileURLConstructor 代码块自动从网址中提取图块。GMSURLTileLayer 是一个无法子类化的具体类。

如果是为 GMSSyncTileLayerGMSTileLayer 创建子类,则提供 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

GMSSyncTileLayerGMSTileLayer 是需要子类化的抽象类。您可以使用这些类将图块用作 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,通过 GMSSyncTileLayerGMSURLTileLayer 使用高 DPI 图片。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];