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 的位置，包括途徑或海平面上的地點。
  • 解析代表資料點與海拔高度之間的距離，單位為公尺。
  • JSON
  • XML

如何使用 Elevation API

1 開始設定。 先從設定您的 Google Cloud 專案並完成後續的設定操作說明。
2 嘗試提出海拔高度要求 取得 API 金鑰後，您就可以直接在瀏覽器中測試 Elevation API。詳情請參閱入門指南中的要求範例。
3 撰寫更複雜的要求 專案設定完成後，請試試在要求中提供位置資料的要求。詳情請參閱指定路徑 。
4 瞭解回應的基本概念 探索海拔高度資料回應，準備讓您的應用程式使用海拔高度資料。詳情請參閱海拔高度回應。
5 將海拔高度資料整合至您自己的應用程式！ 您可以使用海拔高度資料強化以位置為基礎的應用程式，例如用於運動活動或問卷調查資料的應用程式。

可用的用戶端程式庫

您可以透過下列任一用戶端程式庫，用您選擇的語言呼叫這個 API：

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

後續步驟