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])参数：
针对一系列离散位置创建海拔请求。 |
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 |
海拔高度请求无法成功处理，但失败的具体原因未知。 |