GMSCameraPosition 类参考文档

GMSCameraPosition 类参考文档

概览

用于汇总所有相机位置参数的不可变类。

GMSMutableCameraPosition 继承。

公开成员函数

(实例类型)- initWithTarget:zoom:bearing:viewingAngle
 指定的初始化程序。
(实例类型)- initWithTarget:zoom:
 针对特定目标和缩放级别的GMSCameraPosition的便捷初始化程序。
(实例类型)- initWithLatitude:经度:zoom:
 针对特定纬度、经度和缩放级别的 GMSCameraPosition 的便捷初始化器。
(实例类型)- initWithLatitude:经度:zoom:bearing:viewingAngle
 GMSCameraPosition的便捷初始化程序,其纬度和经度以及其他相机属性均根据 -initWithTarget:zoom:bearing:viewingAngle: 确定。

静态公共成员函数

(实例类型)+ cameraWithTarget:zoom:
 针对特定目标和缩放级别的GMSCameraPosition的便捷构造函数。
(实例类型)+ cameraWithLatitude:经度:zoom:
 GMSCameraPosition的便捷构造函数(如 cameraWithTarget:zoom: 中所说)。
(实例类型)+ cameraWithTarget:zoom:bearing:viewingAngle
 GMSCameraPosition的便捷构造函数,根据 initWithTarget:zoom:bearing:viewingAngle: 的所有相机属性。
(实例类型)+ cameraWithLatitude:经度:zoom:bearing:viewingAngle
 GMSCameraPosition的便捷构造函数,如 initWithTarget:zoom:bearing:viewingAngle: 中所述,纬度/经度以及其他所有相机属性。
(浮点数)+ zoomAtCoordinate:forMeters:perPoints:
 获取地球上指定 coord 处的 meters 距离所对应的指定数量的屏幕 points

属性

CLLocationCoordinate2D目标
 地球上的相机所指向的位置。
浮点数缩放
 缩放级别。
CLLocationDirection方位
 摄像头的方位,与正北方所呈顺时针角度(以度为单位)。
double查看角度
 相机相对于底部(直接面向地球)的角度(以度为单位)。

成员函数文档

-(实例类型)initWithTarget: (CLLocationCoordinate2D) 目标
缩放: (浮点数) 缩放
方位: (CLLocationDirection) 方位
查看角度: (双精度) viewingAngle

指定的初始化程序。

使用所有可用的相机属性配置此 GMSCameraPosition。通过此初始化程序(或以下便捷构造函数)构建GMSCameraPosition会隐式限制相机值。

参数:
target地球上的相机所指向的位置。
zoom靠近屏幕中心的缩放级别。
方位与正北方所呈的顺时针角度(以度为单位)。
视角自底角(直接面向地球)的相机角度(以度为单位)
-(实例类型)initWithTarget: (CLLocationCoordinate2D) 目标
缩放: (浮点数) 缩放

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

这会将此相机的方向角和 viewAngle 属性设置为零(即直接朝向地球表面,屏幕顶部为北)。

参数:
target地球上的相机所指向的位置。
zoom靠近屏幕中心的缩放级别。
-(实例类型)initWithLatitude: (CLLocationDegrees) latitude
经度: (CLLocationDegrees) longitude
缩放: (浮点数) 缩放

针对特定纬度、经度和缩放级别的 GMSCameraPosition 的便捷初始化器。

这会将此相机的方向角和 viewAngle 属性设置为零(即直接朝向地球表面,屏幕顶部为北)。

参数:
纬度相机所指向位置的纬度分量。
longitude相机所指向位置的纬度分量。
zoom靠近屏幕中心的缩放级别。
-(实例类型)initWithLatitude: (CLLocationDegrees) latitude
经度: (CLLocationDegrees) longitude
缩放: (浮点数) 缩放
方位: (CLLocationDirection) 方位
查看角度: (双精度) viewingAngle

GMSCameraPosition的便捷初始化程序,其纬度和经度以及其他相机属性均根据 -initWithTarget:zoom:bearing:viewingAngle: 确定。

参数:
纬度相机所指向位置的纬度分量。
longitude相机所指向位置的纬度分量。
zoom靠近屏幕中心的缩放级别。
方位与正北方所呈的顺时针角度(以度为单位)。
视角自底角(直接面向地球)的相机角度(以度为单位)
+(实例类型)cameraWithTarget: (CLLocationCoordinate2D) 目标
缩放: (浮点数) 缩放

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

这会将此相机的方向角和 viewAngle 属性设置为零(即直接朝向地球表面,屏幕顶部为北)。

+(实例类型)cameraWithLatitude: (CLLocationDegrees) latitude
经度: (CLLocationDegrees) longitude
缩放: (浮点数) 缩放

GMSCameraPosition的便捷构造函数(如 cameraWithTarget:zoom: 中所说)。

+(实例类型)cameraWithTarget: (CLLocationCoordinate2D) 目标
缩放: (浮点数) 缩放
方位: (CLLocationDirection) 方位
查看角度: (双精度) viewingAngle

GMSCameraPosition的便捷构造函数,根据 initWithTarget:zoom:bearing:viewingAngle: 的所有相机属性。

+(实例类型)cameraWithLatitude: (CLLocationDegrees) latitude
经度: (CLLocationDegrees) longitude
缩放: (浮点数) 缩放
方位: (CLLocationDirection) 方位
查看角度: (双精度) viewingAngle

GMSCameraPosition的便捷构造函数,如 initWithTarget:zoom:bearing:viewingAngle: 中所述,纬度/经度以及其他所有相机属性。

+ (float) zoomAtCoordinate: (CLLocationCoordinate2D) 坐标
forMeter: (CLLocationDistance)
积分: (CGFloat) 积分

获取地球上指定 coord 处的 meters 距离所对应的指定数量的屏幕 points

对于非常大或较小的距离,返回的缩放级别可能小于或大于相机允许的最小或最大缩放级别。

此辅助方法有助于构建包含地球上特定物理区域的相机位置。


属性说明

- (CLLocationCoordinate2D) 目标 [read, assign]

地球上的相机所指向的位置。

GMSMutableCameraPosition 中实现。

-(浮动)缩放 [read, assign]

缩放级别。

Zoom 采用指数缩放,其中 0 表示 256 x 256 的正方形,代表整个世界。连续的缩放级别都会增加 2 倍放大倍数。因此,缩放级别为 1 时,世界的尺寸为 512x512;当缩放级别为 2 时,整个世界的尺寸为 1024x1024。

GMSMutableCameraPosition 中实现。

- (CLLocationDirection) 方向角 [read, assign]

摄像头的方位,与正北方所呈顺时针角度(以度为单位)。

GMSMutableCameraPosition 中实现。

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

相机相对于底部(直接面向地球)的角度(以度为单位)。

0 为垂直向下,90 为与地面平行。请注意,允许的最大角度取决于缩放级别。您可以将它视为一系列线段,用于缩放而非缩放。对于缩放级别 16 及以上,最大角度为 65 度。对于缩放级别为 10 及更低版本,最大角度为 30 度。

GMSMutableCameraPosition 中实现。