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