Zrozumienie i korzystanie z trybów wysokości

AltitudeMode to właściwość, która określa pionowe położenie elementu mapy. Określa, czy obiekt jest renderowany względem terenu, względem obiektów nadziemnych (takich jak budynki) czy na bezwzględnej wysokości nad poziomem morza.

AltitudeMode to właściwość, która określa, gdzie elementy dodawane do mapy 3D, takie jak znaczniki, linie łamane, wielokąty i modele, są renderowane względem powierzchni Ziemi. Dodatkowo AltitudeMode określa, gdzie znajduje się kamera podczas animacji flyCameraTo i flyCameraAround.

Z tego przewodnika dowiesz się, jak skutecznie używać AltitudeMode i jakie czynniki wpływają na renderowanie elementów.

Numeryczne modele terenu

Umieszczanie obiektów jest regulowane przez 2 podstawowe cyfrowe modele wysokościowe (DEM) dostępne w interfejsie API:

  • Numeryczny model terenu (NMT) / „Ground”: widok „gołej ziemi” pokazujący wysokość terenu, z usuniętymi obiektami znajdującymi się nad ziemią.
  • Cyfrowy model powierzchni (DSM) / „siatka”: reprezentacja powierzchni, która obejmuje wysokość terenu oraz obiekty nadziemne, takie jak budynki i drzewa.

Ilustracja poniżej pokazuje różnicę między renderowaniem obszaru miejskiego za pomocą DTM i DSM:

Obraz przedstawiający widoki DTM i DSM Koloseum obok siebie

Opcje: AltitudeMode

Wybór AltitudeMode określa, jak wartość wysokości elementu (jeśli jest podana) jest interpretowana w odniesieniu do cyfrowych modeli wysokości.

  • ABSOLUTE: renderuje obiekt względem średniego poziomu morza obliczonego za pomocą EGM96.
  • CLAMP_TO_GROUND: renderuje obiekt bezpośrednio na DTM (ziemi), ignorując podaną wysokość i podążając za ukształtowaniem terenu.
  • RELATIVE_TO_GROUND: renderuje obiekt względem powierzchni DTM (ziemi).
  • RELATIVE_TO_MESH: renderuje obiekt względem DSM (siatki) – najwyższej powierzchni, w tym gruntu, budynków i wody.

Wartości wysokości w trybach względnych

W przypadku trybów względnych (RELATIVE_TO_GROUND lub RELATIVE_TO_MESH) podana wartość wysokości jest przesunięciem względem wybranej powierzchni bazowej, a nie stałą wysokością nad poziomem morza. Na przykład wysokość 100 umieści obiekt 100 metrów nad DTM lub DSM.

Jeśli dane obiektu nie zawierają wysokości, tryb względny, taki jak RELATIVE_TO_MESH, umieści obiekt bezpośrednio na siatce lub powierzchni. Jednak w przypadku linii łamanych i wielokątów połączenia między punktami będą liniami prostymi, co może spowodować, że linia będzie przechodzić przez siatkę między punktami, jeśli nie użyjesz interpolacji.