相机和视图

借助 Maps SDK for iOS，您可以更改用户的地图视角 更改地图的镜头

借助 Maps SDK for iOS，用户可以倾斜和旋转地图 调整地图，使其适应对上下文有用的方向。缩放 用户可以平移地图或更改其视角，几乎不会产生延迟。

更改镜头不会更改标记、多段线或其他图形 不过，您可能需要更改这些添加的内容 新视图

地图的视图

Maps SDK for iOS 使用墨卡托投影法 预测 来在设备屏幕（平面 ）。

相机位置

地图视图被建模成一个俯视某个平面的镜头。下列属性指定了镜头的位置（也进而决定了地图的渲染效果）：目标（纬度/经度位置）、方向角、倾斜度和缩放级别。

目标（位置）

镜头目标是地图中心的位置，以纬度和经度坐标形式指定。

方向角（方向）

镜头方向角指定了罗盘方向，以相对于正北方（对应于地图的顶部边缘）的角度来表示。从地图中心到顶部边缘画一条垂直线，镜头朝向相对于正北方的角度（以度为单位）即为方向角。

方向角为 0 表示地图顶部指向正北。方向角为 90 表示地图顶部指向正东方（罗盘上为 90 度）。方向角为 180 表示地图顶部指向正南方。

您可以使用 Maps API 更改地图的方向角。例如，驾车的用户通常会旋转道路地图使其与他们的行驶方向一致，而远足者使用地图和罗盘时通常会调整地图方向，使地图上有一条垂直线指向北方。

倾斜度（视角）

倾斜度是指镜头在地图中心位置正上方圆弧上所处的位置，以相对于天底（相机正下方）的角度来表示。值为 0 时，镜头竖直朝下。值大于 0 时，镜头按指定角度朝地平线倾斜。更改视角时，地图会以透视法呈现：远处的地图项显示得较小，而近处的地图项显示得较大。以下插图展示了这种情况。

在下面的图片中，视角为 0 度。第一张图片是视角为 0 度时的示意图；位置 1 是镜头位置，位置 2 是当前的地图位置。生成的地图如下所示。

以下图片中的视角为 45 度。请注意，镜头沿圆弧移到了正上（0 度）与地面（90 度）中间的位置，也就是位置 3。镜头仍指向地图的中心点，但现在位置 4 处的线表示的区域会显示出来。

此屏幕截图中的地图仍与原始地图采用同一个中心点，但地图顶部显示的地图项增加了。当您将角度增加到 45 度以上时，镜头和地图位置之间的地图项会按比例显示得较大，而地图位置远处的地图项会按比例显示得较小，从而产生三维效果。

缩放级别

镜头的缩放级别决定了地图的比例。放大时 在较小的缩放级别下，屏幕上显示的细节较多 可以在屏幕上看到更多的世界 缩放级别为 0 时，地图的比例为： 宽度约为 256 个点。

缩放级别每增加 1 个级别，屏幕上地球的宽度就会翻一番。因此，当缩放级别为 N 时，地球的宽度大约为 256 * 2^N 点。例如，缩放级别为 2 时，整个地球大约为 宽 1024 磅。

缩放级别的值不必是整数。地图允许的缩放级别范围取决于多个因素，包括目标、地图类型和屏幕尺寸。超出该范围的任何数值都将转换为最接近的有效值（可以是最小缩放级别或最大缩放级别）。以下列表显示了您在每个缩放级别看到的地图的大致详细程度：

• 1：世界
• 5：大陆/洲
• 10：城市
• 15：街道
• 20：建筑物

设置初始相机位置

使用 GMSCameraPosition 对象，可让您设置目标的纬度和经度，以及 方位、倾斜度和缩放。

要设置相机的初始位置，请创建一个 GMSMapViewOptions 对象并将 将 camera 属性设置为 GMSCameraPosition。然后将您的选项传递给 GMSMapView 便捷构造函数。

