Rendering

StreetViewPanorama 類別

class google.maps.StreetViewPanorama extends MVCObject
library "streetView"

顯示指定 LatLng 或全景 ID 的全景。StreetViewPanorama 物件提供街景服務「檢視器」,可獨立存在於個別的 <div> 中,或繫結至 Map。

const {StreetViewPanorama} = await google.maps.importLibrary("streetView");
StreetViewPanorama
StreetViewPanorama(container[, opts])
參數:
使用傳遞的 StreetViewPanoramaOptions 建立全景。
controls
附加在全景的其他控制項。如要在全景中加入控制項,請將控制項的 <div> 新增至 MVCArray,並對應至應算繪的 ControlPosition。
focus
focus()
參數:無
傳回值:無
將焦點設為這個 StreetViewPanorama。建議您搭配 visible_changed 事件使用這個方法,確保 StreetViewPanorama 顯示後再設定焦點。無法聚焦於不可見的 StreetViewPanorama。
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])
參數:
傳回值:無
設定讓自訂全景提供者呼叫全景變更,以載入自訂全景。
setMotionTracking
setMotionTracking(motionTracking)
參數:
  • motionTracking: boolean
傳回值:無
設定動作追蹤器的狀態。如果 true,當使用者實際移動裝置且瀏覽器支援時,街景服務全景會追蹤實際移動。
setOptions
setOptions(options)
參數:
傳回值:無
設定「按鍵值」對組的集合。
setPano
setPano(pano)
參數:
  • pano: string
傳回值:無
為「街景服務」全景設定目前的全景 ID。
setPosition
setPosition(latLng)
參數:
傳回值:無
設定街景服務全景目前的 LatLng 位置。
setPov
setPov(pov)
參數:
傳回值:無
為「街景服務」全景設定視角。
setVisible
setVisible(flag)
參數:
  • flag: boolean
傳回值:無
設為 true 即可顯示全景。如果設為 false,無論全景是嵌入地圖或位於自己的 <div> 中,都會隱藏。
setZoom
setZoom(zoom)
參數:
  • zoom: number
傳回值:無
設定全景的縮放等級。完全縮小時為等級 0,視野為 180 度。放大會提高縮放等級。
繼承: addListener、bindTo、get、notify、set、setValues、unbind、unbindAll
closeclick
function(event)
引數:
  • event: Event optional事件已觸發。
