Elevation API 概览

Elevation API 服务可返回地球上某个位置的海拔数据,或返回路径沿线的抽样海拔数据。

使用 Elevation API 的原因

您可以使用 Elevation API 开发应用,以支持对高度敏感的活动、定位应用或低测量应用(包括路线沿途的海拔和海拔变化)。例如,您可以提供海拔增减数据,以针对徒步、骑行或水肺潜水等活动改进运动应用。

Elevation API 的用途

借助 Elevation API,您可以在应用或地图中添加海拔数据。例如:

  • 获取特定地点的海拔
  • 计算路线沿线或两点之间的海拔差异

Elevation API 的工作原理

Elevation API 接受经过编码网址的请求,该纬度/经度坐标可作为离散位置或路径沿线的一系列位置提供。例如,此请求会查询科罗拉多州丹佛市中心的海拔,并指定采用 JSON 格式的返回结果。
  https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034
  &key=YOUR_API_KEY

该服务将推导出所提供坐标的海拔。它还会计算没有海拔的位置的海拔,以提供从提供了海拔数据的四个最近位置返回的平均值。最后,它就能确定位置信息的总体分辨率

资源

下表总结了 Elevation API 提供的资源及其返回的数据。

数据资源 返回的数据 返回格式
纬度/经度坐标

您可以提供一组(一个或多个)位置的数据,也可以提供沿路径的数据系列。您还可以提供经过编码的坐标。最多可传递 512 个坐标。

Elevation API 提供相对于本地平均海平面 (LMSL) 的海拔(以米为单位)。海拔高度可以正值或负值形式返回,如下所示:

  • 正值表示 LMSL 上方的位置,包括表面位置或高海拔湖底。
  • 负值表示低于 LMSL 的位置,包括地表或洋底的位置。
  • Resolution 表示数据点与海拔之间的距离(以米为单位)。
  • JSON
  • XML

如何使用 Elevation API

1 开始设置。 设置您的 Google Cloud 项目开始,完成后续设置说明。
2 尝试请求权限 有了 API 密钥后,您就可以直接在浏览器中开始测试 Elevation API。如需了解详情,请参阅入门指南中的示例请求
3 编写更复杂的请求 设置好项目后,请尝试发出沿路径提供位置数据的请求。如需了解详情,请参阅指定路径
4 了解响应基础知识 探索海拔数据响应,为您的应用使用海拔数据做好准备。如需了解详情,请参阅海拔响应
5 将海拔数据整合到您自己的应用中! 您可以使用海拔数据来改进基于位置的应用,例如用于体育活动或问卷调查数据的应用。

可用的客户端库

请通过以下任一客户端库使用您选择的语言调用此 API:

适用于 Google 地图服务的 Java 客户端、Python 客户端、Go 客户端和 Node.js 客户端是由社区提供支持的客户端库,并且根据 Apache 2.0 许可开放源代码。从 GitHub 下载,您还可以在这里找到安装说明和示例代码。

后续步骤