Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

Elevation

ElevationService 类

class google.maps.ElevationService
library "elevation"

定义可直接与 Google 服务器对话以请求海拔数据的服务类。

const {ElevationService} = await google.maps.importLibrary("elevation");

构造函数
`ElevationService`	`ElevationService()` 参数：无创建 `ElevationService` 的新实例，用于向 Google 服务器发送海拔查询。

方法
`getElevationAlongPath`	`getElevationAlongPath(request[, callback])` 参数： `request: PathElevationRequest` `callback: function(Array<ElevationResult> optional, ElevationStatus): void optional` 返回值：`Promise<PathElevationResponse>` 沿路径创建海拔请求，其中海拔数据作为基于距离的示例沿该路径传回。
`getElevationForLocations`	`getElevationForLocations(request[, callback])` 参数： `request: LocationElevationRequest` `callback: function(Array<ElevationResult> optional, ElevationStatus): void optional` 返回值：`Promise<LocationElevationResponse>` 针对一系列离散位置创建海拔请求。

接口 google.maps.LocationElevationRequest

由 ElevationService 发送的海拔请求，其中包含要返回海拔数据的离散坐标 (LatLng) 列表。

属性
`locations` 可选	类型：`Array<LatLng\|LatLngLiteral> optional` 要为其检索海拔的离散位置。

接口 google.maps.LocationElevationResponse

ElevationService 返回的海拔响应，其中包含与 LocationElevationRequest 的位置匹配的 ElevationResult 列表。

属性
`results`	类型：`Array<ElevationResult>` 与 `LocationElevationRequest` 的位置匹配的 `ElevationResult` 列表。

接口 google.maps.PathElevationRequest

ElevationService 发送的海拔查询，其中包含要返回抽样数据的路径。此请求定义沿地球的连续路径，沿该路径，将等距离获取海拔示例。顶点间的所有路径都使用介于这两点间的大圆线段。

属性
`samples`	类型：`number` 必需。沿指定路径的等距点数，要针对该路径检索海拔数据，包括端点。样本数必须是介于 2 到 512 之间的值（含边界值）。
`path` 可选	类型：`Array<LatLng\|LatLngLiteral> optional` 要沿其收集海拔值的路径。

接口 google.maps.PathElevationResponse

ElevationService 返回的海拔响应，其中包含沿 PathElevationRequest 路径均匀分布的 ElevationResult 列表。

属性
`results`	类型：`Array<ElevationResult>` 与 `PathElevationRequest` 的样本匹配的 `ElevationResult` 列表。

接口 google.maps.ElevationResult

ElevationService 请求的结果，由一组海拔坐标及其海拔值组成。请注意，单个请求可能会产生多个 ElevationResult。

属性
`elevation`	类型：`number` 地球上此点的海拔（以高于海平面的米数表示）。
`resolution`	类型：`number` 采用插值法计算海拔时所用采样点之间的距离（以米为单位）。如果分辨率未知，则不会显示此属性。请注意，当传递多个点时，海拔数据可能不够精确（`resolution` 值更大）。如需获取某一点最精确的海拔值，应对其进行独立查询。
`location` 可选	类型：`LatLng optional` 此海拔结果的位置。

常量 google.maps.ElevationStatus
库 "elevation"

ElevationService 在完成海拔请求后返回的状态。按值或使用常量名称指定这些值。例如 'OK' 或 google.maps.ElevationStatus.OK。

这些常量也可以用作字符串。在 TypeScript 中，字符串字面量由 ElevationStatusString 类型定义。

const {ElevationStatus} = await google.maps.importLibrary("elevation");