StreetViewService 類別
google.maps.StreetViewService
類別
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 指定要搜尋的全景來源。如此可限制只搜尋室外全景。如果設定多個來源,我們會根據這些來源的交集進行評估。 |
StreetViewPanoRequest 介面
google.maps.StreetViewPanoRequest
介面
與 getPanorama
搭配使用 StreetViewPanoRequest
,即可尋找具有指定 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 |
將街景服務搜尋範圍限制在室外集錦。搜尋結果不會包含室內集錦。請注意,搜尋只會傳回可能的全景,以判斷相片是否位於室內或室外。舉例來說,系統不會傳回 PhotoSpheres,因為系統無法確認其位於室內或室外。 |
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 在單一工作階段內是穩定的,但是如果橫跨多個工作階段就會不穩定。 |