let options = GMSMapViewOptions()
options.camera = GMSCameraPosition.camera(withLatitude: -33.8683, longitude: 151.2086, zoom: 16)
let mapView = GMSMapView(options:options)

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                        longitude:151.2086
                                                             zoom:16];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

您还可以使用默认的 UIView init 创建 GMSMapView 对象 方法。在这种情况下，镜头的起始位置就是默认位置， 请在创建后更改

let options = GMSMapViewOptions()
options.frame = self.view.bounds
let mapView = GMSMapView(options:options)

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.frame = self.view.bounds;
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

更改相机位置

您可以通过编程方式更改镜头位置来设置位置， 方位、倾斜度和缩放。GMSMapView 提供了多种方法， 可用于更改镜头位置，您通常使用 GMSCameraPosition 或 GMSCameraUpdate:

• GMSCameraPosition 包含用于更改每个镜头位置的属性和方法 参数：目标、方位、倾斜度和缩放。

• GMSCameraUpdate 可让您更改目标、方位、倾斜度和缩放， 支持滚动、高级缩放、居中放置 例如预定义边界内，等等。

移动摄像头时，你可以选择“截取”将相机切换到新的 （即没有动画效果）或以动画方式移动。例如，如果 为镜头目标位置的变化添加动画效果时，动画会从 从之前的地址复制到新地址

动画会插入当前镜头属性和新的镜头属性之间。您可以使用核心 Animation。

使用 GMSCameraPosition

如需更换摄像头，请执行以下操作： GMSCameraPosition, 您可以创建一个新对象或复制一个现有对象，然后在 GMSMapView 对象。使用 GMSCameraPosition 对象将相机对准 包含或不包含动画的新位置。

您可以使用 GMSCameraPosition 对象配置任意相机属性，例如 纬度、经度、缩放级别、方位和视角。然后，您可以将该对象 以设置 GMSMapView 的 camera 属性。

let fancy = GMSCameraPosition(
  latitude: -33,
  longitude: 151,
  zoom: 6,
  bearing: 270,
  viewingAngle: 45
)
mapView.camera = fancy
      

GMSCameraPosition *fancy = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                       longitude:151.2086
                                                            zoom:6
                                                         bearing:30
                                                    viewingAngle:45];
[mapView setCamera:fancy];
      

省略要设置为默认值的任何 GMSCameraPosition 属性。

如需为移动添加动画效果，请使用 animateToCameraPosition: 方法，而不是 设置 camera 属性。

使用 GMSCameraUpdate

GMSCameraUpdate 可用来更新镜头位置，并选择是直接定位到还是以动画方式 这个新位置。GMSCameraUpdate 的优点是便利。您可以 使用 GMSCameraPosition 执行与 GMSCameraUpdate 相同的任务，但 GMSCameraUpdate 提供了额外的辅助方法， 操控相机。

例如，若要使用 GMSCameraPosition 增加当前缩放级别，则需要 必须先确定当前的缩放级别，然后创建一个 GMSCameraPosition 对象，您在其中将缩放级别设置为大于 1 的值 当前缩放级别。

或者，使用 zoomIn: 方法构造 GMSCameraUpdate 对象。 然后，将 GMSCameraUpdate 对象传递给 GMSMapView animateWithCameraUpdate: 方法。

// Zoom in one zoom level
let zoomCamera = GMSCameraUpdate.zoomIn()
mapView.animate(with: zoomCamera)
      

// Zoom in one zoom level
GMSCameraUpdate *zoomCamera = [GMSCameraUpdate zoomIn];
[mapView animateWithCameraUpdate:zoomCamera];
      

使用 GMSMapView moveCamera: 方法将镜头对准新位置 。

在下一个示例中，您将使用 GMSCameraUpdate 为镜头的移动添加动画效果 让它以温哥华为中心

