开始使用

海拔 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'

您可以在网络浏览器中输入相应网址来测试此功能（请务必将 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>
</pre>

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

客户端库通过提供常见任务（例如身份验证、请求限制和自动重试）的内置实现，让您能够更轻松地使用 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 开发者指南。

高程 API 开发者指南面向希望在 Google Maps Platform API 之一提供的地图中使用高程数据的网站和移动开发者。本文介绍了如何使用该 API，并提供了有关可用参数的参考资料。