Mulai

Elevation API menyediakan data elevasi untuk semua lokasi di permukaan bumi, termasuk lokasi kedalaman di dasar laut (yang mengembalikan nilai negatif).

Layanan ini juga tersedia sebagai bagian dari Maps JavaScript API sisi klien, atau untuk penggunaan sisi server dengan Klien Java, Klien Python, Klien Go, dan Klien Node.js untuk Layanan Google Maps.

Contoh permintaan dan respons

Anda mengakses Elevation API melalui antarmuka HTTP, dengan permintaan dibuat sebagai string URL, menggunakan koordinat lintang/bujur untuk mengidentifikasi lokasi atau verteks jalur. Permintaan harus menyertakan kunci API Anda.

Contoh berikut meminta elevasi untuk Denver, Colorado, "Mile High City", dalam format JSON:

URL

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

URLC

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))
}

Tukang pos

Spesifikasi OpenAPI juga tersedia sebagai koleksi Postman.

Jalankan di Postman

Anda dapat mengujinya dengan memasukkan URL ke browser web Anda (pastikan untuk mengganti YOUR_API_KEY dengan kunci API sebenarnya). Responsnya mencakup elevasi pada titik tersebut, dalam meter, bersama dengan nilai resolusi (jarak maksimum antara titik data yang digunakan untuk interpolasi elevasi, dalam meter).

Lihat panduan developer untuk mengetahui informasi selengkapnya tentang membuat URL permintaan dan parameter yang tersedia serta memahami responsnya.

Berikut adalah contoh respons:

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>

Spesifikasi OpenAPI

Spesifikasi OpenAPI dipublikasikan untuk API ini dan tersedia di GitHub.

Dapatkan Spesifikasi OpenAPI

Koleksi Tukang Pos

Spesifikasi OpenAPI juga tersedia sebagai koleksi Postman.

Jalankan di Postman

Memulai pengkodean dengan pustaka klien kami

Library klien mempermudah pengembangan dengan API layanan web Google Maps dengan menyediakan implementasi native yang sederhana dan sederhana untuk tugas-tugas umum, seperti autentikasi, throttling permintaan, dan percobaan ulang otomatis. Elevation API tersedia di Klien Java, Klien Python, Klien Go, dan Klien Node.js untuk Layanan Google Maps.

Autentikasi, kuota, harga, dan kebijakan

Autentikasi

Untuk menggunakan Elevation API, Anda harus mengaktifkan API terlebih dahulu dan mendapatkan kredensial autentikasi yang tepat. Untuk informasi selengkapnya, lihat Memulai Google Maps Platform.

Kuota dan harga

Tinjau halaman penggunaan dan penagihan untuk mengetahui detail tentang kuota dan harga yang ditetapkan untuk Elevation API.

Kebijakan

Penggunaan Elevation API harus sesuai dengan kebijakan API.

Pelajari lebih lanjut

Hal lain yang dapat Anda lakukan dengan Elevation API, seperti meminta data elevasi dari beberapa lokasi. Lihat panduan developer Elevation API untuk mengetahui contoh dan detail lainnya.

Panduan developer Elevation API ditujukan untuk developer situs dan seluler yang ingin menggunakan data elevasi dalam peta yang disediakan oleh salah satu Google Maps Platform API. Panduan ini berisi pengantar penggunaan API dan materi referensi pada parameter yang tersedia.