Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

Elevation

ElevationService 類別

google.maps.ElevationService class
library "elevation"

定義可與 Google 伺服器直接對話服務類別，以要求高度資料。

const {ElevationService} = await google.maps.importLibrary("elevation");

建構函式
`ElevationService`	`ElevationService()` 參數：無建立新的 `ElevationService` 執行個體，將海拔高度查詢傳送至 Google 伺服器。

方法
`getElevationAlongPath`	`getElevationAlongPath(request[, callback])` 參數： `request`：`PathElevationRequest` `callback`：`function(Array<ElevationResult> optional, ElevationStatus): void optional` 傳回值： `Promise<PathElevationResponse>` 沿著路徑提出高度要求，系統會沿著該路徑傳回以距離為基礎的高度資料。
`getElevationForLocations`	`getElevationForLocations(request[, callback])` 參數： `request`：`LocationElevationRequest` `callback`：`function(Array<ElevationResult> optional, ElevationStatus): void optional` 傳回值： `Promise<LocationElevationResponse>` 為不連續位置的清單提出高度要求。

google.maps.LocationElevationRequest 介面

ElevationService 傳送的海拔高度要求，其中包含要傳回海拔高度資料的離散座標 (LatLng) 清單。

屬性
`locations` 選填	類型： `Array<LatLng\|LatLngLiteral> optional` 可以擷取高度的不連續位置。

google.maps.LocationElevationResponse 介面

ElevationService 傳回的海拔高度回應，其中包含與 LocationElevationRequest 位置相符的 ElevationResult 清單。

屬性
`results`	類型： `Array<ElevationResult>` 與 `LocationElevationRequest` 位置相符的 `ElevationResult` 清單。

google.maps.PathElevationRequest 介面

由 ElevationService 傳送的海拔高度查詢，其中包含要傳回樣本資料的路徑。此要求會沿著地面定義連續路徑，系統應以平均間隔的距離，沿著該連續路徑取得高度取樣。端點到端點間的所有路徑，都在這兩點間使用大圓的片段。

屬性
`samples`	類型： `number` 必填。沿著指定路徑的等距點數量，該指定路徑可以擷取高度資料，包括終點。樣本數必須介於 2 至 512 之間 (含)。
`path` 選填	類型： `Array<LatLng\|LatLngLiteral> optional` 沿著該路徑可收集值的路徑。

google.maps.PathElevationResponse 介面

ElevationService 傳回的海拔高度回應，其中包含沿著 PathElevationRequest 路徑等距分布的 ElevationResult 清單。

屬性
`results`	類型： `Array<ElevationResult>` 與 `PathElevationRequest` 樣本相符的 `ElevationResult` 清單。

google.maps.ElevationResult 介面

ElevationService 要求的結果，包含一組海拔高度座標和其海拔高度值。請注意，單一要求可能會產生多個 ElevationResult。

屬性
`elevation`	類型： `number` 這一點在地球上的海拔高度 (單位為公尺)。
`resolution`	類型： `number` 插入海拔高度的取樣點之間的距離 (以公尺為單位)。如果解析度不明，則會省略這個屬性。請注意，傳遞多個點時，海拔高度資料會變得較不精確 (`resolution` 值較大)。如要取得某一點最精確的海拔高度值，請單獨予以查詢。
`location` 選填	類型： `LatLng optional` 這個高度結果的位置。

google.maps.ElevationStatus constants
程式庫"elevation"

ElevationService 在完成海拔高度要求後傳回的狀態。請依值或使用常數名稱指定這些值。例如 'OK' 或 google.maps.ElevationStatus.OK。

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

const {ElevationStatus} = await google.maps.importLibrary("elevation");