Elevation

ElevationService

google.maps.ElevationService

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

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

ElevationService
ElevationService()
参数:无
创建 ElevationService 的新实例,可向 Google 服务器发送海拔查询。
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 无法成功处理提升请求,但确切的失败原因未知。