Elevation

ElevationService 類別

google.maps.ElevationService 類別

定義可與 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])
參數： 
傳回值：  Promise<LocationElevationResponse>
為不連續位置的清單提出高度要求。

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 傳回的高度回應，包含 ElevationResult 清單在 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 無法成功處理海拔高度要求，但確切的失敗原因不明。