Ringkasan Elevation API

Elevation API adalah layanan yang menampilkan data elevasi untuk lokasi di bumi, atau mengambil sampel data elevasi sepanjang jalur.

Alasan menggunakan Elevation API

Dengan Elevation API, Anda dapat mengembangkan aplikasi untuk mendukung pelanggan yang memiliki aktivitas sensitif ketinggian, aplikasi pemosisian, atau aplikasi dengan survei rendah yang menyertakan perubahan elevasi dan elevasi sepanjang rute. Misalnya, Anda dapat memberikan data elevasi dan penurunan elevasi guna meningkatkan kualitas aplikasi olahraga untuk aktivitas seperti mendaki, bersepeda, atau selam skuba.

Yang dapat Anda lakukan dengan Elevation API

Dengan Elevation API, Anda dapat menyertakan data elevasi dalam aplikasi atau peta. Contoh:

  • Mendapatkan elevasi untuk tempat tertentu.
  • Hitung perbedaan ketinggian di sepanjang rute atau antara dua titik.

Cara kerja Elevation API

Elevation API menerima permintaan sebagai URL berenkode dengan koordinat lintang/bujur yang diberikan sebagai lokasi terpisah, atau sebagai serangkaian lokasi di sepanjang jalur. Permintaan ini, misalnya, elevasi kueri untuk pusat Denver, Colorado, menentukan pengembalian dalam format JSON. 
  https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034
  &key=YOUR_API_KEY

Layanan memperoleh ketinggian untuk koordinat yang disediakan. Ini juga melakukan interpolasi untuk lokasi tanpa elevasi, yang memberikan rata-rata yang ditampilkan dari empat lokasi terdekat yang menyediakan data elevasi. Terakhir, ini menentukan resolusi keseluruhan untuk lokasi.

Resource

Tabel berikut merangkum resource yang tersedia melalui Elevation API bersama dengan data yang ditampilkannya.

Resource data Data yang ditampilkan Format pengembalian
Koordinat garis lintang/garis bujur

Anda dapat memberikan data sebagai kumpulan satu atau beberapa lokasi, atau sebagai rangkaian di sepanjang jalur. Anda juga dapat memberikan koordinat yang dienkode. Meneruskan hingga 512 koordinat.

Elevation API menyediakan ketinggian dalam meter relatif terhadap permukaan laut rata-rata lokal (LMSL). Elevasi dapat dikembalikan sebagai nilai positif atau negatif seperti yang ditunjukkan di bawah:

  • Nilai positif menunjukkan lokasi di atas LMSL, termasuk lokasi permukaan atau bagian bawah danau dataran tinggi.
  • Nilai negatif menunjukkan lokasi yang berada di bawah LMSL, termasuk lokasi di permukaan atau dasar laut.
  • Resolution menunjukkan jarak antara titik data dan elevasi, dalam meter.
  • JSON
  • XML

Cara menggunakan Elevation API

1 Mulai penyiapan. Mulai dengan Menyiapkan project Google Cloud dan menyelesaikan petunjuk penyiapan yang mengikuti.
2 Mencoba permintaan elevasi Setelah memiliki kunci API, Anda dapat mulai menguji Elevation API langsung dari browser. Lihat Contoh permintaan di panduan Memulai untuk mengetahui detailnya.
3 Menulis permintaan yang lebih kompleks Setelah menyiapkan project, coba permintaan yang menyediakan data lokasi di sepanjang jalur. Lihat Menentukan jalur untuk mengetahui detailnya.
4 Memahami dasar-dasar respons Pelajari respons data elevasi untuk mempersiapkan penggunaan data elevasi bagi aplikasi Anda. Lihat Respons ketinggian untuk mengetahui detailnya.
5 Sertakan data elevasi ke dalam aplikasi Anda sendiri. Anda dapat menggunakan data elevasi untuk meningkatkan kualitas aplikasi berbasis lokasi, seperti aplikasi untuk aktivitas olahraga atau data survei.

Library klien yang tersedia

Panggil API ini dalam bahasa pilihan Anda melalui salah satu library klien berikut:

Klien Java, Klien Python, Klien Go, dan Klien Node.js untuk Layanan Google Maps adalah library klien open source yang didukung komunitas berdasarkan Lisensi Apache 2.0. Download aplikasi dari GitHub, tempat Anda juga dapat menemukan petunjuk penginstalan dan kode contoh.

Langkah berikutnya