Mulai

Elevation API menyediakan data elevasi untuk semua lokasi di permukaan bumi, termasuk lokasi kedalaman di dasar samudra (yang akan 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 dapat mengakses Elevation API melalui antarmuka HTTP, dengan permintaan yang 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

cURL

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

Anda dapat mengujinya dengan memasukkan URL ke browser web Anda (pastikan untuk mengganti YOUR_API_KEY dengan kunci API Anda yang sebenarnya). Respons ini mencakup elevasi pada titik tersebut, dalam meter, beserta 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>

Memulai pengkodean dengan pustaka klien kami

Library klien mempermudah pengembangan dengan API layanan web Google Maps dengan menyediakan implementasi tugas umum yang sederhana dan native, 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

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

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