AltitudeMode는 지도 요소의 세로 게재위치를 정의하는 속성입니다.
객체가 지형을 기준으로 렌더링되는지, 지상 지형지물 (예: 건물)을 기준으로 렌더링되는지, 해발 절대 높이를 기준으로 렌더링되는지를 결정합니다.
AltitudeMode는 마커, 다중선, 다각형, 모델과 같이 3D 지도에 추가하는 요소가 지표면을 기준으로 렌더링되는 위치를 결정하는 속성입니다. 또한 AltitudeMode은 flyCameraTo 및 flyCameraAround 애니메이션 중에 카메라가 배치되는 위치를 제어합니다.
다음 가이드에서는 AltitudeMode를 효과적으로 사용하는 방법과 요소가 렌더링되는 방식에 영향을 미치는 요인에 관한 고려사항을 설명합니다.
디지털 고도 모델
지형지물 배치는 API에서 액세스할 수 있는 두 가지 기본 수치 표고 모델 (DEM)에 의해 제어됩니다.
- 디지털 지형 모델 (DTM) / '지면': 지상 객체가 삭제된 기본 지형의 고도를 보여주는 '지표면' 뷰입니다.
- 디지털 표면 모델 (DSM) / '메시': 지형 고도와 건물, 나무와 같은 지상 지형지물을 포함하는 표면 표현입니다.
다음 이미지는 도시 지역의 DTM과 DSM 렌더링의 차이를 보여줍니다.
옵션 AltitudeMode개
AltitudeMode를 선택하면 지형지물의 고도 값 (제공된 경우)이 디지털 고도 모델을 기준으로 해석되는 방식이 결정됩니다.
ABSOLUTE: EGM96을 사용하여 계산된 평균 해수면을 기준으로 객체를 렌더링합니다.CLAMP_TO_GROUND: 제공된 고도를 무시하고 지형을 따라 DTM (지면)에 직접 객체를 렌더링합니다.RELATIVE_TO_GROUND: DTM (지면) 표면을 기준으로 객체를 렌더링합니다.RELATIVE_TO_MESH: DSM (메시)을 기준으로 객체를 렌더링합니다. DSM은 지면, 건물, 수면을 포함한 가장 높은 표면입니다.
상대 모드의 고도 값
상대 모드 (RELATIVE_TO_GROUND 또는 RELATIVE_TO_MESH)를 사용하는 경우 제공된 고도 값은 선택한 기본 표면으로부터의 오프셋이며 해발 고정 높이가 아닙니다. 예를 들어 고도가 100이면 지형지물이 DTM 또는 DSM보다 100미터 위에 배치됩니다.
지형지물 데이터에 고도가 포함되지 않은 경우 RELATIVE_TO_MESH와 같은 상대 모드는 지형지물을 메시/표면 바로 위에 배치합니다.
하지만 다중선과 다각형의 경우 점 사이의 연결이 직선이므로 보간을 사용하지 않으면 선이 점 사이의 메시를 통과할 수 있습니다.