按一下關閉按鈕時,會引發此事件。
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
選填
類型: boolean optional
地址控制項的啟用/停用狀態。
addressControlOptions
選填
地址控制項的顯示選項。
clickToGo
選填
類型: boolean optional
預設值: true
點擊前往功能的啟用/停用狀態。不適用於自訂全景。
controlSize
選填
類型: number optional
全景上顯示的控制項大小 (以像素為單位)。建立 Panorama 時,必須直接提供這個值,日後更新這個值可能會導致控制項進入未定義狀態。僅控管 Maps API 本身提供的控制項。不會縮放開發人員建立的自訂控制項。
disableDefaultUI
選填
類型: boolean optional
啟用/停用所有預設 UI。可以個別覆寫。
disableDoubleClickZoom
選填
類型: boolean optional
預設值: true
啟用/停用連按兩下時進行縮放。
enableCloseButton
選填
類型: boolean optional
預設值: false
如果為 true,系統會顯示關閉按鈕。
fullscreenControl
選填
類型: boolean optional
全螢幕控制項的啟用/停用狀態。
fullscreenControlOptions
選填
類型: FullscreenControlOptions optional
全螢幕控制項的顯示選項。
imageDateControl
選填
類型: boolean optional
圖像取得日期控制項的啟用/停用狀態。預設為停用。
linksControl
選填
類型: boolean optional
連結控制項的啟用/停用狀態。
motionTracking
選填
類型: boolean optional
動作追蹤功能是否開啟。如果動作追蹤控制項存在,且使用者已授予權限或不需要權限,則預設為啟用,因此 POV (視角) 會隨著裝置的方向移動。這項功能主要適用於行動裝置。如果 motionTracking 設為 false,且 motionTrackingControl 已啟用,系統會顯示動作追蹤控制項,但追蹤功能會關閉。使用者可以輕觸動作追蹤控制項來切換這個選項。如果 motionTracking 設為 true,且需要權限但尚未要求,系統會顯示動作追蹤控制項,但追蹤功能會關閉。使用者可以輕觸動作追蹤控制項來要求權限。如果 motionTracking 設為 true,但使用者拒絕授予權限,動作追蹤控制項會顯示為停用,且追蹤功能會關閉。
motionTrackingControl
選填
類型: boolean optional
動作追蹤控制項的啟用/停用狀態。如果裝置有動作資料,系統預設會啟用這項功能,讓控制項顯示在地圖上。這項功能主要適用於行動裝置。
motionTrackingControlOptions
選填
類型: MotionTrackingControlOptions optional
動作追蹤控制項的顯示選項。
panControl
選填
類型: boolean optional
平移控制項的啟用/停用狀態。
panControlOptions
選填
類型: PanControlOptions optional
平移控制項的顯示選項。
pano
選填
類型: string optional
全景 ID,應在指定自訂全景時設定。
position
選填
類型: LatLng|LatLngLiteral optional
街景服務全景的 LatLng 位置。
pov
選填
類型: StreetViewPov optional
全景的攝影機方向,以航向和俯仰角指定。
scrollwheel
選填
類型: boolean optional
預設值: true
如果設為 false,則會停用街景服務中的滾輪縮放功能。
showRoadLabels
選填
類型: boolean optional
預設值: true
全景圖中的街道名稱顯示方式。如未指定這個值,或設為 true,全景圖片就會顯示街道名稱。如果設為 false,則不會顯示街道名稱。
visible
選填
類型: boolean optional
如果為 true,則載入時會顯示街景服務全景。
zoom
選填
類型: number optional
全景的縮放比例,以數字指定。縮放等級為 0 時,視野為 180 度。
zoomControl
選填
類型: boolean optional
縮放控制項的啟用/停用狀態。
zoomControlOptions
選填
類型: ZoomControlOptions optional
縮放控制項的顯示選項。

StreetViewAddressControlOptions 介面

介面 google.maps.StreetViewAddressControlOptions

呈現「街景服務」地址控制項的選項。

position
選填
類型: ControlPosition optional
位置 ID。這個 ID 是用來指定地圖上控制項的位置。預設位置為 TOP_LEFT。

PanoProviderOptions 介面

介面 google.maps.PanoProviderOptions

自訂全景供應商的選項。

cors
選填
類型: boolean optional
如果設定,轉譯器會使用僅在提供的圖片上適當設定 cors 標頭時,才能運作的技術 (例如 webgl)。開發人員必須搭配這個標記正確提供圖片,否則可能會導致 SecurityError。

StreetViewTileData 介面

介面 google.maps.StreetViewTileData

「街景服務」全景中使用的方塊集屬性。

centerHeading
類型: number
全景地圖方塊中心點的方向 (以度數為單位)。
tileSize
類型: Size
方塊呈現的大小 (單位為像素)。
worldSize
類型: Size
完整全景「世界」的大小 (單位為像素)。
getTileUrl
getTileUrl(pano, tileZoom, tileX, tileY)
參數:
  • pano: string
  • tileZoom: number
  • tileX: number
  • tileY: number
傳回值: 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 類別

class google.maps.StreetViewCoverageLayer extends MVCObject
library "streetView"

顯示街景服務涵蓋地點的圖層。

const {StreetViewCoverageLayer} = await google.maps.importLibrary("streetView");
StreetViewCoverageLayer
StreetViewCoverageLayer()
參數:無
用來建立 StreetViewCoverageLayer 的新例項。
getMap
getMap()
參數:無
傳回值: Map|null
傳回顯示這個圖層的地圖。
setMap
setMap(map)
參數:
  • map: Map optional
傳回值: undefined
在指定的地圖上呈現圖層。如果地圖設為空值,系統會移除圖層。
繼承: addListener、bindTo、get、notify、set、setValues、unbind、unbindAll