图块图层

选择平台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图块

您可以将高 DPI 图片与 GMSSyncTileLayerGMSURLTileLayer 结合使用,只需将 tileSize 设置为 512 即可。tileSize 属性用于指明返回的图块图像倾向于以多少像素显示;此值默认为 256,即非 Retina 设备上 Google 地图图块的尺寸。

如果您在高 DPI 设备上显示普通 DPI 图块,可以通过将 tileSize 设置为 512 来放大图片。请注意,放大图片可能会降低图片质量,尤其是对于细线或文字。为获得最佳效果,请将 tileSize 和图片 DPI 与显示屏对应起来。在 Retina 设备上显示的地图在 tileSize 为 512 时显示高 DPI 图片时效果最好;在非 Retina 设备上显示地图时,如果使用普通图片和默认的 tileSize 256,效果最好。

正在清除过时图块

如果层提供的图块变得“过时”,则应对该层调用 clearTileCache 方法来强制刷新。这会使该图层上的所有图块重新加载。

Swift

layer.clearTileCache()
      

Objective-C

[layer clearTileCache];