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 下载，您还可以在这里找到安装说明和示例代码。

后续步骤