Google 地圖平台即將推出新版地圖樣式。新版地圖樣式內建全新的預設調色盤，並且提升地圖體驗、改善服務的可用性。所有地圖樣式都將於 2025 年 3 月自動更新。請參閱「Google 地圖平台新版地圖樣式」一文，進一步瞭解適用範圍及如何提早啟用。

本頁面由 Cloud Translation API 翻譯而成。

Rendering

StreetViewPanorama 類別

google.maps.StreetViewPanorama 類別

為指定的 LatLng 或全景 ID 顯示全景。StreetViewPanorama 物件提供街景服務「檢視器」此物件可在獨立的 <div> 中單獨使用，或繫結至 Map。

這個類別 MVCObject。

呼叫 const {StreetViewPanorama} = await google.maps.importLibrary("streetView") 即可存取。請參閱 Maps JavaScript API 中的程式庫。

建構函式
`StreetViewPanorama`	`StreetViewPanorama(container[, opts])` 參數： `container`：`HTMLElement` `opts`：`StreetViewPanoramaOptions optional` 以傳遞的 `StreetViewPanoramaOptions` 建立全景。

屬性
`controls`	類型： `Array<MVCArray<HTMLElement>>` 附加在全景的其他控制項。如要新增控制項至全景，請將控制項的 `<div>` 新增至與 `ControlPosition` 相對應的 `MVCArray`，後者的應算繪位置。

方法
`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])` 參數： `provider`：`function(string): (StreetViewPanoramaData optional)` `opt_options`：`PanoProviderOptions optional` 傳回值：無設定讓自訂全景提供者呼叫全景變更，以載入自訂全景。
`setLinks`	`setLinks(links)` 參數： `links`：`Array<StreetViewLink>` 傳回值：無設定街景服務全景的導覽連結組合。
`setMotionTracking`	`setMotionTracking(motionTracking)` 參數： `motionTracking`：`boolean` 傳回值：無設定動作追蹤器的狀態。當使用者實際移動裝置且瀏覽器支援 `true` 時，街景服務全景模式會追蹤實際移動。
`setOptions`	`setOptions(options)` 參數： `options`：`StreetViewPanoramaOptions optional` 傳回值：無設定「按鍵值」對組的集合。
`setPano`	`setPano(pano)` 參數： `pano`：`string` 傳回值：無為「街景服務」全景設定目前的全景 ID。
`setPosition`	`setPosition(latLng)` 參數： `latLng`：`LatLng\|LatLngLiteral optional` 傳回值：無為街景服務全景設定目前的 `LatLng` 位置。
`setPov`	`setPov(pov)` 參數： `pov`：`StreetViewPov` 傳回值：無為「街景服務」全景設定視角。
`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` 觸發的事件。按一下關閉按鈕時，會引發此事件。
`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 (視角) 遵循裝置方向。這項功能主要適用於行動裝置。如果啟用 `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` 全景的縮放，以數字表示。縮放至 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)` 參數： `pano`：`string` `tileZoom`：`number` `tileX`：`number` `tileY`：`number` 傳回值： `string` 為指定的方塊取得方塊影像網址。您必須實作這個自訂方法，才能提供自訂圖塊。API 會呼叫這個方法，並提供下列參數： `pano` 是街景服務圖塊的全景 ID。 `tileZoom` 是方塊的縮放等級。 `tileX` 是圖塊的 X 座標。 `tileY` 是圖塊的 y 座標。您的自訂方法必須傳回圖塊圖片的網址。

方法

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 類別

google.maps.StreetViewCoverageLayer 類別

此圖層說明提供街景服務的地點。