開始使用

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'

如要測試，請在網路瀏覽器中輸入網址 (請務必將 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 地圖 Web 服務 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 Maps Platform API 提供的地圖中使用海拔高度資料。其中介紹了 API 的使用方式，並提供可用參數的參考資料。