StreetViewPanorama

public 类 StreetViewPanorama扩展对象

这是 Google Maps SDK for Android 中街景功能的主类，并且是与街景全景图片相关的所有方法的入口点。您无法直接实例化 StreetViewPanorama 对象，您必须通过您已添加到应用的 StreetViewPanoramaFragment 或 StreetViewPanoramaView 上的 #getStreetViewPanoramaAsync() 方法获取一个对象。

注意：与 View 对象类似，StreetViewPanorama 只能通过主线程读取和修改。从其他线程调用 StreetViewPanorama 方法将会导致异常。

开发者指南

如需开始使用 Google Maps SDK for Android，请阅读 Google Maps SDK for Android 开发者指南。

嵌套类摘要

接口	StreetViewPanorama.OnStreetViewPanoramaCameraChangeListener		针对 StreetViewPanoramaCamera 更改的监听器
接口	StreetViewPanorama.OnStreetViewPanoramaChangeListener		一个监听器，用于监听街景全景图片何时加载新的全景图片
接口	StreetViewPanorama.OnStreetViewPanoramaClickListener		在用户点按全景图片时使用的回调接口。
接口	StreetViewPanorama.OnStreetViewPanoramaLongClickListener		在用户长按全景图片时使用的回调接口。

公共方法摘要

void	animateTo（StreetViewPanoramaCamera 镜头，长持续时间） 在指定时长内，将当前的镜头位置、方向和缩放级别更改为指定位置
StreetViewPanoramaLocation	getLocation() 返回用户的当前位置，以及当前全景图片相邻全景图片的相关信息
StreetViewPanoramaCamera	getPanoramaCamera() 返回当前方向和缩放比例
布尔值	isPanningGesturesEnabled() 返回用户是否启用了平移手势。
布尔值	isStreetNamesEnabled() 用于返回街道名称是否显示在全景图片上
布尔值	isUserNavigationEnabled() 返回用户是否启用了导航。
布尔值	isZoomGesturesEnabled() 返回是否为用户启用缩放手势
点	orientationToPoint（StreetViewPanoramaOrientation 屏幕方向） 返回与方向对应的屏幕位置 (StreetViewPanoramaOrientation)。
StreetViewPanoramaOrientation	pointToOrientation（点） 返回与屏幕位置对应的方向。
final void	setOnStreetViewPanoramaCameraChangeListener（StreetViewPanorama.OnStreetViewPanoramaCameraChangeListener 监听器） 设置在镜头更改时调用的回调
final void	setOnStreetViewPanoramaChangeListener（StreetViewPanorama.OnStreetViewPanoramaChangeListener 监听器） 设置在全景图片更改时调用的回调
final void	setOnStreetViewPanoramaClickListener（StreetViewPanorama.OnStreetViewPanoramaClickListener 监听器） 设置在点按全景图片时调用的回调。
final void	setOnStreetViewPanoramaLongClickListener（StreetViewPanorama.OnStreetViewPanoramaLongClickListener 监听器） 设置在用户长按全景图片时调用的回调。
void	setPanningGesturesEnabled（布尔值 enablePanning） 设置用户是否能够使用平移手势
void	setPosition(String panoId) 将 StreetViewPanorama 设置为指定位置
void	setPosition(LatLng 位置) 将 StreetViewPanorama 设置为指定位置
void	setPosition（LatLng 位置，StreetViewSource 来源） 将 StreetViewPanorama 设置为指定位置
void	setPosition(LatLng position, int radius, StreetViewSource 源) 将 StreetViewPanorama 设置为指定位置
void	setPosition(LatLng position, int radius) 将 StreetViewPanorama 设置为指定位置
void	setStreetNamesEnabled（布尔值 enableStreetNames） 设置用户是否能看到全景图片中的街道名称
void	setUserNavigationEnabled（布尔值 enableUserNavigation） 设置用户能否移至另一幅全景图片
void	setZoomGesturesEnabled（布尔值 enableZoom） 设置用户是否能够使用缩放手势

继承的方法摘要

继承自 java.lang.Object 类

布尔值	equals(Object arg0)
final Class<?>	getClass()
整型	hashCode()
final void	notify()
final void	notifyAll()
字符串	toString()
final void	wait(long arg0, int arg1)
final void	wait(long arg0)
final void	wait()

公共方法

public void animateTo （StreetViewPanoramaCamera 镜头，长持续时间）

在指定时长内，将当前的镜头位置、方向和缩放级别更改为指定位置

参数

camera	要添加动画效果的镜头位置
duration	从当前相机位置转换到指定位置所需的时长（以毫秒为单位）

public StreetViewPanoramaLocation getLocation ()

返回用户的当前位置，以及当前全景图片相邻全景图片的相关信息