// Center the camera on Vancouver, Canada
let vancouver = CLLocationCoordinate2D(latitude: 49.26, longitude: -123.11)
let vancouverCam = GMSCameraUpdate.setTarget(vancouver)
mapView.animate(with: vancouverCam)
      

// Center the camera on Vancouver, Canada
CLLocationCoordinate2D vancouver = CLLocationCoordinate2DMake(49.26, -123.11);
GMSCameraUpdate *vancouverCam = [GMSCameraUpdate setTarget:vancouver];
[mapView animateWithCameraUpdate:vancouverCam];
      

构造 GMSCameraUpdate 对象

使用 GMSCameraUpdate 对象之一构造该对象。

zoomIn:和zoomOut:

按 1.0 的幅度更改当前缩放级别，同时确保 所有其他属性保持不变。

zoomTo:

将缩放级别的值更改为指定值，同时保留所有其他值 属性相同。

zoomBy:

提高（如果值为负数，则降低）缩放级别 相乘，

zoomBy:atPoint:

提高（如果值为负数，则降低） 按指定值缩放，同时保留指定点的 在屏幕上所处的位置

setTarget:

更改镜头的纬度和经度，同时保持原样 所有其他媒体资源。

setTarget:zoom:

更改镜头的纬度、经度和缩放级别，同时 所有其他属性保持不变

setCamera:

设置新的 GMSCameraPosition。

scrollByX:Y:

更改镜头的纬度和经度以移动地图 指定的点数。x 正值会导致 系统就会将镜头向右移动，显示出来的效果就是地图 左侧。y 正值会将镜头向下移动， 似乎向上移动了滚动方向是相对于镜头当前方向的 方位。例如，如果镜头的方位角为 90 度，那么 east 为“上行”。

fitBounds:

转换镜头，使指定边界位于屏幕的中心 最大缩放级别。应用默认值 内边距为 64 个点的边界。

fitBounds:withPadding:

转换镜头，使指定边界位于 将屏幕放大到尽可能大的缩放级别。使用此方法指定 边框各边的内边距（以点为单位）。

fitBounds:withEdgeInsets:

转换镜头，使指定边界位于 将屏幕放大到尽可能大的缩放级别。订阅 UIEdgeInsets后， 您可以单独为边界框的每条边指定内边距。

。

使用 GMSMapView 更改单个属性

GMSMapView 提供了几种可让您移动镜头的方法， GMSCameraPosition 对象或 GMSCameraUpdate 对象。通过这些方法， 作为 animateToLocation: 或 animateToZoom:，您可以向 单个相机属性。

例如，使用 toViewingAngle: 方法为镜头变化添加动画效果 倾斜度。

mapView.animate(toViewingAngle: 45)
      

[mapView animateToViewingAngle:45];
      

设置目标（位置）

位置决定了地图的中心。位置由 分别以程序化方式表示 CLLocationCoordinate2D，使用 CLLocationCoordinate2DMake 创建。

使用 GMSCameraPosition 更改位置。在此示例中，地图会与 复制到新位置

let target = CLLocationCoordinate2D(latitude: -33.868, longitude: 151.208)
mapView.camera = GMSCameraPosition(target: target, zoom: 6)
      

CLLocationCoordinate2D target =
    CLLocationCoordinate2DMake(-33.868, 151.208);
mapView.camera = [GMSCameraPosition cameraWithTarget:target zoom:6];
      

要为变化添加动画效果并将地图平移到新位置，您可以使用 animateToCameraPosition: 方法，而不是设置 camera 属性。或者， 对 GMSMapView 使用 animateToLocation: 方法。

mapView.animate(toLocation: CLLocationCoordinate2D(latitude: -33.868, longitude: 151.208))
      

[mapView animateToLocation:CLLocationCoordinate2DMake(-33.868, 151.208)];
      

您还可以创建一个 GMSCameraUpdate 对象来移动镜头。使用 内置方法 scrollByX:Y:，用于指定要滚动的点数 X 和 Y 方向上的镜头。在此示例中，您滚动镜头 200 指向右侧，向下 100 点：

