Service

StreetViewService 類別

class google.maps.StreetViewService
library "streetView"

StreetViewService 物件會執行街景服務資料搜尋。

const {StreetViewService} = await google.maps.importLibrary("streetView");

建構函式
StreetViewService	StreetViewService() 參數：無 建立 StreetViewService，為街景服務中儲存的資料提供介面。

方法
getPanorama	getPanorama(request[, callback]) 參數： request: StreetViewLocationRequest|StreetViewPanoRequest callback: function(StreetViewPanoramaData optional, StreetViewStatus): void optional 傳回值： Promise<StreetViewResponse> 擷取與提供的街景服務查詢要求相符的全景 StreetViewPanoramaData。StreetViewPanoramaData 會傳遞至提供的回呼。

StreetViewStatus 常數

constants google.maps.StreetViewStatus
library "streetView"

街景服務要求完成後，StreetViewService 傳回的狀態。您可以指定值或使用常數名稱。例如 'OK' 或 google.maps.StreetViewStatus.OK。

這些常數也可以做為字串使用。在 TypeScript 中，字串常值是由 StreetViewStatusString 類型定義。

const {StreetViewStatus} = await google.maps.importLibrary("streetView");

常數
OK	要求成功。
UNKNOWN_ERROR	無法成功處理要求，但確切的失敗原因不明。
ZERO_RESULTS	找不到符合搜尋條件的全景相片。

StreetViewLocationRequest 介面

介面 google.maps.StreetViewLocationRequest

要與 getPanorama 一起傳送的街景服務要求。StreetViewLocationRequest 可讓您搜尋指定位置的街景服務全景。

屬性
location 選填	類型： LatLng|LatLngLiteral optional 指定要搜尋街景服務全景的位置。
preference 選填	類型： StreetViewPreference optional 用於進行偏好設定，指定在半徑範圍內尋找的全景：離指定位置最近的全景，或是半徑範圍內最好的全景。
radius 選填	類型： number optional 預設值： 50 設定搜尋全景的半徑 (以公尺為單位)。
source 選填	已淘汰：請改用 sources。 類型： StreetViewSource optional 預設值： StreetViewSource.DEFAULT 指定要搜尋的全景來源。舉例來說，您可以設定限制，只搜尋室外全景。
sources 選填	類型： Iterable<StreetViewSource> optional 預設值：[StreetViewSource.DEFAULT] 指定要搜尋的全景來源。舉例來說，您可以限制只搜尋室外全景。如果設定多個來源，系統會評估這些來源的交集。

StreetViewPanoRequest 介面

介面 google.maps.StreetViewPanoRequest

StreetViewPanoRequest 會與 getPanorama 搭配使用，找出指定 ID 的全景。

屬性
pano 選填	類型： string optional 指定要搜尋的全景 ID。

StreetViewResponse 介面

介面 google.maps.StreetViewResponse

StreetViewService.getPanorama 的 Promise 解析回應。

屬性
data	類型： StreetViewPanoramaData 全景的表示法。

StreetViewLocation 介面

介面 google.maps.StreetViewLocation

表示「街景服務」全景中的位置。

屬性
pano	類型： string 全景的唯一識別碼。這在單一工作階段內是穩定的，但是如果橫跨多個工作階段就會不穩定。
description 選填	類型： string optional 描述位置的本地化字串。
latLng 選填	類型： LatLng optional 全景的經緯度。
shortDescription 選填	類型： string optional 地點的簡短說明。

StreetViewPreference 常數

constants google.maps.StreetViewPreference
library "streetView"

這些選項會影響搜尋結果，偏向傳回最靠近要求位置的街景服務全景，或最有可能符合使用者需求的全景。請依值或使用常數名稱指定這些值。例如 'best' 或 google.maps.StreetViewPreference.BEST

這些常數也可以做為字串使用。在 TypeScript 中，字串常值是由 StreetViewPreferenceString 類型定義。

const {StreetViewPreference} = await google.maps.importLibrary("streetView");

常數
BEST	傳回最有可能符合使用者需求的街景服務全景。演算法會根據使用者研究和參數 (例如公認的搜尋點、圖片品質，以及與指定地點的距離)，決定最佳結果。
NEAREST	傳回與指定位置距離最短的街景服務全景。這項功能僅適用於有限的半徑範圍內。建議半徑為 1 公里以下。

StreetViewSource 常數

constants google.maps.StreetViewSource
library "streetView"

用於將街景服務搜尋範圍限制在所選來源的 ID。這些值會指定為字串。例如 'outdoor'。

這些常數也可以做為字串使用。在 TypeScript 中，字串常值是由 StreetViewSourceString 類型定義。

const {StreetViewSource} = await google.maps.importLibrary("streetView");

常數
DEFAULT	使用街景服務的預設來源，搜尋範圍不限於特定來源。
GOOGLE	將街景服務搜尋範圍限制在 Google 官方集錦。
OUTDOOR	將街景服務搜尋範圍限制在室外集錦。室內集錦不會顯示在搜尋結果中。另請注意，搜尋只會傳回可判斷為室內或室外的全景。舉例來說，系統不會傳回 PhotoSphere，因為無法判斷其位於室內或室外。

StreetViewPanoramaData 介面

介面 google.maps.StreetViewPanoramaData

使用 registerPanoProvider 定義的提供者傳回的全景表示法。

屬性
tiles	類型： StreetViewTileData 指定這個位置的自訂方塊。
copyright 選填	類型： string optional 指定這個全景的版權文字。
imageDate 選填	類型： string optional 指定這張全景圖片的拍攝年月。日期字串格式為 YYYY-MM。
links 選填	類型： Array<StreetViewLink> optional 指定相鄰全景的導覽連結。
location 選填	類型： StreetViewLocation optional 為這個位置指定位置的中繼資料。

StreetViewLink 介面

介面 google.maps.StreetViewLink

一組相鄰「街景服務」全景的參考。

屬性
description 選填	類型： string optional 描述連結的的本地化字串。
heading 選填	類型： number optional 連結的方向。
pano 選填	類型： string optional 全景的唯一識別碼。這個 ID 在單一工作階段內是穩定的，但是如果橫跨多個工作階段就會不穩定。