概览
全景图片用于显示街景图像。
它应通过 [[GMSPanoramaView alloc] initWithFrame:] 进行构建,并在初始化后进行配置。
与所有 UIKit 对象类似,应在主线程上访问所有属性和方法。此外,系统还会仅在主线程上回调GMSPanoramaViewDelegate方法。
此视图的 backgroundColor 在没有可见的全景时显示,例如加载时或该全景稍后设为 nil 时。不支持 backgroundColor 的 Alpha 颜色。
公开成员函数 | |
(void) | - setAllGesturesEnabled: |
设置所有手势是否应启用(默认)或停用。 | |
(void) | - animateToCamera:animationDuration: |
将此GMSPanoramaView的相机以动画形式呈现到camera 上duration (以秒为单位)内。 | |
(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的相机以动画形式呈现到camera
上duration
(以秒为单位)内。
- (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 类型的访问器。