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
与 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。

通过调用 const {ElevationStatus} = await google.maps.importLibrary("elevation") 进行访问。请参阅 Maps JavaScript API 中的库。
INVALID_REQUEST 请求无效。
OK 请求没有遇到任何错误。
OVER_QUERY_LIMIT 网页发出请求的频率过高，超过了最短时间限制。
REQUEST_DENIED 不允许网页使用海拔服务。
UNKNOWN_ERROR 无法成功处理提升请求，但确切的失败原因未知。