Elevation

ElevationService

google.maps.ElevationService

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

通过调用 const {ElevationService} = await google.maps.importLibrary("elevation") 访问。请参阅 Maps JavaScript API 中的库

ElevationService
ElevationService()
参数:无
创建可将海拔查询发送到 Google 服务器的 ElevationService 新实例。
getElevationAlongPath
getElevationAlongPath(request[, callback])
参数
沿路径创建海拔请求,其中海拔数据作为基于距离的示例沿该路径传回。
getElevationForLocations
getElevationForLocations(request[, callback])
参数
针对一系列离散位置创建海拔请求。

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 无法成功处理海拔请求,但确切的失败原因未知。