StreetViewPanorama 類別
google.maps.StreetViewPanorama
類別
顯示特定 LatLng
或全景 ID 的全景。StreetViewPanorama
物件提供街景服務「檢視者」,可在獨立的 <div>
中獨立使用,或繫結至 Map
。
這個類別會擴充 MVCObject
。
呼叫 const {StreetViewPanorama} = await google.maps.importLibrary("streetView")
即可存取。請參閱 Maps JavaScript API 中的程式庫。
建構函式 | |
---|---|
StreetViewPanorama |
StreetViewPanorama(container[, opts]) 參數:
使用傳遞的 StreetViewPanoramaOptions 建立全景。 |
屬性 | |
---|---|
controls |
類型:
Array<MVCArray<HTMLElement>> |
方法 | |
---|---|
focus |
focus() 參數:無
傳回值:無
將焦點放在這個 StreetViewPanorama 。建議您搭配 visible_changed 事件使用這個方法,確保先設定 StreetViewPanorama 再顯示焦點。無法觀測的 StreetViewPanorama 無法聚焦。 |
getLinks |
getLinks() 參數:無
傳回價值:
Array<StreetViewLink> 傳回一組「街景服務」全景的導覽連結。 |
getLocation |
getLocation() 參數:無
傳回價值:
StreetViewLocation 傳回目前全景的 StreetViewLocation。 |
getMotionTracking |
getMotionTracking() 參數:無
傳回價值:
boolean 傳回動態追蹤程式的狀態。如果 true 在使用者實際移動裝置,且瀏覽器支援該裝置時,街景服務全景就會追蹤實體動作。 |
getPano |
getPano() 參數:無
傳回價值:
string 為「街景服務」全景傳回目前的全景 ID。這個 ID 只有在瀏覽器目前的工作階段中才是穩定的。 |
getPhotographerPov |
getPhotographerPov() 參數:無
傳回價值:
StreetViewPov 傳回這張全景時的攝影師標題和提案。路邊的街景服務全景也可顯示車輛的行駛方向。系統會在 pano_changed 事件之後提供這項資料。 |
getPosition |
getPosition() 參數:無
傳回價值:
LatLng 傳回街景服務全景的 LatLng 位置。 |
getPov |
getPov() 參數:無
傳回價值:
StreetViewPov 為「街景服務」全景傳回目前的視角。 |
getStatus |
getStatus() 參數:無
傳回價值:
StreetViewStatus 在完成 setPosition() 或 setPano() 要求時傳回全景。 |
getVisible |
getVisible() 參數:無
傳回價值:
boolean 如果全景顯示,則傳回 true 。不會在特定位置指定是否可以使用「街景服務」。 |
getZoom |
getZoom() 參數:無
傳回價值:
number 傳回全景的縮放等級。完全縮小為層級 0,而視野為 180 度。放大即可放大。 |
registerPanoProvider |
registerPanoProvider(provider[, opt_options]) 參數:
傳回值:無
設定讓自訂全景提供者呼叫全景變更,以載入自訂全景。 |
setLinks |
setLinks(links) 參數:
傳回值:無
設定街景服務全景的導覽連結組合。 |
setMotionTracking |
setMotionTracking(motionTracking) 參數:
傳回值:無
設定動作追蹤器的狀態。如果 true 在使用者實際移動裝置,且瀏覽器支援該裝置時,街景服務全景就會追蹤實體動作。 |
setOptions |
setOptions(options) 參數:
傳回值:無
設定「按鍵值」對組的集合。 |
setPano |
setPano(pano) 參數:
傳回值:無
為「街景服務」全景設定目前的全景 ID。 |
setPosition |
setPosition(latLng) 參數:
傳回值:無
為街景服務全景設定目前的 LatLng 位置。 |
setPov |
setPov(pov) 參數:
傳回值:無
為「街景服務」全景設定視角。 |
setVisible |
setVisible(flag) 參數:
傳回值:無
設為 true 即可顯示全景。如果設為 false ,不管是嵌入地圖或自己的 <div> ,都會隱藏全景。 |
setZoom |
setZoom(zoom) 參數:
傳回值:無
設定全景的縮放等級。完全縮小為層級 0,而視野為 180 度。放大即可放大。 |
沿用於:
addListener 、bindTo 、get 、notify 、set 、setValues 、unbind 、unbindAll |
事件 | |
---|---|
closeclick |
function(event) 引數:
按一下關閉按鈕時,會引發此事件。 |
pano_changed |
function() 引數:無
當全景的全景 ID 變更時,會引發此事件。使用者瀏覽全景或手動設定位置時,會變更全景。請注意,並非所有位置變更都會觸發 pano_changed 。 |
position_changed |
function() 引數:無
當全景位置變更時,會引發此事件。使用者瀏覽全景或手動設定位置時,位置會隨著變更。 |
pov_changed |
function() 引數:無
當全景的視角變更時,會引發此事件。當前後擺動、縮放或方向變更時,視角也會變更。 |
resize |
function() 引數:無
開發人員應在全景的 div 變更大小時觸發這個事件: google.maps.event.trigger(panorama, 'resize') 。 |
status_changed |
function() 引數:無
每次以每個 ID 或地點透過 setPosition() 或 setPano() 進行全景查詢時,會觸發此事件。 |
visible_changed |
function() 引數:無
當全景的能見度變更時,會引發此事件。將「衣夾人」拖曳至地圖上、按下關閉按鈕或呼叫 setVisible() 時,瀏覽權限會隨之變更。 |
zoom_changed |
function() 引數:無
全景的縮放等級變更時,會觸發此事件。 |
StreetViewPanoramaOptions 介面
google.maps.StreetViewPanoramaOptions
介面
定義 StreetViewPanorama
物件屬性的選項。
屬性 | |
---|---|
addressControl optional |
類型:
boolean optional 地址控制項的啟用/停用狀態。 |
addressControlOptions optional |
類型:
StreetViewAddressControlOptions optional 地址控制項的顯示選項。 |
clickToGo optional |
類型:
boolean optional 預設值:
true 啟用/停用狀態,不適用於自訂全景。 |
controlSize optional |
類型:
number optional 全景上顯示的控制項大小 (以像素為單位)。建立全景時,必須直接提供這個值,因此如果更新這個值,可能會導致控制項產生未定義的狀態。僅適用於 Maps API 本身的控制項。不會調整開發人員建立的自訂控制項。 |
disableDefaultUI optional |
類型:
boolean optional 啟用/停用所有預設 UI。可以個別覆寫。 |
disableDoubleClickZoom optional |
類型:
boolean optional 預設值:
true 啟用/停用連按兩下時進行縮放。 |
enableCloseButton optional |
類型:
boolean optional 預設值:
false 如果為 true ,系統會顯示關閉按鈕。 |
fullscreenControl optional |
類型:
boolean optional 全螢幕控制項的啟用/停用狀態。 |
fullscreenControlOptions optional |
類型:
FullscreenControlOptions optional 全螢幕控制項的顯示選項。 |
imageDateControl optional |
類型:
boolean optional 圖像擷取日期控制項的啟用/停用狀態。預設為停用。 |
linksControl optional |
類型:
boolean optional 連結控制項的啟用/停用狀態。 |
motionTracking optional |
類型:
boolean optional 是否開啟動作追蹤功能。如有動作追蹤控制項,而使用者授予權限或未授予權限,系統預設會啟用這項功能,因此 POV (視角) 會遵循裝置方向。這項變更主要適用於行動裝置。如果在啟用 motionTrackingControl 的情況下將 motionTracking 設為 false ,則動作追蹤控制項會顯示,但追蹤功能會處於停用狀態。使用者可以輕觸動作追蹤控制項來切換選項。如果將 motionTracking 設為 true ,但使用者尚未要求存取該權限,系統就會顯示動作追蹤控制項,但追蹤功能會處於關閉狀態。使用者可以輕觸動作追蹤控制項來要求權限。如果使用者將 motionTracking 設為「true 」,則當使用者拒絕授予權限時,動作追蹤控制項會顯示為停用,並停用追蹤功能。 |
motionTrackingControl optional |
類型:
boolean optional 動作追蹤控制項的啟用/停用狀態。在裝置有動作資料時預設啟用,使控制項在地圖上顯示。這項變更主要適用於行動裝置。 |
motionTrackingControlOptions optional |
類型:
MotionTrackingControlOptions optional 動作追蹤控制項的顯示選項。 |
panControl optional |
類型:
boolean optional 平移控制項的啟用/停用狀態。 |
panControlOptions optional |
類型:
PanControlOptions optional 平移控制項的顯示選項。 |
pano optional |
類型:
string optional 全景 ID,應在指定自訂全景時設定。 |
position optional |
類型:
LatLng|LatLngLiteral optional 街景服務全景的 LatLng 位置。 |
pov optional |
類型:
StreetViewPov optional 相機的方向,以全景和傾斜角度為全景。 |
scrollwheel optional |
類型:
boolean optional 預設值:
true 如果為 false ,會停用街景服務中的滾輪縮放功能。 |
showRoadLabels optional |
類型:
boolean optional 預設值:
true 在全景上顯示街道名稱。如果未指定或將這個值設為 true ,全景會顯示街道名稱。如果設為 false ,則不會顯示街道名稱。 |
visible optional |
類型:
boolean optional 如果是 true ,載入時就會顯示街景服務全景。 |
zoom optional |
類型:
number optional 全景的縮放比例,以數字表示。縮放倍率為 180 度的視野。 |
zoomControl optional |
類型:
boolean optional 縮放控制項的啟用/停用狀態。 |
zoomControlOptions optional |
類型:
ZoomControlOptions optional 縮放控制項的顯示選項。 |
StreetViewAddressControlOptions 介面
google.maps.StreetViewAddressControlOptions
介面
呈現「街景服務」地址控制項的選項。
屬性 | |
---|---|
position optional |
類型:
ControlPosition optional 位置 ID。這個 ID 是用來指定地圖上控制項的位置。預設位置為 TOP_LEFT 。 |
PanoProviderOptions 介面
google.maps.PanoProviderOptions
介面
自訂全景提供者的選項。
屬性 | |
---|---|
cors optional |
類型:
boolean optional 設定後,只有在轉譯器將圖片正確設為 cor 標頭時,轉譯器才會使用 Webgl 等技術。開發人員的任務是搭配該標記來正確提供圖片,否則可能會導致 SecurityErrors。 |
StreetViewTileData 介面
google.maps.StreetViewTileData
介面
「街景服務」全景中使用的方塊集屬性。
屬性 | |
---|---|
centerHeading |
類型:
number 全景地圖方塊中心點的方向 (以度數為單位)。 |
tileSize |
類型:
Size 方塊呈現的大小 (單位為像素)。 |
worldSize |
類型:
Size 完整全景「世界」的大小 (單位為像素)。 |
方法 | |
---|---|
getTileUrl |
getTileUrl(pano, tileZoom, tileX, tileY) 參數:
傳回價值:
string 為指定的方塊取得方塊影像網址。 您必須導入這個自訂方法以提供自訂圖塊。API 呼叫此方法,並提供以下參數: pano 是街景服務圖塊的全景 ID。tileZoom 是資訊方塊的縮放等級。tileX 是資訊方塊的 x 座標。tileY 是資訊方塊的 y 座標。自訂方法必須傳回圖塊圖片的網址。 |
StreetViewPov 介面
google.maps.StreetViewPov
介面
指定相機在「街景服務」全景位置方向的視角物件。視角具有標題和音調。
屬性 | |
---|---|
heading |
類型:
number 相機方向為相對於 true 北角。正北為 0°,正東為 90°,正南為 180°,正西為 270°。 |
pitch |
類型:
number 相機的前後擺動角度是相對於「街景服務」拍攝車計算。範圍從 90° (直接朝上) 到 -90° (直接朝下)。 |
StreetViewCoverageLayer 類別
google.maps.StreetViewCoverageLayer
類別
說明街景服務提供地點的圖層。
這個類別會擴充 MVCObject
。
呼叫 const {StreetViewCoverageLayer} = await google.maps.importLibrary("streetView")
即可存取。請參閱 Maps JavaScript API 中的程式庫。
建構函式 | |
---|---|
StreetViewCoverageLayer |
StreetViewCoverageLayer() 參數:無
用來建立 StreetViewCoverageLayer 的新例項。 |
方法 | |
---|---|
getMap |
getMap() 參數:無
傳回價值:
Map|null 傳回顯示這個圖層的地圖。 |
setMap |
setMap(map) 參數:
傳回值:無
在指定的地圖上呈現圖層。如果地圖設為空值,系統就會移除圖層。 |
沿用於:
addListener 、bindTo 、get 、notify 、set 、setValues 、unbind 、unbindAll |