Ringkasan Elevation API

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

Alasan menggunakan Elevation API

Dengan Elevation API, Anda dapat mengembangkan aplikasi untuk mendukung pelanggan dengan aktivitas yang sensitif terhadap elevasi, aplikasi penentuan posisi, atau aplikasi dengan survei rendah yang menyertakan perubahan elevasi dan elevasi di sepanjang rute. Misalnya, Anda dapat memberikan data elevasi dan kehilangan ketinggian guna meningkatkan kualitas aplikasi olahraga untuk aktivitas seperti hiking, bersepeda, atau selam skuba.

Yang dapat Anda lakukan dengan Elevation API

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

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

Cara kerja Elevation API

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

Layanan ini mendapatkan elevasi untuk koordinat yang diberikan. Kode ini juga menginterpolasi elevasi untuk suatu lokasi tanpa elevasi, sehingga memberikan rata-rata yang ditampilkan dari empat lokasi terdekat yang menyediakan data elevasi. Akhirnya, ini menentukan resolusi keseluruhan untuk lokasi.

Referensi

Tabel berikut merangkum resource yang tersedia melalui Elevation API beserta data yang ditampilkan.

Resource data Data yang ditampilkan Format pengembalian
Koordinat lintang/bujur

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

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

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

Cara menggunakan Elevation API

1 Melakukan persiapan. Mulailah dengan Menyiapkan project Google Cloud Anda dan selesaikan petunjuk penyiapan yang mengikutinya.
2 Coba permintaan ketinggian Setelah memiliki kunci API, Anda dapat mulai menguji Elevation API langsung dari browser. Lihat Contoh permintaan dalam panduan Memulai untuk mengetahui detailnya.
3 Menulis permintaan yang lebih kompleks Setelah Anda 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 untuk aplikasi Anda. Lihat Respons elevasi untuk detailnya.
5 Gabungkan data elevasi ke dalam aplikasi Anda sendiri. Anda dapat menggunakan data elevasi untuk meningkatkan kualitas aplikasi berbasis lokasi, seperti aplikasi untuk aktivitas olahraga atau untuk 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 yang didukung komunitas, dan merupakan open source berdasarkan Lisensi Apache 2.0. Download dari GitHub, tempat Anda juga dapat menemukan petunjuk penginstalan dan kode contoh.

Langkah berikutnya