GMSPanoramaView 类参考

GMSPanoramaView 类参考文档

概览

全景图片用于显示街景图像。

它应通过 [[GMSPanoramaView alloc] initWithFrame:] 进行构建,并在初始化后进行配置。

与所有 UIKit 对象类似,应在主线程上访问所有属性和方法。此外,系统还会仅在主线程上回调GMSPanoramaViewDelegate方法。

此视图的 backgroundColor 在没有可见的全景时显示,例如加载时或该全景稍后设为 nil 时。不支持 backgroundColor 的 Alpha 颜色。

公开成员函数

(void) - setAllGesturesEnabled
 设置所有手势是否应启用(默认)或停用。
(void) - animateToCamera:animationDuration:
 将此GMSPanoramaView的相机以动画形式呈现到cameraduration(以秒为单位)内。
(void) - updateCamera:animationDuration
 根据 cameraUpdate 修改相机,超过 duration(以秒为单位指定)。
(void) - moveNearCoordinate
 请求 coordinate 附近的全景图片。
(void) - moveNearCoordinate:radius:
 与 MoveNearCoordinate 类似:但允许指定 coordinate 周围的搜索半径(米)。
(void) - moveNearCoordinate:source
 类似于 MoveNearCoordinate:但允许指定 coordinate 附近的来源。
(void) - moveNearCoordinate:radius:source
 与 MoveNearCoordinate 类似,但允许指定 coordinate 和来源周围的搜索半径(米)。
(void) - moveToPanoramaID
 使用 panoramaID 请求全景图片。
(CGPoint)- pointForOrientation
 对于当前视图,返回 orientation 所指向的屏幕点。
GMSOrientation- orientationForPoint
 为该视图指定点后,会返回通过该屏幕位置的当前相机方向。

静态公共成员函数

(实例类型)+ panoramaWithFrame:nearCoordinate:
 GMSPanoramaView的便捷构造函数,可搜索并显示coordinate附近的GMSPanorama
(实例类型)+ panoramaWithFrame:nearCoordinate:radius:
 与 PanoramaWithFrame:nearCoordinate:类似,但允许指定以coordinate为中心的搜索半径(米)。
(实例类型)+ panoramaWithFrame:nearCoordinate:source:
 GMSPanoramaView的便捷构造函数,可搜索并显示coordinate附近的GMSPanorama
(实例类型)+ panoramaWithFrame:nearCoordinate:radius:source:
 GMSPanoramaView的便捷构造函数,可搜索并显示coordinate附近的GMSPanorama

属性

GMSPanorama*全景图片
 要显示的全景图片;设置全景图片会转换为新的全景图片。
IBOutlet ID
< GMSPanoramaViewDelegate >
委托
 GMSPanoramaView 委托。
BOOL orientationGestures
 控制是否启用屏幕方向手势(默认)。
BOOL zoomGestures
 控制是否启用(默认)缩放手势。
BOOL navigationGestures
 控制是否启用(默认)或停用导航手势。
BOOL navigationLinksHidden
 控制可点按导航链接是隐藏还是可见(默认)。
BOOL 街道名称隐藏
 控制是否隐藏或显示街道名称叠加层(默认)。
GMSPanoramaCamera*camera
 控制全景相机。
GMSPanoramaLayer*图层
 用于图层的自定义 CALayer 类型的访问器。

成员函数文档

-(空)setAllGesturesEnabled (BOOL) 已启用

设置所有手势是否应启用(默认)或停用。

这不限制以编程方式移动相机或控制全景图片。

- (void) animateToCamera: (GMSPanoramaCamera *) camera
animationDuration: (NSTimeInterval) 时长

将此GMSPanoramaView的相机以动画形式呈现到cameraduration(以秒为单位)内。

- (void) updateCamera: (GMSPanoramaCameraUpdate *) cameraUpdate
animationDuration: (NSTimeInterval) 时长

根据 cameraUpdate 修改相机,超过 duration(以秒为单位指定)。

-(无效)moveNearCoordinate: (CLLocationCoordinate2D) 坐标

请求 coordinate 附近的全景图片。

成功完成后,PanoramaView:didMoveToPanorama: 和 PanoramaView:didMoveToPanorama:nearCoordinate: 将发送到GMSPanoramaViewDelegate

发生错误时,将会发送 PanoramaView:error:onMoveNearCoordinate:。

重复调用 MoveNearCoordinate: 会导致先前的待处理(未完成)转换被取消,但只有 MoveNearCoordinate: 和 MoveToPanoramaId: 的最新转换将会执行并生成事件。

-(无效)moveNearCoordinate: (CLLocationCoordinate2D) 坐标
半径: (NSUInteger)  半径

与 MoveNearCoordinate 类似:但允许指定 coordinate 周围的搜索半径(米)。

-(无效)moveNearCoordinate: (CLLocationCoordinate2D) 坐标
信息来源: (GMSPanoramaSource) 来源

