图块图层

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。
选择平台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,将高 DPI 图片与 GMSSyncTileLayerGMSURLTileLayer 搭配使用。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];