ElevationService class
google.maps.ElevationService
class
定義可與 Google 伺服器直接對話服務類別，以要求高度資料。
撥打 const {ElevationService} = await google.maps.importLibrary("elevation") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
建構函式 | |
|---|---|
ElevationService |
ElevationService()參數：無
建立 ElevationService 的新例項，將高度查詢傳送至 Google 伺服器。 |
方法 | |
|---|---|
getElevationAlongPath |
getElevationAlongPath(request[, callback])參數：
傳回值：
Promise<PathElevationResponse>沿著路徑提出高度要求，系統會沿著該路徑傳回以距離為基礎的高度資料。 |
getElevationForLocations |
getElevationForLocations(request[, callback])參數：
為不連續位置的清單提出高度要求。 |
LocationElevationRequest 介面
google.maps.LocationElevationRequest
介面
ElevationService 傳送的海拔高度要求，其中包含要傳回海拔高度資料的離散座標清單 (LatLng)。
屬性 | |
|---|---|
locations optional |
類型：
Array<LatLng|LatLngLiteral> optional可以擷取高度的不連續位置。 |
LocationElevationResponse 介面
google.maps.LocationElevationResponse
介面
ElevationService 傳回的海拔高度回應，其中包含與 LocationElevationRequest 地點相符的 ElevationResult 清單。
屬性 | |
|---|---|
results |
類型：
Array<ElevationResult>與 LocationElevationRequest 位置相符的 ElevationResult 清單。 |
PathElevationRequest 介面
google.maps.PathElevationRequest
介面
ElevationService 傳送的海拔高度查詢，內含要傳回取樣資料的路徑。此要求會沿著地面定義連續路徑，系統應以平均間隔的距離，沿著該連續路徑取得高度取樣。端點到端點間的所有路徑，都在這兩點間使用大圓的片段。
屬性 | |
|---|---|
samples |
類型：
number必要欄位。沿著指定路徑的等距點數量，該指定路徑可以擷取高度資料，包括終點。樣本數必須是介於 2 至 512 (含) 的值。 |
path optional |
類型：
Array<LatLng|LatLngLiteral> optional沿著該路徑可收集值的路徑。 |
PathElevationResponse 介面
google.maps.PathElevationResponse
介面
ElevationService 傳回的海拔高度回應，其中包含沿著 PathElevationRequest 路徑等距分布的 ElevationResult 清單。
屬性 | |
|---|---|
results |
類型：
Array<ElevationResult>與 PathElevationRequest 樣本相符的 ElevationResult 清單。 |
ElevationResult 介面
google.maps.ElevationResult
介面
ElevationService 要求的結果，包含一組海拔高度座標及其海拔高度值。請注意，單一要求可能會產生多個 ElevationResult。
屬性 | |
|---|---|
elevation |
類型：
number這一點在地球上的海拔高度 (單位為公尺)。 |
resolution |
類型：
number插入海拔高度的樣本點之間的距離 (以公尺為單位)。如果解析度不明，則會省略這個屬性。請注意，傳遞多個點時，海拔高度資料會變得較不精確 ( resolution 值較大)。如要取得某一點最精確的海拔高度值，請單獨予以查詢。 |
location optional |
類型：
LatLng optional這個高度結果的位置。 |
ElevationStatus 常數
google.maps.ElevationStatus
常數
提升要求完成後，ElevationService 傳回的狀態。您可以依值指定這些項目，也可以使用常數名稱。例如 'OK' 或 google.maps.ElevationStatus.OK。
撥打 const {ElevationStatus} = await google.maps.importLibrary("elevation") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
常數 | |
|---|---|
INVALID_REQUEST |
要求無效。 |
OK |
這個要求未發生任何錯誤。 |
OVER_QUERY_LIMIT |
網頁已在過短的時間內超過要求限制。 |
REQUEST_DENIED |
這個網頁禁止使用海拔高度服務。 |
UNKNOWN_ERROR |
無法順利處理高度要求，但確切原因不明。 |