这是 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 | 在用户长按全景图片时使用的回调接口。 |
公共方法摘要
继承的方法摘要
公共方法
public void animateTo (StreetViewPanoramaCamera 镜头,长持续时间)
在指定时长内,将当前的镜头位置、方向和缩放级别更改为指定位置
参数
camera | 要添加动画效果的镜头位置 |
---|---|
duration | 从当前相机位置转换到指定位置所需的时长(以毫秒为单位) |
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 位置,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 (如果允许用户使用缩放手势)
|
---|