Elevation

ElevationService 类

google.maps.ElevationService 类

定义可直接与 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])
参数： 
返回值：  Promise<LocationElevationResponse>
针对一系列离散位置创建海拔请求。

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 无法成功处理海拔请求，但具体失败原因未知。