開始使用

Elevation 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 Maps 網路服務 API 進行開發。Elevation API 適用於 Google 地圖服務適用的 Java 用戶端、Python 用戶端、Go 用戶端和 Node.js 用戶端。

驗證、配額、定價和政策

驗證

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

配額與定價

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

政策

使用 Elevation API 時，必須遵守 API 政策。

瞭解詳情

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

Elevation API 開發人員指南適用於網站和行動開發人員，方便他們使用其中一個 Google 地圖平台 API 所提供的地圖海拔高度資料。本文介紹如何使用 API，以及可用參數的參考資料。