Elevation

ElevationService 類別

google.maps.ElevationService class

定義可與 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 無法成功處理地形要求,但無法得知失敗的確切原因。