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 下载这些文件，也可以在其中找到安装说明和示例代码。

后续步骤