开始使用

Elevation API 提供地球表面所有位置的海拔数据,包括洋底深处位置的海拔数据(返回负值)。

此服务也可作为客户端 Maps JavaScript API 的一部分使用,也可与适用于 Google 地图服务的 Java 客户端、Python 客户端、Go 客户端和 Node.js 客户端在服务器端结合使用。

示例请求和响应

您可以通过 HTTP 接口访问 Elevation API,并以网址字符串形式构建请求,并使用纬度/经度坐标来识别位置或路径顶点。请求必须包含您的 API 密钥。

以下示例请求科罗拉多州“里高城”丹佛的海拔,采用 JSON 格式:

网址

https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034
  &key=YOUR_API_KEY

cURL

curl -L -X GET 'https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY'

您可以通过在网络浏览器中输入网址来测试此 API(请务必将 YOUR_API_KEY 替换为您的实际 API 密钥)。 响应包含该点的海拔(以米为单位)和分辨率值(通过插值计算海拔时所用数据点之间的最大距离,以米为单位)。

请查看开发者指南,详细了解如何 构建请求网址和可用参数以及如何 理解响应

以下是一个示例响应:

JSON

{
  "results":
    [
      {
        "elevation": 1608.637939453125,
        "location": { "lat": 39.7391536, "lng": -104.9847034 },
        "resolution": 4.771975994110107,
      },
    ],
  "status": "OK",
}

XML

<ElevationResponse>
 <status>OK</status>
 <result>
  <location>
   <lat>39.7391536</lat>
   <lng>-104.9847034</lng>
  </location>
  <elevation>1608.6379395</elevation>
  <resolution>4.7719760</resolution>
 </result>
</ElevationResponse>

使用客户端库编码入门指南

客户端库通过以简单、原生的方式实现身份验证、请求限制和自动重试等常见任务,简化了 Google 地图网络服务 API 的开发工作。适用于 Google 地图服务的 Java 客户端、Python 客户端、Go 客户端和 Node.js 客户端支持 Elevation API。

身份验证、配额、价格和政策

身份验证

如需使用 Elevation API,您必须先启用该 API 并获取正确的身份验证凭据。如需了解详情,请参阅 Google Maps Platform 使用入门

配额和价格

如需详细了解 Elevation API 设置的配额和价格,请查看用量和结算页面。

政策

使用 Elevation API 时,必须遵循 API 政策

了解详情

Elevation API 还有其他用途,例如请求多个位置的海拔数据。如需查看更多示例和其他详情,请参阅 Elevation API 开发者指南

Elevation API 开发者指南适用于希望在由某个 Google Maps Platform API 提供的地图中使用海拔数据的网站和移动开发者。它介绍了如何使用该 API,还提供了有关可用参数的参考资料。