ElevationService 類別
google.maps.ElevationService
class
定義可與 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]) 參數:
為不連續位置的清單提出高度要求。 |
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 |
無法成功處理地形要求,但無法得知失敗的確切原因。 |