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 yang dibuat sebagai string URL, menggunakan koordinat lintang/bujur untuk mengidentifikasi lokasi atau vertex jalur. Permintaan harus menyertakan kunci API Anda.
Contoh berikut meminta ketinggian 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 (pastikan untuk mengganti
YOUR_API_KEY
dengan kunci API Anda yang sebenarnya).
Respons 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 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>
Memulai pengkodean dengan pustaka klien kami
Library klien memudahkan pengembangan dengan API layanan web Google Maps dengan menyediakan implementasi native yang sederhana untuk 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 sesuai. Untuk informasi selengkapnya, lihat artikel 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
Ada banyak hal 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 API Google Maps Platform. Panduan ini memberikan pengantar tentang cara menggunakan API dan bahan referensi tentang parameter yang tersedia.