![Elevation API 總覽](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/images/landing/maps-api_960.png?authuser=7&hl=zh-tw)
Elevation API 服務可傳回 ,或是對路徑沿途的海拔高度資料進行取樣。
使用 Elevation API 的好處
您可以運用 Elevation API 開發應用程式,以支援 進行高度敏感活動、定位應用程式,或進行低問卷調查的客戶 含有路線沿途高度和高度變化的應用程式。例如: 就能提供海拔增減資料,強化運動應用程式,提升運動效能,例如 像是健行、騎腳踏車或水肺潛水
Elevation API 的功能
使用 Elevation API,您就能將海拔高度資料 或地圖。例如:
- 取得特定地點的海拔高度。
- 計算路線上或二者之間的差 點。
Elevation API 的運作方式
Elevation API 接受以經緯度座標編碼網址的要求 可做為獨立位置,或以路徑沿途的一系列地點的形式提供。這個要求 例如,以 JSON 格式指定丹佛 (Denver) 中心的海拔高度查詢。https://maps.googleapis.com/maps/api/elevation/json ?locations=39.7391536%2C-104.9847034 &key=YOUR_API_KEY
服務會取得所提供座標的海拔高度。此外,這個公式也會 沒有海拔高度的地點高度,提供從四個地方傳回的平均值。 最接近提供海拔高度資料的最接近地點最後,它會決定 地點的解析度。
資源
下表摘要列出透過 Elevation API 以及其傳回的資料。
資料資源 | 傳回的資料 | 退貨格式 |
---|---|---|
經緯度座標
您可以從一或多個地點提供資料,也可以用路徑沿途的系列資料的形式提供資料。個人中心 也可以提供編碼的座標。最多可傳遞 512 個座標。 |
Elevation API 會提供以公尺為單位的高度相對的 至局部平均海平面 (LMSL)。海拔高度可視為正數傳回 或負值,方法如下:
|
|
如何使用 Elevation API
1 | 做好準備: | 首先,請設定您的 Google Cloud 專案 然後完成設定 並按照指示操作 |
2 | 嘗試提高海拔高度要求 | 取得 API 金鑰後,您可以直接透過 您的瀏覽器。請參閱要求範例 詳情請參閱入門指南。 |
3 | 撰寫較複雜的要求 | 專案設定完成後,請試試同時提供位置資料的要求 路徑。請參閱指定路徑。 。 |
4 | 瞭解回覆的基本概念 | 探索海拔高度資料回應,為您的應用程式使用海拔高度資料。詳情請見 海拔高度回應 。 |
5 | 將海拔高度資料加入自己的應用程式! | 您可以使用海拔高度資料,改善以位置資訊為基礎的應用程式,例如運動應用程式 活動或問卷調查資料 |
可用的用戶端程式庫
如要呼叫這個 API,請使用 從以下用戶端程式庫中擇一:
Google 地圖適用的 Java 用戶端、Python 用戶端、Go 用戶端和 Node.js 用戶端 服務是社群支援的用戶端程式庫,並採用 Apache 2.0 授權。 您可以從 GitHub 下載這些範例,也可以在其中找到安裝操作說明和程式碼範例。
後續步驟
- 開始使用 Elevation API:前往 設定您的 Google Cloud 專案
- 嘗試取得以路徑為基礎的海拔高度資料:前往 指定路徑
- 遵循最佳做法:前往 Web Service 最佳做法。