AltitudeMode은 지도 요소의 세로 배치 위치를 정의하는 속성입니다.
객체가 지형을 기준으로 렌더링되는지, 지상 기능 (예: 건물)을 기준으로 렌더링되는지, 해수면 위 절대 높이로 렌더링되는지 결정합니다.
AltitudeMode는 마커, 다중선, 다각형, 모델 등 3D 지도에 추가하는 요소가 지표면을 기준으로 렌더링되는 위치를 결정하는 속성입니다. 또한 AltitudeMode은 flyTo 및 flyAround 애니메이션 중에 카메라가 배치되는 위치를 제어합니다.
다음 가이드에서는 AltitudeMode을 효과적으로 사용하는 방법과 요소가 렌더링되는 방식에 영향을 미치는 요소를 고려하는 방법을 설명합니다.
디지털 고도 모델
기능 배치는 API에서 액세스할 수 있는 두 가지 기본 디지털 고도 모델 (DEM)에 따라 관리됩니다.
- 디지털 지형 모델 (DTM) / '지면': 지상 객체가 삭제되고 기본 지형의 고도를 보여주는 '지면' 뷰입니다.
- 디지털 표면 모델 (DSM) / '메시': 지형 고도와 건물, 나무와 같은 지상 지형지물을 포함하는 표면 표현입니다.
다음 이미지는 도시 지역의 DTM 렌더링과 DSM 렌더링의 차이를 보여줍니다.

옵션 AltitudeMode개
AltitudeMode 선택에 따라 특성의 고도 값 (제공된 경우)이 디지털 고도 모델을 기준으로 해석되는 방식이 결정됩니다.
ABSOLUTE: EGM96을 사용하여 계산된 평균 해수면을 기준으로 객체를 렌더링합니다.CLAMP_TO_GROUND: 제공된 고도를 무시하고 지형을 따라 DTM (지상)에 객체를 직접 렌더링합니다.RELATIVE_TO_GROUND: DTM (지면) 표면을 기준으로 객체를 렌더링합니다.RELATIVE_TO_MESH: 지면, 건물, 물을 포함한 가장 높은 표면인 DSM (메시)을 기준으로 객체를 렌더링합니다.
다음 샘플을 사용하면 다중선의 AltitudeMode를 변경하여 다양한 모드가 준도시 환경의 복잡한 도형에 대한 다중선의 렌더링에 미치는 영향을 관찰할 수 있습니다.
상대 모드의 고도 값
상대 모드 (RELATIVE_TO_GROUND 또는 RELATIVE_TO_MESH)를 사용하는 경우 제공된 고도 값은 선택한 기본 표면의 오프셋이며 해발 위의 고정된 높이가 아닙니다. 예를 들어 고도를 100으로 설정하면 피처가 DTM 또는 DSM 위 100미터에 배치됩니다.
기능 데이터에 고도가 포함되지 않은 경우 RELATIVE_TO_MESH와 같은 상대 모드는 메쉬/표면 바로 위에 기능을 배치합니다.
하지만 폴리라인과 다각형의 경우 점 사이의 연결이 직선이므로 보간을 사용하지 않으면 선이 점 사이의 메시를 통과할 수 있습니다.
다음 단계
AltitudeMode및 마커에 관한 정보를 비롯해AltitudeMode에 관한 자세한 개요는 아키텍처 센터 주제를 참고하세요.