這是 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 | |
StreetViewPanoramaLocation |
getLocation()
傳回使用者目前位置以及目前全景相鄰全景的相關資訊
|
StreetViewPanoramaCamera |
getPanoramaCamera()
傳回目前的方向和縮放
|
布林值 |
isPanningGesturesEnabled()
傳回是否要為使用者啟用平移手勢
|
布林值 |
isStreetNamesEnabled()
傳回全景上是否顯示街道名稱
|
布林值 |
isUserNavigationEnabled()
傳回是否要為使用者啟用導覽功能。
|
布林值 |
isZoomGesturesEnabled()
傳回使用者是否已啟用縮放手勢
|
點 | |
StreetViewPanoramaOrientation |
pointToOrientation(點點)
傳回對應螢幕位置的方向。
|
最後 void | |
最後 void | |
最後 void | |
最後 void | |
void |
setPanningGesturesEnabled(boolean enablePanning)
設定使用者是否能使用平移手勢
|
void |
setPosition(String panoId)
將 StreetViewPanorama 設為指定位置
|
void | |
void | |
void | |
void | |
void |
setStreetNamesEnabled(boolean enableStreetNames)
設定使用者是否能在全景相片中看到街道名稱
|
void |
setUserNavigationEnabled(boolean enableUserNavigation)
設定使用者是否能移至其他全景
|
void |
setZoomGesturesEnabled(布林值啟用縮放)
設定使用者是否能使用縮放手勢
|
繼承方法摘要
公用方法
public void animateTo (StreetViewPanoramaCamera 相機,長時間使用)
在指定時間長度內,將目前的相機位置、方向和縮放變更為指定位置
參數
相機 | 動畫的相機位置 |
---|---|
持續時間 | 從目前相機位置轉換至指定位置所需的時間長度 (以毫秒為單位)。 |
公開布林值 isPanningGesturesEnabled ()
傳回是否要為使用者啟用平移手勢
傳回
true
(如果已啟用平移手勢)
public boolean isStreetNamesEnabled ()
傳回全景上是否顯示街道名稱
傳回
- 如果顯示街道名稱,則為
true
公開布林值 isUserNavigationEnabled ()
傳回是否要為使用者啟用導覽功能。包括輕觸兩下以及使用導覽連結
傳回
- 如果已啟用導覽功能,則為
true
公開布林值 isZoomGesturesEnabled ()
傳回使用者是否已啟用縮放手勢
傳回
- 如果已啟用縮放手勢,則為
true
public Point orientationToPoint (StreetViewPanoramaOrientation 方向)
傳回與方向 (StreetViewPanoramaOrientation
) 對應的畫面位置。螢幕位置會以相對於街景服務全景的左上角 (而非整個螢幕) 的螢幕像素 (而非顯示像素) 為單位。
參數
方向 | 街景服務全景上的 StreetViewPanoramaOrientation ,可轉換為螢幕位置。 |
---|
傳回
Point
代表螢幕位置 (以螢幕像素為單位)。如果無法在螢幕上投影方向,則會傳回null
(如位於使用者的檢視畫面欄位後方)
公開 StreetViewPanoramaOrientation pointToOrientation (點點)
傳回對應螢幕位置的方向。螢幕位置的指定單位是相對於街景服務全景左上角的螢幕像素 (而非顯示像素),而非整個螢幕的左上方。
參數
分 | 螢幕上的 Point ,以螢幕像素為單位。 |
---|
傳回
- 與螢幕上
point
相對應的StreetViewPanoramaOrientation
;如果街景服務全景尚未初始化,或指定的點不是畫面上的有效點,則為null
public 最後 void setOnStreetViewPanoramaCameraChangeListener (StreetViewPanorama.OnStreetViewPanoramaCameraChangeListener 事件監聽器)
設定相機變更時叫用的回呼
參數
事件監聽器 | 相機變更時叫用的回呼。如要取消設定回呼,請使用 null 。 |
---|
公開 最後 void setOnStreetViewPanoramaChangeListener (StreetViewPanorama.OnStreetViewPanoramaChangeListener 事件監聽器)
設定當全景變更時叫用的回呼。
參數
事件監聽器 | 全景變更時叫用的回呼。如要取消設定回呼,請使用 null 。 |
---|
公開 最後 void setOnStreetViewPanoramaClickListener (StreetViewPanorama.OnStreetViewPanoramaClickListener 事件監聽器)
設定輕觸全景時叫用的回呼。
參數
事件監聽器 | 輕觸全景時叫用的回呼。如要取消設定回呼,請使用 null 。 |
---|
公開 最後 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 設為指定位置
參數
排名 | 所需位置的經緯度 |
---|---|
來源 | StreetViewSource 會指定要搜尋的全景來源 |
public void setPosition (LatLng 位置、 int 半徑、StreetViewSource 來源)
將 StreetViewPanorama 設為指定位置
參數
排名 | 所需位置的經緯度 |
---|---|
半徑 | 半徑 (以公尺為單位),定義要搜尋全景的區域 (以指定經緯度為中心) |
來源 | StreetViewSource 會指定要搜尋的全景來源 |
public void setPosition (LatLng 位置, int 半徑)
將 StreetViewPanorama 設為指定位置
參數
排名 | 所需位置的經緯度 |
---|---|
半徑 | 半徑 (以公尺為單位),以指定經緯度為中心,定義搜尋全景的範圍 |
public void setStreetNamesEnabled (boolean enableStreetNames)
設定使用者是否能在全景相片中看到街道名稱
參數
enableStreetNames | true :如果使用者能在全景相片上看到街道名稱
|
---|
public void setUserNavigationEnabled (boolean enableUserNavigation)
設定使用者是否能移至其他全景
參數
enableUserNavigation | 如果使用者可以移至其他全景,則為 true |
---|
public void setZoomGesturesEnabled (boolean enableZoom)
設定使用者是否能使用縮放手勢
參數
enableZoom | true :如果使用者允許使用縮放手勢
|
---|