GMSCameraPosition 类参考

GMSCameraPosition 类参考

概览

一个不可变类,用于聚合所有相机位置参数。

GMSMutableCameraPosition 继承。

公开成员函数

(实例类型)- initWithTarget:zoom:bearing:viewingAngle:
 指定的初始化程序。
(实例类型)- initWithTarget:zoom
 用于针对特定目标和缩放级别的GMSCameraPosition的便捷初始化程序。
(实例类型)- initWithLatitude:longitude:zoom:
 GMSCameraPosition用于针对特定纬度、经度和缩放级别的便利初始化程序。
(实例类型)- initWithLatitude:longitude:zoom:bearing:viewingAngle:
 GMSCameraPosition的便捷初始化程序,包含符合-initWithTarget:zoom:bearing:viewingAngle:的纬度/经度和其他镜头属性。

静态公开成员函数

(实例类型)+ cameraWithTarget:zoom:
 用于特定目标和缩放级别的GMSCameraPosition的便捷构造函数。
(实例类型)+ cameraWithLatitude:longitude:zoom:
 GMSCameraPosition 的简便构造函数,如 cameraWithTarget:zoom: 中所述。
(实例类型)+ cameraWithTarget:zoom:bearing:viewingAngle:
 GMSCameraPosition 的便捷构造函数,其中包含根据 initWithTarget:zoom:bearing:viewingAngle: 规定的所有镜头属性。
(实例类型)+ cameraWithLatitude:longitude:zoom:bearing:viewingAngle:
 GMSCameraPosition 的简便构造函数,包含符合 initWithTarget:zoom:bearing:viewingAngle: 的纬度/经度以及其他所有镜头属性。
(float) + zoomAtCoordinate:forMeters:perPoints:
 获取在地球上给定的 coord 下,meters 距离对应于屏幕 points 的指定数量的缩放级别。

属性

CLLocationCoordinate2D目标
 地球上镜头所指向的位置。
float 缩放
 缩放级别。
CLLocationDirection方位
 镜头的方向角(以与正北方所呈顺时针角度表示)。
双精度viewingAngle
 镜头与底部(正对地球)之间的角度(以度为单位)。

成员函数文档

- (instancetype) initWithTarget: (CLLocationCoordinate2D)  目标
缩放: (float)  缩放
方向角: (CLLocationDirection) 方位
viewAngle: (双精度) viewingAngle

指定的初始化程序。

使用所有可用的镜头属性配置该GMSCameraPosition。通过此初始化程序(或通过下面的便捷构造函数)构建GMSCameraPosition会隐式固定镜头值。

参数:
目标地球上镜头所指向的位置。
zoom靠近屏幕中心的缩放级别。
方向角镜头方位(以与正北方所呈顺时针角度表示)。
viewingAngle镜头角度与底部(正对地球)之间的角度(以度为单位)
- (instancetype) initWithTarget: (CLLocationCoordinate2D)  目标
缩放: (float)  缩放

用于针对特定目标和缩放级别的GMSCameraPosition的便捷初始化程序。

这会将该镜头的方向角和 viewAngle 属性设为默认值 0(即正对地球表面,屏幕顶部指向北方)。

参数:
目标地球上镜头所指向的位置。
zoom靠近屏幕中心的缩放级别。
- (instancetype) initWithLatitude: (CLLocationDegrees) latitude
longitude: (CLLocationDegrees) longitude
缩放: (float)  缩放

GMSCameraPosition用于针对特定纬度、经度和缩放级别的便利初始化程序。

这会将该镜头的方向角和 viewAngle 属性设为默认值 0(即正对地球表面,屏幕顶部指向北方)。

参数:
latitude镜头所指向位置的纬度分量。
longitude镜头所指向位置的纬度分量。
zoom靠近屏幕中心的缩放级别。
- (instancetype) initWithLatitude: (CLLocationDegrees) latitude
longitude: (CLLocationDegrees) longitude
缩放: (float)  缩放
方向角: (CLLocationDirection) 方位
viewAngle: (双精度) viewingAngle

GMSCameraPosition的便捷初始化程序,包含符合-initWithTarget:zoom:bearing:viewingAngle:的纬度/经度和其他镜头属性。

参数:
latitude镜头所指向位置的纬度分量。
longitude镜头所指向位置的纬度分量。
zoom靠近屏幕中心的缩放级别。
方向角镜头方位(以与正北方所呈顺时针角度表示)。
viewingAngle镜头角度与底部(正对地球)之间的角度(以度为单位)
+ (instancetype) cameraWithTarget: (CLLocationCoordinate2D)  目标
缩放: (float)  缩放

用于特定目标和缩放级别的GMSCameraPosition的便捷构造函数。

这会将该镜头的方向角和 viewAngle 属性设为默认值 0(即正对地球表面,屏幕顶部指向北方)。

+ (instancetype) cameraWithLatitude: (CLLocationDegrees) latitude
longitude: (CLLocationDegrees) longitude
缩放: (float)  缩放

GMSCameraPosition 的简便构造函数,如 cameraWithTarget:zoom: 中所述。

+ (instancetype) cameraWithTarget: (CLLocationCoordinate2D)  目标
缩放: (float)  缩放
方向角: (CLLocationDirection) 方位
viewAngle: (双精度) viewingAngle

GMSCameraPosition 的便捷构造函数,其中包含根据 initWithTarget:zoom:bearing:viewingAngle: 规定的所有镜头属性。

+ (instancetype) cameraWithLatitude: (CLLocationDegrees) latitude
longitude: (CLLocationDegrees) longitude
缩放: (float)  缩放
方向角: (CLLocationDirection) 方位
viewAngle: (双精度) viewingAngle

GMSCameraPosition 的简便构造函数,包含符合 initWithTarget:zoom:bearing:viewingAngle: 的纬度/经度以及其他所有镜头属性。

+(浮点数)zoomAtCoordinate: (CLLocationCoordinate2D)  坐标
forMeters: (CLLocationDistance)
perPoint: (CGFloat) 积分

获取在地球上给定的 coord 下,meters 距离对应于屏幕 points 的指定数量的缩放级别。

对于极大或极小的距离,返回的缩放级别可能会小于或大于相机所允许的最小或最大缩放级别。

此辅助方法对于构建包含地球上特定物理区域的镜头位置非常有用。


属性说明

- (CLLocationCoordinate2D) 目标 [read, assign]

地球上镜头所指向的位置。

GMSMutableCameraPosition中实现。

-(浮点数)缩放 [read, assign]

缩放级别。

缩放使用指数级范围,其中缩放 0 以 256 x 256 的正方形表示整个世界。每增加一个缩放级别,放大比例就会增加 2 倍。因此,缩放级别为 1 时,世界为 512x512,缩放级别为 2 时,整个世界为 1024x1024。

GMSMutableCameraPosition中实现。

- (CLLocationDirection) 方位 [read, assign]

镜头的方向角(以与正北方所呈顺时针角度表示)。

GMSMutableCameraPosition中实现。

-(双精度)viewingAngle [read, assign]

镜头与底部(正对地球)之间的角度(以度为单位)。

0 表示垂直向下,90 与地面平行。请注意,允许的最大角度取决于缩放级别。您可以将它看作是一系列线段(用作缩放函数),而不是阶跃函数。对于缩放级别 16 及以上的缩放级别,最大角度为 65 度。对于缩放级别 10 及以下,最大角度为 30 度。

GMSMutableCameraPosition中实现。