開始使用

海拔高度 API 可為地表上的任何位置提供海拔高度資料，洋底深層位置也包含在內 (以負值表示)。

這項服務也可用於用戶端 Maps JavaScript API，或是搭配 Google 地圖服務適用的 Java 用戶端、Python 用戶端、Go 用戶端和 Node.js 用戶端，用於伺服器端。

要求和回應範例

您可以透過 HTTP 介面存取 Elevation API，要求會以網址字串建構，並使用經緯度座標來識別位置或路徑頂點。要求必須包含 API 金鑰。

以下範例以 JSON 格式要求科羅拉多州丹佛市 (「Mile High City」) 的海拔高度：

網址

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>

開始使用用戶端程式庫編寫程式

用戶端程式庫可提供簡單的原生實作，讓您輕鬆使用 Google 地圖網路服務 API 進行開發，例如驗證、要求節流和自動重試。Elevation API 適用於 Google 地圖服務適用的 Java 用戶端、Python 用戶端、Go 用戶端和 Node.js 用戶端。

驗證、配額、定價和政策

驗證

如要使用 Elevation API，您必須先啟用 API，並取得適當的驗證憑證。詳情請參閱「開始使用 Google 地圖平台」一文。

配額和定價

請參閱「用量與計費」頁面，進一步瞭解 Elevation API 的配額和價格設定。

政策

使用海拔高度 API 時，必須遵守 API 政策。

瞭解詳情

您可以使用 Elevation API 執行更多操作，例如要求多個位置的海拔高度資料。如需更多範例和其他詳細資訊，請參閱 Elevation API 開發人員指南。

Elevation API 開發人員指南適用於網站和行動應用程式開發人員，他們希望在 Google 地圖平台 API 提供的地圖中使用標高資料。這篇文章將介紹如何使用 API，並提供可用參數的參考資料。