// Move the camera 200 points to the right, and 100 points downwards
let downwards = GMSCameraUpdate.scrollBy(x: 200, y: 100)
mapView.animate(with: downwards)
      

// Move the camera 200 points to the right, and 100 points downwards
GMSCameraUpdate *downwards = [GMSCameraUpdate scrollByX:200.0 Y:100.0];
[mapView animateWithCameraUpdate:downwards];
      

设置方位（方向）

方位是罗盘方向，以与正北方之间的角度为单位， 地图的顶部边缘。例如，方位为 90 度会得到地图， 其中顶边指向正东

使用 GMSCameraPosition 或 GMSCameraUpdate 以编程方式设置方位 或者使用 GMSMapView 的 animateToBearing: 方法。

mapView.animate(toBearing: 0)
      

[mapView animateToBearing:0];
      

设置倾斜度（视角）

视角是镜头位于 测量地图的中心位置和地球表面，以相对于地球表面的 nadir（方向 镜头正下方）。更改视角时，地图 镜头和地图位置之间以透视法呈现地图项 按比例放大显示，而地图位置之外的地图项显示 从而实现三维效果

视角的范围为 0（垂直向下指向地图）和 最高可达到与缩放级别相关的最大值。对于缩放级别 16 或更高级别， 角度为 65 度对于缩放级别 10 或更低级别，最大角度为 30 度。

使用 GMSCameraPosition 以程序化方式设置视角，或 GMSCameraUpdate，或者使用 GMSMapView 的 animateToViewingAngle: 方法。

mapView.animate(toViewingAngle: 45)
      

[mapView animateToViewingAngle:45];
      

设置缩放级别

镜头的缩放级别决定了地图的比例。放大时 就可以在屏幕上看到更多细节，而在较小的缩放级别， 看到更广阔的天地

使用 GMSCameraPosition 或 GMSCameraUpdate 以编程方式设置缩放；或者 animateToZoom: 方法为 GMSMapView。

mapView.animate(toZoom: 12)
      

[mapView animateToZoom:12];
      

以下示例使用 zoomIn: 方法来构造 GMSCameraUpdate。 对象以动画方式显示从当前级别放大一个级别的动画。

// Zoom in one zoom level
let zoomCamera = GMSCameraUpdate.zoomIn()
mapView.animate(with: zoomCamera)
      

// Zoom in one zoom level
GMSCameraUpdate *zoomCamera = [GMSCameraUpdate zoomIn];
[mapView animateWithCameraUpdate:zoomCamera];
      

设置边界

移动镜头，使感兴趣的整个区域都显示在最显眼的位置， 设置相机视图的边界。例如，如果您 希望显示距离用户当前所在位置五英里内的所有加油站 移动镜头，使它们全部显示在屏幕上：

1. 计算 GMSCoordinateBounds， 显示在屏幕上。
2. 使用 GMSMapView 的 cameraForBounds:insets: 方法返回一个新的 GMSCameraPosition。

设置这些边界可确保给定的 GMSCoordinateBounds 完全适合 在当前地图大小范围内。请注意，此方法设置倾斜度和方位 0。

以下示例演示了如何更改镜头，使城市显示 温哥华和卡尔加里的城市在同一个视图中显示。

let vancouver = CLLocationCoordinate2D(latitude: 49.26, longitude: -123.11)
let calgary = CLLocationCoordinate2D(latitude: 51.05,longitude: -114.05)
let bounds = GMSCoordinateBounds(coordinate: vancouver, coordinate: calgary)
let camera = mapView.camera(for: bounds, insets: UIEdgeInsets())!
mapView.camera = camera
      

CLLocationCoordinate2D vancouver = CLLocationCoordinate2DMake(49.26, -123.11);
CLLocationCoordinate2D calgary = CLLocationCoordinate2DMake(51.05, -114.05);
GMSCoordinateBounds *bounds =
    [[GMSCoordinateBounds alloc] initWithCoordinate:vancouver coordinate:calgary];
