Elevation API 總覽

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)。海拔高度可視為正數傳回 或負值，方法如下：

  • 正值表示學習管理系統 (LMS) 以上的位置。 包括表面位置或高海拔湖泊的底部
  • 負值表示低於 LMSL 的位置，包括 放在平面或洋底上的位置
  • Resolution 會指出資料點與 以公尺為單位
  • JSON
  • XML

如何使用 Elevation API

1 做好準備： 首先，請設定您的 Google Cloud 專案 然後完成設定 並按照指示操作
2 嘗試提高海拔高度要求 取得 API 金鑰後，您可以直接透過 您的瀏覽器。請參閱要求範例 詳情請參閱入門指南。
3 撰寫較複雜的要求 專案設定完成後，請試試同時提供位置資料的要求 路徑。請參閱指定路徑。 。
4 瞭解回覆的基本概念 探索海拔高度資料回應，為您的應用程式使用海拔高度資料。詳情請見 海拔高度回應 。
5 將海拔高度資料加入自己的應用程式！ 您可以使用海拔高度資料，改善以位置資訊為基礎的應用程式，例如運動應用程式 活動或問卷調查資料

可用的用戶端程式庫

如要呼叫這個 API，請使用 從以下用戶端程式庫中擇一：

Google 地圖適用的 Java 用戶端、Python 用戶端、Go 用戶端和 Node.js 用戶端 服務是社群支援的用戶端程式庫，並採用 Apache 2.0 授權。 您可以從 GitHub 下載這些範例，也可以在其中找到安裝操作說明和程式碼範例。

後續步驟