Zrozumienie i korzystanie z trybów wysokości

AltitudeMode to właściwość, która określa umiejscowienie elementu mapy w pionie. Określa, czy obiekt jest renderowany względem terenu, względem elementó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 dodane do mapy 3D, takie jak znaczniki, linie łamane, wielokąty i modele, są renderowane względem powierzchni Ziemi. Dodatkowo AltitudeMode określa, gdzie kamera jest umieszczona podczas animacji flyCameraTo i flyCameraAround.

W tym przewodniku znajdziesz informacje o skutecznym używaniu elementu AltitudeMode oraz o czynnikach, które wpływają na sposób renderowania elementów.

Numeryczne modele terenu

Umiejscowienie funkcji zależy od 2 podstawowych cyfrowych modeli wysokości (DEM) dostępnych w interfejsie API:

  • Numeryczny model terenu (NMT) / „Teren”: widok „gołej ziemi” przedstawiający wysokość terenu bez obiektów nadziemnych.
  • Cyfrowy model powierzchni (DSM) / „Siatka”: reprezentacja powierzchni, która obejmuje wysokość terenu oraz obiekty naziemne, takie jak budynki i drzewa.

Ilustracja poniżej przedstawia różnicę między renderowaniem miejskiego obszaru w DTM i DSM:

Obraz przedstawiający widoki Koloseum w DTM i DSM obok siebie

Opcje: AltitudeMode

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

  • ABSOLUTE: renderuje obiekt względem średniego poziomu morza obliczonego na podstawie modelu EGM96.
  • CLAMP_TO_GROUND: renderuje obiekt bezpośrednio na DTM (podłożu), ignorując podaną wysokość i dopasowując się do terenu.
  • RELATIVE_TO_GROUND: renderuje obiekt względem modelu terenu (DTM).
  • 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 korzystania z trybów względnych (RELATIVE_TO_GROUND lub RELATIVE_TO_MESH) podana wartość wysokości jest przesunięciem od 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 funkcji nie zawierają wysokości, tryb względny, np.RELATIVE_TO_MESH, umieści funkcję bezpośrednio na siatce lub powierzchni. W przypadku polilinii i wielokątów połączenia między punktami będą jednak liniami prostymi, co może spowodować, że linia będzie przechodzić przez siatkę między punktami, jeśli nie użyjesz interpolacji.