Memahami dan menggunakan mode ketinggian

AltitudeMode adalah properti yang menentukan penempatan vertikal elemen peta. Menentukan apakah objek dirender relatif terhadap medan, relatif terhadap fitur di atas permukaan tanah (seperti bangunan), atau pada ketinggian absolut di atas permukaan laut.

AltitudeMode adalah properti yang menentukan tempat elemen yang Anda tambahkan ke peta 3D, seperti penanda, polyline, poligon, dan model, dirender relatif terhadap permukaan bumi.

Panduan berikut memberikan informasi tentang cara menggunakan AltitudeMode secara efektif, dan pertimbangan untuk faktor-faktor yang memengaruhi cara elemen dirender.

Model elevasi digital

Penempatan fitur diatur oleh dua Model Elevasi Digital (DEM) pokok yang dapat diakses di API:

  • Model Medan Digital (DTM) / "Tanah": Tampilan "tanah kosong" yang menunjukkan elevasi medan di bawahnya, dengan objek di atas tanah dihapus.
  • Model Permukaan Digital (DSM) / "Mesh": Representasi permukaan yang mencakup elevasi medan serta fitur di atas permukaan tanah seperti bangunan dan pohon.

Gambar berikut menunjukkan perbedaan antara rendering DTM dan DSM dari area perkotaan:

Gambar yang menampilkan tampilan DTM dan DSM Menara Eiffel dan Paris secara berdampingan

Opsi AltitudeMode

Pilihan AltitudeMode menentukan cara nilai ketinggian fitur (jika diberikan) ditafsirkan relatif terhadap model elevasi digital.

  • ABSOLUTE: Merender objek relatif terhadap permukaan laut rata-rata, yang dihitung menggunakan EGM96.
  • CLAMP_TO_GROUND: Merender objek langsung di DTM (Ground), mengabaikan ketinggian yang diberikan dan mengikuti medan.
  • RELATIVE_TO_GROUND: Merender objek relatif terhadap permukaan DTM (Ground).
  • RELATIVE_TO_MESH: Merender objek relatif terhadap DSM (Mesh)—permukaan tertinggi, termasuk tanah, bangunan, dan air.

Contoh berikut memungkinkan Anda mengubah AltitudeMode polyline untuk mengamati pengaruh berbagai mode terhadap rendering polyline pada geometri kompleks dalam latar semi-urban:

Nilai ketinggian dalam mode relatif

Saat menggunakan mode relatif (RELATIVE_TO_GROUND atau RELATIVE_TO_MESH), nilai ketinggian yang diberikan adalah offset dari permukaan dasar yang dipilih, bukan ketinggian tetap di atas permukaan laut. Misalnya, ketinggian 100 akan menempatkan fitur 100 meter di atas DTM atau DSM.

Jika data fitur tidak menyertakan ketinggian, mode relatif seperti RELATIVE_TO_MESH akan menempatkan fitur langsung di atas mesh/permukaan. Namun, untuk polyline dan poligon, koneksi antar-titik akan berupa garis lurus, yang dapat menyebabkan garis melewati mesh di antara titik jika Anda tidak menggunakan interpolasi.

Langkah berikutnya

  • Baca topik Architecture Center untuk mengetahui ringkasan AltitudeMode yang lebih mendalam, termasuk informasi tentang AltitudeMode dan penanda.