类似于 MoveNearCoordinate:但允许指定 coordinate 附近的来源。

此 API 属于实验性 API,可能无法始终按来源过滤。

-(无效)moveNearCoordinate: (CLLocationCoordinate2D) 坐标
半径: (NSUInteger)  半径
信息来源: (GMSPanoramaSource) 来源

与 MoveNearCoordinate 类似,但允许指定 coordinate 和来源周围的搜索半径(米)。

此 API 属于实验性 API,可能无法始终按来源过滤。

- (void) moveToPanoramaID: (NSString *)  panoramaID

使用 panoramaID 请求全景图片。

成功完成后,PanoramaView:didMoveToPanorama: 将发送到GMSPanoramaViewDelegate

发生错误时,将会发送 PanoramaView:error:onMoveToPanoramaID:。

重复调用 MoveToPanoramaID: 会导致前一个待处理(未完成)过渡被取消 - 只有最近的 MoveNearCoordinate: 和 MoveToPanoramaId: 将会继续执行并生成事件。

仅支持从 Google Maps SDK for iOS 获取的全景图片 ID。

- (CGPoint) pointForOrientation GMSOrientation 方向

对于当前视图,返回 orientation 所指向的屏幕点。

对于前方足够远的向前方向,该值可能在视图之外。

结果将包含朝向视图外的摄像头方向的 NaN,其中隐含的屏幕点在方向方向上与摄像头的距离为负值。

- (GMSOrientation) orientationForPoint (CGPoint) 积分

为该视图指定点后,会返回通过该屏幕位置的当前相机方向。

在此视图的中心位置返回的 GMSOrientation 与当前 GMSPanoramaCamera 中的大致大致相同。

+(实例类型)PanoramaWithFrame: (CGRect) 框架
nearbyCoordinate: (CLLocationCoordinate2D) 坐标

GMSPanoramaView的便捷构造函数,可搜索并显示coordinate附近的GMSPanorama

这会执行与 MoveNearCoordinate: 类似的操作,并且会调用相同的委托方法。

+(实例类型)PanoramaWithFrame: (CGRect) 框架
nearbyCoordinate: (CLLocationCoordinate2D) 坐标
半径: (NSUInteger)  半径

与 PanoramaWithFrame:nearCoordinate:类似,但允许指定以coordinate为中心的搜索半径(米)。

+(实例类型)PanoramaWithFrame: (CGRect) 框架
nearbyCoordinate: (CLLocationCoordinate2D) 坐标
信息来源: (GMSPanoramaSource) 来源

GMSPanoramaView的便捷构造函数,可搜索并显示coordinate附近的GMSPanorama

这将执行与 MoveNearCoordinate:source 的操作类似的操作,并且会调用相同的委托方法。

此 API 属于实验性 API,可能无法始终按来源过滤。

+(实例类型)PanoramaWithFrame: (CGRect) 框架
nearbyCoordinate: (CLLocationCoordinate2D) 坐标
半径: (NSUInteger)  半径
信息来源: (GMSPanoramaSource) 来源

GMSPanoramaView的便捷构造函数,可搜索并显示coordinate附近的GMSPanorama

这会执行与 MoveNearCoordinate:radius:source 类似的操作,并且会调用相同的委托方法。

此 API 属于实验性 API,可能无法始终按来源过滤。


属性说明

- (GMSPanorama*) 全景 [read, write, assign]

要显示的全景图片;设置全景图片会转换为新的全景图片。

这是动画效果,初始全景图片除外。

可以设置为 nil 以清除视图。

- (IBOutlet id<GMSPanoramaViewDelegate>) 委托 [read, write, assign]

GMSPanoramaView 委托。

- (BOOL) orientationGestures [read, write, assign]

控制是否启用屏幕方向手势(默认)。

启用后,用户可以使用手势更改摄像头的朝向。

这不会限制相机的程序化移动。

- (BOOL) zoomGestures [read, write, assign]

控制是否启用(默认)缩放手势。

启用后,用户可以通过双指张合缩放摄像头。

这不会限制相机的程序化移动。

- (BOOL) navigationGestures [read, write, assign]

控制是否启用(默认)或停用导航手势。

如果处于启用状态,用户可以通过点按导航链接或点按两次视图来更改全景。

这不会限制以编程方式控制全景图片。

- (BOOL) navigationLinksHidden [read, write, assign]

控制可点按导航链接是隐藏还是可见(默认)。

无法点按隐藏的导航链接。

- (BOOL) streetNamesHidden [read, write, assign]

控制是否隐藏或显示街道名称叠加层(默认)。

- (GMSPanoramaCamera*) 相机 [read, write, assign]

控制全景相机。

在此处设置新相机会跳转到新的相机值,而不使用动画。

- (GMSPanoramaLayer*) 图层 [read, retain]

用于图层的自定义 CALayer 类型的访问器。