Memahami dan menggunakan mode ketinggian

AltitudeMode adalah properti yang menentukan penempatan vertikal elemen peta. Properti ini menentukan apakah objek dirender relatif terhadap medan, relatif terhadap fitur di atas 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. Selain itu, AltitudeMode mengontrol posisi kamera selama animasi flyTo dan flyAround.

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

Model elevasi digital

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

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

Gambar berikut menunjukkan perbedaan antara rendering DTM dan DSM di 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 disediakan) ditafsirkan relatif terhadap model elevasi digital.

  • ABSOLUTE: Merender objek relatif terhadap permukaan laut rata-rata, dihitung menggunakan EGM96.
  • CLAMP_TO_GROUND: Merender objek langsung di DTM (Tanah), mengabaikan ketinggian yang diberikan dan mengikuti medan.
  • RELATIVE_TO_GROUND: Merender objek relatif terhadap permukaan DTM (Tanah).
  • 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 setelan semi-perkotaan:

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 antar-titik jika Anda tidak menggunakan interpolasi.

Langkah berikutnya

  • Baca topik Pusat Arsitektur untuk mengetahui ringkasan mendalam tentang AltitudeMode, termasuk informasi tentang AltitudeMode dan penanda.