Rendering

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

StreetViewPanorama 類別

google.maps.StreetViewPanorama 類別

顯示特定 LatLng 或全景 ID 的全景。StreetViewPanorama 物件提供街景服務「檢視者」,可獨立於 <div> 之外或與 Map 繫結。

此類別會擴充 MVCObject

使用 v=beta 時,可透過呼叫 const {StreetViewPanorama} = await google.map.importLibrary("streetView") 來存取請參閱 Maps JavaScript API 中的程式庫

StreetViewPanorama
StreetViewPanorama(container[, opts])
參數:
使用傳送的 StreetViewPanoramaOptions 建立全景。
controls
附加在全景的其他控制項。若要為控制項新增控制項,請將控制項的 <div> 加到對應應轉譯 ControlPositionMVCArray
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
傳回街景服務全景目前的 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)
參數:
  • motionTrackingboolean
傳回值:
設定動作追蹤器的狀態。當使用者實際移動裝置且瀏覽器支援 true 時,「街景服務全景」會追蹤實際動作。
setOptions
setOptions(options)
參數:
傳回值:
設定「按鍵值」對組的集合。
setPano
setPano(pano)
參數:
  • panostring
傳回值:
為「街景服務」全景設定目前的全景 ID。
setPosition
setPosition(latLng)
參數:
傳回值:
為「街景服務」全景設定目前的 LatLng 位置。
setPov
setPov(pov)
參數:
傳回值:
為「街景服務」全景設定視角。
setVisible
setVisible(flag)
參數:
  • flagboolean
傳回值:
設為 true 即可檢視全景。如果設為 false,則會隱藏全景圖,不論該地圖是嵌入地圖還是自己的 <div> 中。
setZoom
setZoom(zoom)
參數:
  • zoomnumber
傳回值:
設定全景的縮放等級。完全縮小為等級 0,其中視野為 180 度。放大會增加縮放等級。
繼承: addListenerbindTogetnotifysetsetValuesunbindunbindAll
closeclick
function(event)
引數:
  • eventEvent已觸發事件。
按一下關閉按鈕時,會引發此事件。
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
地址控制項的顯示選項。
clickToGo optional
類型:boolean optional
啟用的點按啟用/停用狀態。
controlSize optional
類型:number optional
全景上顯示的控制項大小 (以像素為單位)。建立「全景」時必須直接提供這個值,如果之後更新這個值,可能會導致控制項成為未定義的狀態。僅管理 Maps API 本身的控制項。不會擴充開發人員建立的自訂控制項。
disableDefaultUI optional
類型:boolean optional
啟用/停用所有預設使用者介面。可以個別覆寫。
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 設為 false,且 motionTrackingControl 已啟用,則動作追蹤控制項會隨即顯示,但追蹤功能為關閉狀態。使用者可以輕觸動作追蹤控制項來切換這個選項。如果將 motionTracking 設為 true 但不要求權限,但動作追蹤控制項已顯示,但追蹤功能已關閉,使用者只要輕觸動作追蹤控制項即可要求權限。如果將 motionTracking 設為 true,但使用者拒絕權限,動作追蹤控制項就會停用,但會停用追蹤功能。
motionTrackingControl optional
類型:boolean 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,全景就會顯示街道名稱。如果設為 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 介面

自訂 Pano 供應商的選項。

cors optional
類型:boolean optional
設定這個選項後,轉譯器所使用的技術 (例如 Webgl) 只有在提供的圖片上正確設定 cors 標頭時才會發揮作用。開發人員的工作就是透過此旗標來正確提供圖片,否則可能會引發 SecurityErrors。

StreetViewTileData 介面

google.maps.StreetViewTileData 介面

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

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

使用 v=beta 時,可透過呼叫 const {StreetViewCoverageLayer} = await google.map.importLibrary("streetView") 來存取請參閱 Maps JavaScript API 中的程式庫

StreetViewCoverageLayer
StreetViewCoverageLayer()
參數:
用來建立 StreetViewCoverageLayer 的新例項。
getMap
getMap()
參數:
傳回值:Map
傳回顯示這個圖層的地圖。
setMap
setMap(map)
參數:
傳回值:
在指定的地圖上呈現圖層。如果地圖設為 null,系統將會移除圖層。
繼承: addListenerbindTogetnotifysetsetValuesunbindunbindAll