Elevation API 總覽

Elevation API 服務會傳回地表位置的海拔高度資料,或路徑沿途的海拔高度取樣資料。

為什麼要使用 Elevation API

您可以使用 Elevation API 來開發應用程式,藉此支援客戶進行高度敏感活動、定位應用程式,或含有路線沿途高度和高度變化的低問卷調查應用程式。舉例來說,您可以提供海拔增減資料,以改善有關健行、騎腳踏車或水肺潛水等運動的運動應用程式。

Elevation API 的用途

您可以使用 Elevation API,在應用程式或地圖中加入海拔高度資料。例如:

  • 取得特定地點的海拔高度
  • 計算路徑沿途或兩點之間的高度差異

Elevation API 的運作方式

Elevation API 接受採編碼網址的要求,其中包含經緯度座標做為獨立位置,或路徑沿途的一系列位置。例如,此要求會查詢科羅拉多州丹佛中心的海拔高度,並以 JSON 格式指定傳回。
  https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034
  &key=YOUR_API_KEY

服務可取得所提供座標的海拔高度。此外,它也會插入沒有高度的地點高度,並從提供海拔高度資料的四個鄰近位置傳回平均值。最後,此屬性會決定位置的整體解析度。

資源

下表摘要說明透過 Elevation API 的可用資源,以及其傳回的資料。

資料資源 傳回的資料 傳回格式
經緯度座標

您可以提供一或多個地點的一組資料,也可以提供路徑沿途的序列資料。您也可以提供編碼座標。最多可傳遞 512 個座標。

Elevation API 會提供相對於本機平均海平面 (LMSL) 的海拔高度 (公尺)。高度可以採用正值或負值傳回,如下所示:

  • 正值代表 LMSL 上方的位置,包括表面位置或高海拔湖泊底部的位置。
  • 負值表示位於 LMSL 以下的位置,包括表面或洋底的位置。
  • Resolution 表示資料點與海拔高度之間的距離 (以公尺為單位)。
  • JSON
  • XML

如何使用 Elevation API

1 做好準備。 請先設定 Google Cloud 專案,然後按照指示完成設定。
2 嘗試提出海拔高度要求 取得 API 金鑰後,即可直接在瀏覽器中測試 Elevation API。詳情請參閱「開始使用」指南中的「要求範例」一節。
3 編寫更複雜的要求 設定專案後,請嘗試提出路徑沿途地點資料的要求。詳情請參閱「指定路徑
4 瞭解回應基本知識 探索海拔高度資料回應,為應用程式準備海拔高度資料。詳情請參閱「海拔高度回應」一文。
5 將海拔高度資料融入您的應用程式! 您可以使用高度資料來強化以位置資訊為基礎的應用程式,例如體育活動的應用程式或問卷調查資料。

可用的用戶端程式庫

請透過下列其中一種用戶端程式庫,以您選擇的語言呼叫這個 API:

Google 地圖服務適用的 Java、Python、Go 和 Node.js 用戶端都是社群支援的用戶端程式庫,並依據阿帕契 2.0 授權的條款提供開放原始碼。您可以從 GitHub 下載,您也可以在此找到安裝指示和程式碼範例。

後續步驟