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>
透過用戶端程式庫開始編寫程式碼
用戶端程式庫提供簡便的原生實作方法,例如驗證、要求調節和自動重試,讓您更輕鬆地使用 Google Maps 網路服務 API 進行開發。Google 地圖平台服務適用的 Java 用戶端、Python 用戶端、Go 用戶端和 Node.js 用戶端皆提供 Elevation API。
驗證、配額、定價和政策
驗證
如要使用 Elevation API,您必須先啟用 API 並取得適當的驗證憑證。詳情請參閱「開始使用 Google 地圖平台」一文。
配額與價格
如要進一步瞭解 Elevation API 的配額與定價,請參閱用量與計費頁面。
政策
使用 Elevation API 時,必須遵守 API 政策規定。
瞭解詳情
您可以利用 Elevation API 執行更多作業,例如要求多個位置的海拔高度資料。如要查看更多範例和其他詳細資料,請參閱 Elevation API 開發人員指南。
「 Elevation API 開發人員指南」適用於網站和行動開發人員,分別想在 Google 地圖平台 API 所提供的地圖中使用海拔高度資料。並介紹使用 API 以及參考可用參數的參考資料。