StreetViewPanorama

公用類別 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(點點)
傳回對應螢幕位置的方向。
最後 void
setOnStreetViewPanoramaCameraChangeListener(StreetViewPanorama.OnStreetViewPanoramaCameraChangeListener 事件監聽器)
設定相機變更時叫用的回呼
最後 void
setOnStreetViewPanoramaChangeListener(StreetViewPanorama.OnStreetViewPanoramaChangeListener 事件監聽器)
設定當全景變更時叫用的回呼。
最後 void
setOnStreetViewPanoramaClickListener(StreetViewPanorama.OnStreetViewPanoramaClickListener 事件監聽器)
設定輕觸全景時叫用的回呼。
最後 void
setOnStreetViewPanoramaLongClickListener(StreetViewPanorama.OnStreetViewPanoramaLongClickListener 事件監聽器)
設定長按全景時叫用的回呼。
void
setPanningGesturesEnabled(boolean enablePanning)
設定使用者是否能使用平移手勢
void
setPosition(String panoId)
將 StreetViewPanorama 設為指定位置
void
setPosition(LatLng 位置)
將 StreetViewPanorama 設為指定位置
void
setPosition(LatLng 位置、StreetViewSource 來源)
將 StreetViewPanorama 設為指定位置
void
setPosition(LatLng 位置、 int 半徑、StreetViewSource 來源)
將 StreetViewPanorama 設為指定位置
void
setPosition(LatLng 位置, int 半徑)
將 StreetViewPanorama 設為指定位置
void
setStreetNamesEnabled(boolean enableStreetNames)
設定使用者是否能在全景相片中看到街道名稱
void
setUserNavigationEnabled(boolean enableUserNavigation)
設定使用者是否能移至其他全景
void
setZoomGesturesEnabled(布林值啟用縮放)
設定使用者是否能使用縮放手勢

繼承方法摘要

公用方法

public void animateTo (StreetViewPanoramaCamera 相機，長時間使用)

在指定時間長度內，將目前的相機位置、方向和縮放變更為指定位置

參數
相機 動畫的相機位置
持續時間 從目前相機位置轉換至指定位置所需的時間長度 (以毫秒為單位)。

公開 StreetViewPanoramaLocation getLocation ()

傳回使用者目前位置以及目前全景相鄰全景的相關資訊

傳回
  • 使用者的目前位置

公開 StreetViewPanoramaCamera getPanoramaCamera ()

傳回目前的方向和縮放

傳回
  • 目前的攝影機

公開布林值 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 位置)

將 StreetViewPanorama 設為指定位置

參數
排名 所需位置的經緯度

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：如果使用者允許使用縮放手勢