Elevation API 概览

Google Elevation API 是一项服务，可为以下各项返回海拔数据： 地球上的某个位置，或沿路径的采样海拔数据。

为什么要使用 Elevation API

您可以使用 Google Elevation API 开发应用，以支持 具有高度敏感性活动、定位应用或进行低测量的客户 包含海拔高度和沿路线海拔变化的应用。例如： 您可以提供海拔增益数据来增强体育应用程序对于诸如此类的活动 例如远足、骑行或水肺潜水

Elevation API 的用途

利用 Google 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 的地理位置，包括 或海底的位置。
  • 分辨率表示数据点与 高度（以米为单位）。
  • JSON
  • XML

如何使用 Elevation API

1 开始设置。 请先设置 Google Cloud 项目 并完成相关设置 按钮。
2 尝试海拔请求 有了 API 密钥后，您就可以直接从 。请参阅示例请求 如需了解详情，请参阅入门指南。
3 编写更复杂的请求 设置完项目后，请尝试请求在 路径。请参阅指定路径 了解详情。
4 了解响应基础知识 探索海拔数据响应，以便为应用使用海拔数据做好准备。请参阅 海拔响应 了解详情。
5 将海拔数据整合到您自己的应用中！ 您可以使用海拔数据改进基于位置的应用，例如体育类应用 或调查数据。

可用的客户端库

使用以下语言调用此 API： 供您选择。

适用于 Google 地图的 Java 客户端、Python 客户端、Go 客户端和 Node.js 客户端 服务是社区支持的客户端库，已按照 Apache 2.0 许可。 您可以从 GitHub 下载它们，您还可以在 GitHub 上找到安装说明和示例代码。

后续步骤