返回

• 用户的当前位置

public StreetViewPanoramaCamera getPanoramaCamera ()

返回当前方向和缩放比例

返回

• 当前摄像头

public boolean isPanningGesturesEnabled ()

返回用户是否启用了平移手势。

返回

• true（如果已启用平移手势）

public boolean isStreetNamesEnabled ()

用于返回街道名称是否显示在全景图片上

返回

• true（如果显示街道名称）

public boolean isUserNavigationEnabled ()

返回用户是否启用了导航。这包括点按两次以及使用导航链接

返回

• true（如果已启用导航）

public boolean isZoomGesturesEnabled ()

返回是否为用户启用缩放手势

返回

• true（如果启用了缩放手势）

public Point orientationToPoint （StreetViewPanoramaOrientation 屏幕方向）

返回与方向对应的屏幕位置 (StreetViewPanoramaOrientation)。屏幕位置以相对于街景全景图片左上角（而非整个屏幕）的屏幕像素（而非显示像素）为单位。

参数

屏幕方向	街景全景图片上的 StreetViewPanoramaOrientation，用于转换为屏幕位置。

返回

• 表示屏幕位置的 Point（以屏幕像素为单位）。如果屏幕方向无法投影到屏幕上（例如，位于用户的视野范围后），则返回 null

public StreetViewPanoramaOrientation pointToOrientation （点点）

返回与屏幕位置对应的方向。屏幕位置以相对于街景全景图片左上角（而不是整个屏幕的左上角）的屏幕像素（而非显示像素）为单位。

参数

point	屏幕上的 Point（以像素为单位）。

返回

• 与屏幕上的 point 对应的 StreetViewPanoramaOrientation；如果街景全景图片尚未初始化或者指定的点不是屏幕上的有效点，则为 null。

public final void setOnStreetViewPanoramaCameraChangeListener (StreetViewPanorama.OnStreetViewPanoramaCameraChangeListener 监听器)

设置在镜头更改时调用的回调

参数

监听器	在镜头更改时调用的回调。如需取消设置回调，请使用 null。

public final void setOnStreetViewPanoramaChangeListener (StreetViewPanorama.OnStreetViewPanoramaChangeListener 监听器)

设置在全景图片更改时调用的回调

参数

监听器	在全景图片更改时调用的回调。如需取消设置回调，请使用 null。

public final void setOnStreetViewPanoramaClickListener (StreetViewPanorama.OnStreetViewPanoramaClickListener 监听器)

设置在点按全景图片时调用的回调。

参数

监听器	点按全景图片时调用的回调。如需取消设置回调，请使用 null。

public final void setOnStreetViewPanoramaLongClickListener (StreetViewPanorama.OnStreetViewPanoramaLongClickListener 监听器)

设置在用户长按全景图片时调用的回调。

参数

监听器	长按全景图片时调用的回调。如需取消设置回调，请使用 null。

public void setPanningGesturesEnabled (boolean enablePanning)

设置用户是否能够使用平移手势

参数

enablePanning	true（如果允许用户使用平移手势）

public void setPosition (String panoId)

将 StreetViewPanorama 设置为指定位置

参数

panoId	所需位置的全景图片 ID

public void setPosition (LatLng position)

将 StreetViewPanorama 设置为指定位置

参数

排名	所需位置的纬度和经度

public void setPosition （LatLng 位置，StreetViewSource 来源）

将 StreetViewPanorama 设置为指定位置

参数

排名	所需位置的纬度和经度
source	StreetViewSource 指定要搜索的全景图片的来源

public void setPosition (LatLng position, int radius, StreetViewSource source)

将 StreetViewPanorama 设置为指定位置

参数

排名	所需位置的纬度和经度
半径范围	半径（以米为单位），用于指定要在什么区域内搜索全景图片，以指定的纬度和经度为中心
source	StreetViewSource 指定要搜索的全景图片的来源

public void setPosition (LatLng position, int radius)

将 StreetViewPanorama 设置为指定位置

参数

排名	所需位置的纬度和经度
半径范围	半径（以米为单位），用于指定要在什么区域内搜索全景图片，以指定的纬度和经度为中心

public void setStreetNamesEnabled (boolean enableStreetNames)

设置用户是否能看到全景图片中的街道名称

参数

enableStreetNames	如果用户能够在全景图片上看到街道名称，则为 true

public void setUserNavigationEnabled (boolean enableUserNavigation)

设置用户能否移至另一幅全景图片

参数

enableUserNavigation	true（如果允许用户移至另一幅全景图片）

public void setZoomGesturesEnabled (boolean enableZoom)

设置用户是否能够使用缩放手势

参数

enableZoom	true（如果允许用户使用缩放手势）