Ringkasan Elevation API

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

Alasan menggunakan Elevation API

Dengan Elevation API, Anda dapat mengembangkan aplikasi untuk mendukung pelanggan dengan aktivitas yang sensitif terhadap ketinggian, aplikasi pemosisian, atau survei rendah yang mencakup perubahan elevasi dan elevasi di sepanjang rute. Misalnya, Anda bisa memberikan data peningkatan dan penurunan ketinggian untuk meningkatkan aplikasi olahraga untuk aktivitas seperti 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 ketinggian di sepanjang rute atau antara dua poin.

Cara kerja Elevation API

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

Layanan memperoleh elevasi untuk koordinat yang diberikan. Pola ini juga berinterpolasi elevasi untuk lokasi tanpa elevasi, yang memberikan data rata-rata yang ditampilkan lokasi terdekat yang menyediakan data elevasi. Akhirnya, hal ini menentukan keseluruhan resolusi untuk lokasi tersebut.

Resource

Tabel berikut meringkas sumber daya yang tersedia melalui Elevation API bersama dengan data yang dihasilkannya.

Resource data Data yang dikembalikan Format pengembalian
Koordinat lintang/bujur

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

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

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

Cara menggunakan Elevation API

1 Melakukan penyiapan. Mulailah dengan Menyiapkan Project Google Cloud dan selesaikan penyiapan petunjuk yang mengikutinya.
2 Coba permintaan elevasi Setelah memiliki kunci API, Anda dapat mulai menguji Elevation API secara langsung dari browser Anda. 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 . Lihat Menentukan jalur untuk mengetahui detailnya.
4 Memahami dasar-dasar respons Jelajahi respons data elevasi untuk mempersiapkan penggunaan data elevasi untuk aplikasi Anda. Lihat Respons elevasi untuk mengetahui detailnya.
5 Sertakan data elevasi ke dalam aplikasi Anda sendiri. Anda dapat menggunakan data ketinggian untuk meningkatkan aplikasi berbasis lokasi, seperti aplikasi untuk olahraga kegiatan 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 Google Maps Layanan adalah library klien yang didukung komunitas, yang bersifat open source di bawah Lisensi Apache 2.0. Download semuanya dari GitHub, tempat Anda juga dapat menemukan petunjuk penginstalan dan kode contoh.

Langkah berikutnya