Elevation

ElevationService 類別

google.maps.ElevationService 類別

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

呼叫 const {ElevationService} = await google.maps.importLibrary("elevation") 即可存取。請參閱 Maps JavaScript API 中的程式庫

ElevationService
ElevationService()
參數:
建立 ElevationService 的新執行個體,將高度查詢傳送至 Google 伺服器。
getElevationAlongPath
getElevationAlongPath(request[, callback])
參數: 
沿著路徑提出高度要求,系統會沿著該路徑傳回以距離為基礎的高度資料。
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 傳回的高度回應,包含 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 無法成功處理海拔高度要求,但確切的失敗原因不明。