Elevation

ElevationService 類別

google.maps.ElevationService 類別

定義可與 Google 伺服器直接對話服務類別，以要求高度資料。
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
符合 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
符合 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
INVALID_REQUEST 要求無效。
OK 這個要求未發生任何錯誤。
OVER_QUERY_LIMIT 網頁已在過短的時間內超過要求限制。
REQUEST_DENIED 不允許這個網頁使用海拔高度服務。
UNKNOWN_ERROR 無法成功處理海拔高度要求，但確切的失敗原因不明。