開始使用

Elevation API 可為地球表面的所有位置提供海拔高度資料，包括海底 (深度傳回負值) 的深度位置。

這項服務也可做為用戶端 Maps JavaScript API 的一部分使用，或是與 Google Maps Service 的 Java Client、Python Client、Go Client 和 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'

JavaScript

var axios = require('axios');

var config = {
  method: 'get',
  url: 'https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY',
  headers: { }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Python

import requests

url = "https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY"

payload={}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

Java

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
  .url("https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY")
  .method("GET", body)
  .build();
Response response = client.newCall(request).execute();

Ruby

require "uri"
require "net/http"

url = URI("https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)

response = https.request(request)
puts response.read_body

Go

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536,-104.9847034&key=YOUR_API_KEY"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

郵報

OpenAPI 規格也提供 Postman 集合。

在 Postman 中執行

如要測試，請在網路瀏覽器中輸入網址 (請務必將 YOUR_API_KEY 替換成實際的 API 金鑰)。{0}

如需進一步瞭解建構要求網址與可用參數以及瞭解回應的方式，請參閱開發人員指南。

以下是回應範例：

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>

OpenAPI 規格

這個 API 已發布 OpenAPI 規範，並可透過 GitHub 取得。

取得 OpenAPI 規格

郵報收藏

OpenAPI 規格也提供 Postman 集合。

在 Postman 中執行

使用我們的用戶端程式庫進行程式設計

用戶端程式庫會提供簡單的驗證工作 (例如驗證、要求節流和自動重試)，讓您使用 Google Maps Web Service API 更輕鬆地進行開發。Elevation API 適用於 Google 地圖服務適用的 Java 用戶端、Python 用戶端、Go 用戶端和 Node.js 用戶端。

驗證、配額、定價與政策

驗證

如要使用 Elevation API，您必須先啟用 API 並取得適當的驗證憑證。如想進一步瞭解相關詳情，請參閱「開始使用 Google 地圖平台」一文。

配額和價格資訊

請參閱用量與計費頁面，進一步瞭解 Elevation API 設定的配額和定價資訊。

政策

使用 Elevation API 時，必須遵守 API 政策。

瞭解詳情

您可以利用 Elevation API 執行更多操作，例如要求多個地點的海拔高度資料。如需更多範例和其他詳細資料，請參閱 Elevation API 開發人員指南。

Elevation API 開發人員指南旨在協助網站和行動開發人員 在其中一個 Google Maps Platform API 提供的地圖中使用海拔高度資料。本文介紹如何使用 API 和可用參數的參考資料。