開始使用

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

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

這項服務也可在用戶端 Maps JavaScript API 中運用,或是與 Google 地圖服務中的 Java 用戶端、Python 用戶端、Go 用戶端和 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 金鑰)。回應會包括該點的高度 (以公尺為單位),以及解析度值 (插入內海拔高度的資料點的最大距離,以公尺為單位)。

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

以下是回應範例:

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 網路服務 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 地圖平台 API 所提供地圖中呈現高度資料的網站和行動開發人員。這些 API 會介紹如何使用 API,以及可用參數的參考資料。