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|null為「街景服務」全景傳回目前的 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()引數：無
每次透過 setPosition() 或 setPano() 依 ID 或位置查詢全景後，就會引發此事件。 |
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 (視角) 符合裝置方向。主要適用於行動裝置。如果 motionTracking 在啟用 motionTrackingControl 的情況下設為 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全景的縮放，以數字指定。縮放 0 可提供 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設定後，轉譯器將使用技術 (例如 webgl)，該技術只有在提供的圖片上正確設定 cors 標頭時才能運作。開發人員必須負責搭配這個標記正確提供圖片，否則可能會導致 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)參數：
傳回值：無
在指定的地圖上呈現圖層。如果地圖設為 null，則會移除圖層。 |
沿用：
addListener、bindTo、get、notify、set、setValues、unbind、unbindAll
| |