借助 Maps SDK for iOS,您可以更改用户的地图视角 更改地图的镜头
借助 Maps SDK for iOS,用户可以倾斜和旋转 调整地图,使其适应对上下文有用的方向。缩放 用户可以平移地图或更改其视角,几乎不会产生延迟。
更改镜头不会更改标记、多段线或其他图形 不过,您可能需要更改这些添加的内容 新视图
地图的视图
Maps SDK for iOS 使用墨卡托投影法 预测 来在设备屏幕(平面 )。
相机位置
地图视图被建模成一个俯视某个平面的镜头。下列属性指定了镜头的位置(也进而决定了地图的渲染效果):目标(纬度/经度位置)、方向角、倾斜度和缩放级别。
![镜头属性图](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/documentation/android-sdk/images/camera.png?authuser=19&hl=zh-cn)
目标(位置)
镜头目标是地图中心的位置,以纬度和经度坐标形式指定。
纬度可以介于 -85 度(含)和 85 度(含)之间。不在此范围内的值会被调整为此范围内最接近的值。例如,如果将纬度指定为 100,系统会将该值设为 85。经度范围为 -180 度(含)到 180 度(含)。不在此范围内的值会被换算为 (-180, 180) 范围内的值。例如,480、840 和 1200 都会换算为 120 度。方向角(方向)
镜头方向角指定了罗盘方向,以相对于正北方(对应于地图的顶部边缘)的角度来表示。从地图中心到顶部边缘画一条垂直线,镜头朝向相对于正北方的角度(以度为单位)即为方向角。
方向角为 0 表示地图顶部指向正北。方向角为 90 表示地图顶部指向正东方(罗盘上为 90 度)。方向角为 180 表示地图顶部指向正南方。
您可以使用 Maps API 更改地图的方向角。例如,驾车的用户通常会旋转道路地图使其与他们的行驶方向一致,而远足者使用地图和罗盘时通常会调整地图方向,使地图上有一条垂直线指向北方。
倾斜度(视角)
倾斜度是指镜头在地图中心位置正上方圆弧上所处的位置,以相对于天底(相机正下方)的角度来表示。值为 0 时,镜头竖直朝下。值大于 0 时,镜头按指定角度朝地平线倾斜。更改视角时,地图会以透视法呈现:远处的地图项显示得较小,而近处的地图项显示得较大。以下插图展示了这种情况。
在下面的图片中,视角为 0 度。第一张图片是视角为 0 度时的示意图;位置 1 是镜头位置,位置 2 是当前的地图位置。生成的地图如下所示。
![]() |
![]() |
以下图片中的视角为 45 度。请注意,镜头沿圆弧移到了正上(0 度)与地面(90 度)中间的位置,也就是位置 3。镜头仍指向地图的中心点,但现在位置 4 处的线表示的区域会显示出来。
![]() |
![]() |
此屏幕截图中的地图仍与原始地图采用同一个中心点,但地图顶部显示的地图项增加了。当您将角度增加到 45 度以上时,镜头和地图位置之间的地图项会按比例显示得较大,而地图位置远处的地图项会按比例显示得较小,从而产生三维效果。
缩放级别
镜头的缩放级别决定了地图的比例。放大时 在较小的缩放级别下,屏幕上显示的细节较多 可以在屏幕上看到更多的世界 缩放级别为 0 时,地图的比例为: 宽度约为 256 个点。
缩放级别每增加 1 个级别,屏幕上地球的宽度就会翻一番。因此,当缩放级别为 N 时,地球的宽度大约为 256 * 2N 点。例如,缩放级别为 2 时,整个地球大约为 宽 1024 磅。
缩放级别的值不必是整数。地图允许的缩放级别范围取决于多个因素,包括目标、地图类型和屏幕尺寸。超出该范围的任何数值都将转换为最接近的有效值(可以是最小缩放级别或最大缩放级别)。以下列表显示了您在每个缩放级别看到的地图的大致详细程度:
- 1:世界
- 5:大陆/洲
- 10:城市
- 15:街道
- 20:建筑物
![]() |
![]() |
![]() |
设置初始相机位置
使用
GMSCameraPosition
对象,可让您设置目标的纬度和经度,以及
方位、倾斜度和缩放。
要设置相机的初始位置,请创建一个 GMSMapViewOptions
对象并将
将 camera
属性设置为 GMSCameraPosition
。然后将您的选项传递给
GMSMapView
便捷构造函数。
Swift
let options = GMSMapViewOptions() options.camera = GMSCameraPosition.camera(withLatitude: -33.8683, longitude: 151.2086, zoom: 16) let mapView = GMSMapView(options:options)
Objective-C
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
对象
方法。在这种情况下,镜头的起始位置就是默认位置,
请在创建后更改
Swift
let options = GMSMapViewOptions() options.frame = self.view.bounds let mapView = GMSMapView(options:options)
Objective-C
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
属性。
Swift
let fancy = GMSCameraPosition( latitude: -33, longitude: 151, zoom: 6, bearing: 270, viewingAngle: 45 ) mapView.camera = fancy
Objective-C
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:
方法。
Swift
// Zoom in one zoom level let zoomCamera = GMSCameraUpdate.zoomIn() mapView.animate(with: zoomCamera)
Objective-C
// Zoom in one zoom level GMSCameraUpdate *zoomCamera = [GMSCameraUpdate zoomIn]; [mapView animateWithCameraUpdate:zoomCamera];
使用 GMSMapView
moveCamera:
方法将镜头对准新位置
。
在下一个示例中,您将使用 GMSCameraUpdate
为镜头的移动添加动画效果
让它以温哥华为中心
Swift
// Center the camera on Vancouver, Canada let vancouver = CLLocationCoordinate2D(latitude: 49.26, longitude: -123.11) let vancouverCam = GMSCameraUpdate.setTarget(vancouver) mapView.animate(with: vancouverCam)
Objective-C
// 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:
方法为镜头变化添加动画效果
倾斜度。
Swift
mapView.animate(toViewingAngle: 45)
Objective-C
[mapView animateToViewingAngle:45];
设置目标(位置)
位置决定了地图的中心。位置由
分别以程序化方式表示
CLLocationCoordinate2D
,使用 CLLocationCoordinate2DMake
创建。
使用 GMSCameraPosition
更改位置。在此示例中,地图会与
复制到新位置
Swift
let target = CLLocationCoordinate2D(latitude: -33.868, longitude: 151.208) mapView.camera = GMSCameraPosition(target: target, zoom: 6)
Objective-C
CLLocationCoordinate2D target = CLLocationCoordinate2DMake(-33.868, 151.208); mapView.camera = [GMSCameraPosition cameraWithTarget:target zoom:6];
要为变化添加动画效果并将地图平移到新位置,您可以使用
animateToCameraPosition:
方法,而不是设置 camera
属性。或者,
对 GMSMapView
使用 animateToLocation:
方法。
Swift
mapView.animate(toLocation: CLLocationCoordinate2D(latitude: -33.868, longitude: 151.208))
Objective-C
[mapView animateToLocation:CLLocationCoordinate2DMake(-33.868, 151.208)];
您还可以创建一个 GMSCameraUpdate
对象来移动镜头。使用
内置方法 scrollByX:Y:
,用于指定要滚动的点数
X 和 Y 方向上的镜头。在此示例中,您滚动镜头 200
指向右侧,向下 100 点:
Swift
// Move the camera 200 points to the right, and 100 points downwards let downwards = GMSCameraUpdate.scrollBy(x: 200, y: 100) mapView.animate(with: downwards)
Objective-C
// 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:
方法。
Swift
mapView.animate(toBearing: 0)
Objective-C
[mapView animateToBearing:0];
设置倾斜度(视角)
视角是镜头位于 测量地图的中心位置和地球表面,以相对于地球表面的 nadir(方向 镜头正下方)。更改视角时,地图 镜头和地图位置之间以透视法呈现地图项 按比例放大显示,而地图位置之外的地图项显示 从而实现三维效果
视角的范围为 0(垂直向下指向地图)和 最高可达到与缩放级别相关的最大值。对于缩放级别 16 或更高级别, 角度为 65 度对于缩放级别 10 或更低级别,最大角度为 30 度。
使用 GMSCameraPosition
以程序化方式设置视角,或
GMSCameraUpdate
,或者使用 GMSMapView
的 animateToViewingAngle:
方法。
Swift
mapView.animate(toViewingAngle: 45)
Objective-C
[mapView animateToViewingAngle:45];
设置缩放级别
镜头的缩放级别决定了地图的比例。放大时 就可以在屏幕上看到更多细节,而在较小的缩放级别, 看到更广阔的天地
使用 GMSCameraPosition
或 GMSCameraUpdate
以编程方式设置缩放;或者
animateToZoom:
方法为 GMSMapView
。
Swift
mapView.animate(toZoom: 12)
Objective-C
[mapView animateToZoom:12];
以下示例使用 zoomIn:
方法来构造 GMSCameraUpdate
。
对象以动画方式显示从当前级别放大一个级别的动画。
Swift
// Zoom in one zoom level let zoomCamera = GMSCameraUpdate.zoomIn() mapView.animate(with: zoomCamera)
Objective-C
// Zoom in one zoom level GMSCameraUpdate *zoomCamera = [GMSCameraUpdate zoomIn]; [mapView animateWithCameraUpdate:zoomCamera];
设置边界
移动镜头,使感兴趣的整个区域都显示在最显眼的位置, 设置相机视图的边界。例如,如果您 希望显示距离用户当前所在位置五英里内的所有加油站 移动镜头,使它们全部显示在屏幕上:
- 计算
GMSCoordinateBounds
, 显示在屏幕上。 - 使用
GMSMapView
的cameraForBounds:insets:
方法返回一个新的GMSCameraPosition
。
设置这些边界可确保给定的 GMSCoordinateBounds
完全适合
在当前地图大小范围内。请注意,此方法设置倾斜度和方位
0。
以下示例演示了如何更改镜头,使城市显示 温哥华和卡尔加里的城市在同一个视图中显示。
Swift
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
Objective-C
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。
Swift
mapView.cameraTargetBounds = bounds
Objective-C
mapView.cameraTargetBounds = bounds;
在下图所示的情况下,镜头目标被限制在一个略微大于视口的区域内。只要镜头目标仍然位于边界区域内,用户就可以滚动和平移。叉型记号表示镜头目标:
![显示大于
视口](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/documentation/ios-sdk/images/latlngbounds-camera1.png?authuser=19&hl=zh-cn)
地图将始终填满视口,即使这会导致视口显示指定边界以外的区域也是如此。例如,如果您将镜头目标定位在边界区域的角上,超出角的区域在视口中仍然可见,但是用户无法滚动到该区域。下图说明了这种情况。叉型记号表示镜头目标:
![显示镜头目标定位在屏幕右下角的图片
相机边界](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/documentation/ios-sdk/images/latlngbounds-camera2.png?authuser=19&hl=zh-cn)
在下图中,镜头目标具有非常有限的边界, 用户几乎没有滚动或平移地图的机会。叉型记号表示 镜头目标:
![显示小于
视口](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/documentation/ios-sdk/images/latlngbounds-camera3.png?authuser=19&hl=zh-cn)
设置最小或最大缩放级别
全局常量 kGMSMinZoomLevel
和 kGMSMaxZoomLevel
定义
最小或最大缩放值。默认情况下,minZoom
和 maxZoom
GMSMapView
的属性设置为这些常量。
要限制地图可用的缩放级别范围,请设置最小值和最大值 缩放级别。以下代码将缩放级别的范围限制为 10 到 15 之间。
Swift
let camera = GMSCameraPosition( latitude: 41.887, longitude: -87.622, zoom: 12 ) let mapView = GMSMapView(frame: .zero, camera: camera) mapView.setMinZoom(10, maxZoom: 15)
Objective-C
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
属性读取当前值。这个
只限制其中一个值时,此方法非常有用。以下代码
用于只更改最小缩放级别。
Swift
mapView.setMinZoom(12, maxZoom: mapView.maxZoom)
Objective-C
[mapView setMinZoom:12 maxZoom:mapView.maxZoom];
如果在更新最小和最大缩放级别后,将镜头的缩放级别设置为 值超出新范围,则当前缩放会自动更新为 显示最接近的有效值。例如,在以下代码中, 原始缩放级别定义为 4。稍后将缩放范围设置为 10-15 时, 当前缩放级别已更新为 10。
Swift
// 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)
Objective-C
// 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];