StreetViewService 類別
google.maps.StreetViewService
class
StreetViewService 物件會執行街景服務資料搜尋作業。
請呼叫 const {StreetViewService} = await google.maps.importLibrary("streetView") 存取。請參閱「Maps JavaScript API 中的程式庫」。
建構函式 | |
|---|---|
StreetViewService |
StreetViewService()參數：無
建立 StreetViewService，為儲存在街景服務中的資料提供介面。 |
方法 | |
|---|---|
getPanorama |
getPanorama(request[, callback])參數：
傳回值：
Promise<StreetViewResponse>擷取與提供的街景服務查詢要求相符的全景 StreetViewPanoramaData。StreetViewPanoramaData 會傳遞至提供的回呼。 |
StreetViewStatus 常數
google.maps.StreetViewStatus
常數
StreetViewService 在街景服務要求完成時傳回的狀態。您可以使用值或常數名稱指定這些值。例如 'OK' 或 google.maps.StreetViewStatus.OK。
請呼叫 const {StreetViewStatus} = await google.maps.importLibrary("streetView") 存取。請參閱「Maps JavaScript API 中的程式庫」。
常數 | |
|---|---|
OK |
要求成功。 |
UNKNOWN_ERROR |
無法成功處理要求，但確切的失敗原因不明。 |
ZERO_RESULTS |
找不到符合搜尋條件的全景圖。 |
StreetViewLocationRequest 介面
google.maps.StreetViewLocationRequest
介面
要透過 getPanorama 傳送的街景服務要求。StreetViewLocationRequest 可讓您搜尋指定位置的街景服務全景。
屬性 | |
|---|---|
location optional |
類型：
LatLng|LatLngLiteral optional指定要搜尋街景服務全景的位置。 |
preference optional |
類型：
StreetViewPreference optional用於進行偏好設定，指定在半徑範圍內尋找的全景：離指定位置最近的全景，或是半徑範圍內最好的全景。 |
radius optional |
類型：
number optional預設值：
50設定半徑 (以公尺為單位)，用於搜尋全景。 |
|
類型：
StreetViewSource optional指定要搜尋的全景來源。例如，您可以限制搜尋結果只包含戶外全景。 |
sources optional |
類型：
Iterable<StreetViewSource> optional預設值：[
StreetViewSource.DEFAULT]指定要搜尋的全景來源。例如，您可以限制搜尋結果只包含戶外全景。設定多個來源時，系統會將這些來源視為交集來評估。 |
StreetViewPanoRequest 介面
google.maps.StreetViewPanoRequest
介面
StreetViewPanoRequest 與 getPanorama 搭配使用，可找出具有指定 ID 的全景圖。
屬性 | |
|---|---|
pano optional |
類型：
string optional指定要搜尋的全景 ID。 |
StreetViewResponse 介面
google.maps.StreetViewResponse
介面
回應已為 StreetViewService.getPanorama 的 Promise 解析。
屬性 | |
|---|---|
data |
全景圖的表示法。 |
StreetViewLocation 介面
google.maps.StreetViewLocation
介面
表示「街景服務」全景中的位置。
屬性 | |
|---|---|
pano |
類型：
string全景的唯一識別碼。這在單一工作階段內是穩定的，但是如果橫跨多個工作階段就會不穩定。 |
description optional |
類型：
string optional描述位置的本地化字串。 |
latLng optional |
類型：
LatLng optional全景的經緯度。 |
shortDescription optional |
類型：
string optional地點的簡短說明。 |
StreetViewPreference 常數
google.maps.StreetViewPreference
常數
這些選項會讓搜尋結果偏向傳回離要求位置最近的街景服務全景，或是最有可能是使用者想看的全景。您可以使用值或常數名稱來指定這些值。例如 'best' 或 google.maps.StreetViewPreference.BEST
請呼叫 const {StreetViewPreference} = await google.maps.importLibrary("streetView") 存取。請參閱「Maps JavaScript API 中的程式庫」。
常數 | |
|---|---|
BEST |
傳回最有可能是使用者想查看的街景服務全景。演算法會根據使用者研究和參數 (例如已辨識的興趣點、圖片品質和距離指定位置的距離)，判斷最佳結果。 |
NEAREST |
傳回與提供位置距離最短的街景服務全景。這項功能只能在有限的半徑範圍內運作。建議半徑為 1 公里以下。 |
StreetViewSource 常數
google.maps.StreetViewSource
常數
用於將街景服務搜尋限制在所選來源的 ID。這些值會以字串的形式指定。例如 'outdoor'。
請呼叫 const {StreetViewSource} = await google.maps.importLibrary("streetView") 存取。請參閱「Maps JavaScript API 中的程式庫」。
常數 | |
|---|---|
DEFAULT |
使用街景服務的預設來源，搜尋範圍不限於特定來源。 |
GOOGLE |
將街景服務搜尋範圍限制在官方 Google 集錦。 |
OUTDOOR |
將街景服務搜尋範圍限制在室外集錦。室內收藏品不會列入搜尋結果。請注意，搜尋結果只會傳回可判斷是否為室內或室外的全景圖。舉例來說，系統不會傳回 PhotoSphere，因為無法判斷該內容是在室內還是室外拍攝。 |
StreetViewPanoramaData 介面
google.maps.StreetViewPanoramaData
介面
使用 registerPanoProvider 定義的提供者傳回的全景表示法。
屬性 | |
|---|---|
tiles |
指定這個位置的自訂方塊。 |
copyright optional |
類型：
string optional指定這個全景的版權文字。 |
imageDate optional |
類型：
string optional指定此全景圖中圖像的擷取年月日。日期字串的格式為 YYYY-MM。 |
links optional |
類型：
Array<StreetViewLink> optional指定相鄰全景的導覽連結。 |
location optional |
類型：
StreetViewLocation optional為這個位置指定位置的中繼資料。 |
StreetViewLink 介面
google.maps.StreetViewLink
介面
一組相鄰「街景服務」全景的參考。
屬性 | |
|---|---|
description optional |
類型：
string optional描述連結的的本地化字串。 |
heading optional |
類型：
number optional連結的方向。 |
pano optional |
類型：
string optional全景的唯一識別碼。這個 ID 在單一工作階段內是穩定的，但是如果橫跨多個工作階段就會不穩定。 |