開始使用

海拔高度 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 地圖平台」一文。

配額與價格

如要瞭解 Elevation API 的配額和定價，請參閱「用量與計費」頁面。

政策

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

瞭解詳情

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

高程 API 開發人員指南適用於網站和行動開發人員，他們想在 Google 地圖平台 API 提供的地圖中使用高程資料。這份文件會簡要介紹如何使用 API，並提供可用參數的參考資料。