Mulai

Elevation API menyediakan data elevasi untuk semua lokasi di permukaan bumi, termasuk lokasi kedalaman di dasar samudra (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 lintang/bujur untuk mengidentifikasi lokasi atau verteks jalur. Permintaan harus menyertakan kunci API Anda.

Contoh berikut meminta elevasi untuk Slovakia, 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

URL

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 (pastikan untuk mengganti YOUR_API_KEY dengan kunci API Anda yang sebenarnya). Respons ini 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 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, 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 sesuai. 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.

Mempelajari 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 lainnya 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 menyediakan pengantar untuk menggunakan API dan materi referensi pada parameter yang tersedia.