GMSCameraPosition *camera = [mapView cameraForBounds:bounds insets:UIEdgeInsetsZero];
mapView.camera = camera;
      

将用户的平移限制在给定区域

以下场景设置了地图的边界，但用户可以滚动或平移 将超出这些边界相反，您可能想将坐标限制为 地图焦点（镜头目标）的中心边界，以便用户 只能在这些边界内滚动和平移。

例如，购物中心或机场的零售应用可能需要限制 将地图移动到特定边界，使用户可以在这些边界内滚动和平移。

要将平移限制在特定边界内，请将 cameraTargetBounds 属性设置为 将 GMSMapView 设置为用于定义所需边界的 GMSCoordinateBounds 对象。 如需稍后移除该限制，请将 cameraTargetBounds 设置为 nil。

mapView.cameraTargetBounds = bounds
      

mapView.cameraTargetBounds = bounds;
      

在下图所示的情况下，镜头目标被限制在一个略微大于视口的区域内。只要镜头目标仍然位于边界区域内，用户就可以滚动和平移。叉型记号表示镜头目标：

地图将始终填满视口，即使这会导致视口显示指定边界以外的区域也是如此。例如，如果您将镜头目标定位在边界区域的角上，超出角的区域在视口中仍然可见，但是用户无法滚动到该区域。下图说明了这种情况。叉型记号表示镜头目标：

在下图中，镜头目标具有非常有限的边界， 用户几乎没有滚动或平移地图的机会。叉型记号表示 镜头目标：

设置最小或最大缩放级别

全局常量 kGMSMinZoomLevel 和 kGMSMaxZoomLevel 定义 最小或最大缩放值。默认情况下，minZoom 和 maxZoom GMSMapView 的属性设置为这些常量。

要限制地图可用的缩放级别范围，请设置最小值和最大值 缩放级别。以下代码将缩放级别的范围限制为 10 到 15 之间。

let camera = GMSCameraPosition(
  latitude: 41.887,
  longitude: -87.622,
  zoom: 12
)
let mapView = GMSMapView(frame: .zero, camera: camera)
mapView.setMinZoom(10, maxZoom: 15)
      

GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:41.887
                                                       longitude:-87.622
                                                             zoom:12];
GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero
                                        camera:camera];
[mapView setMinZoom:10 maxZoom:15];
      

您必须使用 setMinZoom:maxZoom: 方法设置缩放范围；然而， 可以使用 minZoom 和 maxZoom 属性读取当前值。这个 只限制其中一个值时，此方法非常有用。以下代码 用于只更改最小缩放级别。

mapView.setMinZoom(12, maxZoom: mapView.maxZoom)
      

[mapView setMinZoom:12 maxZoom:mapView.maxZoom];
      

如果在更新最小和最大缩放级别后，将镜头的缩放级别设置为 值超出新范围，则当前缩放会自动更新为 显示最接近的有效值。例如，在以下代码中， 原始缩放级别定义为 4。如果稍后将缩放范围设置为 10-15， 当前缩放级别已更新为 10。

// Sets the zoom level to 4.
let camera2 = GMSCameraPosition(
  latitude: 41.887,
  longitude: -87.622,
  zoom: 4
)
let mapView2 = GMSMapView(frame: .zero, camera: camera)

// The current zoom, 4, is outside of the range. The zoom will change to 10.
mapView.setMinZoom(10, maxZoom: 15)
      

// Sets the zoom level to 4.
GMSCameraPosition *camera2 = [GMSCameraPosition cameraWithLatitude:41.887
                                                         longitude:-87.622
                                                              zoom:4];
GMSMapView *mapView2 = [GMSMapView mapWithFrame:CGRectZero
                                         camera:camera];
// The current zoom, 4, is outside of the range. The zoom will change to 10.
[mapView setMinZoom:10 maxZoom:15];