Mulai

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Elevation API menyediakan data ketinggian untuk semua lokasi di permukaan bumi, termasuk lokasi kedalaman di dasar laut (yang menampilkan 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 garis 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

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

Tukang Pos

Spesifikasi OpenAPI juga tersedia sebagai koleksi Postman.

Berjalan di Postman

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

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

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 Postman

Spesifikasi OpenAPI juga tersedia sebagai koleksi Postman.

Berjalan 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 dari tugas-tugas umum, seperti autentikasi, throttling permintaan, dan percobaan ulang otomatis. Elevation API tersedia di Java Client, Python Client, Go Client, dan Node.js Client untuk Google Maps Services.

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 ketinggian dari beberapa lokasi. Lihat panduan developer Elevation API untuk contoh selengkapnya dan detail lainnya.

Panduan developer Elevation API ditujukan bagi developer situs dan seluler yang ingin menggunakan data ketinggian dalam peta yang disediakan oleh salah satu Google Maps Platform API. Bagian ini menyediakan pengantar tentang penggunaan API dan materi referensi tentang parameter yang tersedia.