[GIS] ArcObjects, 지도에 라벨(Label 또는 Annotation) 표시

지도 위에 속성값을 표시하는 것을 라벨링(Labeling) 또는 어노테이션 달기라고 합니다. 예를 들어서 행정구역도를 표시하고 각 구역에 행정구의 명칭을 표시하여 사용자에게 직관적인 지도 정보를 전달할 수 있습니다. 이 포스트 글의 예제 코드의 결과 이미지를 보면 더욱 이해가 쉬울것입니다.

사용자 삽입 이미지

라벨 문자열은 속성 데이터 값을 기반으로 해당되는 도형 위에 표시가 되며 문자 표시를 위한 속성인 폰트, 색상등을 지정할 수 있습니다. 이외에도 ArcGIS는 매우 융통성 있는 라벨 표시를 위한 강력한 API를 개발자에게 제공합니다. 라벨 표시에 대해 상상할 수 있는 모든 경우의 수를 처리하고 있다고 해도 과언이 아닐 정도로 말입니다.

라벨에 대해 간단한 설명은 이정도로 하고.. 실제로 지도 레이어에 라벨링 기능을 추가해 보는 코드를 정리해 보도록 하겠습니다. 이 예제 코드는 기본적으로 SHP 파일 지도 레이어가 지도 컨트롤에 추가되어 있다는 가정 하에 설명합니다.

가장 먼저 라벨 처리를 위해 추가한 레이어를 IGeoFeatureLayer로 QueryInterface합니다. 참고로 QueryInterface는 C#이나 VB와 같은 고수준 언어에서는 간단히 형변환으로 이해하셔도 됩니다.

ESRI.ArcGIS.Carto.IGeoFeatureLayer pLayer = axMapControl1.get_Layer(0) as 
            ESRI.ArcGIS.Carto.IGeoFeatureLayer;

이렇게 추가된 지도 레이어를 IGeoFeatureLayer 인터페이스로 QueryInterface하여 pLayer 변수에 저장해 둡니다.

다음으로 라벨의 텍스트 색상을 지정하기 위해 다음 코드가 필요합니다.

ESRI.ArcGIS.Display.IRgbColor pColorFont = new ESRI.ArcGIS.Display.RgbColor();
pColorFont.Red = 255;
pColorFont.Green = 100;
pColorFont.Blue = 100;

ESRI.ArcGIS.Display.IFormattedTextSymbol pText = 
                             new ESRI.ArcGIS.Display.TextSymbol();
pText.Color = pColorFont;

색상값을 지정하기 위해 IRgbColor 타입을 사용하고 이렇게 지정한 색상을 IFormattedTextSymbol의 인스턴스인 pText의 Color 속성에 지정합니다. 참고로 IFormattedTextSymbol을 통해 텍스트 심벌의 색상, 스타일, 폰트, 그림자 효과 등을 지정할 수 있습니다.

다음으로 실제로 라벨링을 위한 코드가 실행됩니다. ArcGIS는 라벨을 API에서 Annotation이라는 용어를 사용합니다.

ESRI.ArcGIS.Carto.IAnnotateLayerPropertiesCollection pAnnoPropsCollection =
        new ESRI.ArcGIS.Carto.AnnotateLayerPropertiesCollection();

ESRI.ArcGIS.Carto.ILabelEngineLayerProperties pLabelEngine =
        new ESRI.ArcGIS.Carto.LabelEngineLayerProperties()
              as ESRI.ArcGIS.Carto.ILabelEngineLayerProperties;

pLabelEngine.Expression = "[SGG_NM]";
pLabelEngine.Symbol = pText;

ESRI.ArcGIS.Carto.IAnnotateLayerProperties pAnnoLayerProps =
        pLabelEngine as ESRI.ArcGIS.Carto.IAnnotateLayerProperties;

pAnnoPropsCollection.Add(pAnnoLayerProps);

먼저 라벨의 속성을 위해 IAnnotateLayerPropertiesCollection 타입의 변수인 pAnnoPropsCollection 변수를 생성하고 라벨을 화면상에 표시하는 기능을 책임지는 ILabelEngineLayerProperties 타입의 pLabelEngine 변수를 생성합니다. 그리고 이 pLabelEngine의 Expression에 라벨 문자값으로 표시할 필드 이름을 [와 ] 사이에 지정합니다. 그리고 라벨 문자의 색상을 지정해 놓은 pText 객체를 pLabelEngine의 Symbol 속성에 지정합니다. 그리고 이 pLabelEngine을 IAnnotateLayerProperties 타입으로 형변환하여 pAnnoLayerProps 객체에 지정하여 이 객체를 pAnnoPropsCollection 객체의 Add 매서드를 통해 추가합니다.

이제 라벨을 위한 설정은 모두 끝났으므로 레이어의 라벨 속성값에 지정하고 라벨 표시 기능을 활성화 합니다.

pLayer.AnnotationProperties = pAnnoPropsCollection;
pLayer.DisplayAnnotation = true;

axMapControl1.ActiveView.Refresh();

가끔 드는 생각이지만 ArcObjects는 하나의 단위 기능을 위해 상당히 많은 CoClass와 Interface 타입을 사용함으로써 ArcObjects에 대한 많은 지식을 개발자에게 요구하는듯합니다. 이러한 이유는 ArcObjects가 복잡한것이 아니라 하나의 기능에 대해서 매우 다양한 모습으로 응용시킬 여지를 열어 놓기 위함입니다.

[GIS] ArcObjects, 속성값으로 도형 선택하기

ESRI에서 정의하는 Feature는 도형+속성입니다. 즉 공간 상의 위치/모양을 나타내는 도형 정보와 이 도형 정보에 대한 속성 정보의 쌍이 Feature라고 할 수 있습니다. GIS 시스템에서 우리는 매우 자주 속성값의 검색을 통해 공간 상의 도형이 어떻게 분포되어 있는지를 파악해 보는 경우가 많습니다. 예를 들어서 서울시를 구성하는 행정구 중에서 인구가 10만명 이상인 지역이라든지… 행정구의 이름 중 ‘동’자가 들어가는 동대문구나 동작구 등과 같은 지역의 도형을 선택하는 것입니다. 여기서는 두번째 예인 ‘동’자가 들어가는 서울시의 행정구를 선택해보는 예를 통해 속성값으로 도형을 선택하는 기능에 대해 정리해 보도록 하겠습니다.

먼저 서울시의 SHP 파일로부터 지도 레이어를 추가합니다. 이 SHP 파일의 속성값은 아래와 같습니다.

사용자 삽입 이미지
살펴보면 SGG_NM이라는 필드명이 행정구의 이름을 담고 있는 필드라는 것을 알 수 있습니다. 이런 경우에 ‘동’자가 들어가는 행정구의 이름을 가진 레코드를 검색하기 위해 우리는 흔히 다음과 같은 SQL문을 던지게 됩니다.

SELECT * FROM TABLE_NAME WHERE SGG_NM LIKE '%동%'

여기서 중요한 것은 WHERE절에 해당하는 SGG_NM LIKE ‘%동%’입니다. 바로 SQL문의 WHERE절에 우리가 원하는 조건을 통해 속성 조건값에 일치하는 도형을 선택할 수 있게 됩니다. 아래는 실제로 속성값에 대한 도형 선택에 대한 ArcObjects의 코드입니다.

ESRI.ArcGIS.Carto.IFeatureLayer pFL = axMapControl1.get_Layer(0) as 
                     ESRI.ArcGIS.Carto.IFeatureLayer;

ESRI.ArcGIS.Geodatabase.IFeatureClass pFC = pFL.FeatureClass;
ESRI.ArcGIS.Geodatabase.QueryFilter pQF = 
                     new ESRI.ArcGIS.Geodatabase.QueryFilter();

pQF.WhereClause = "SGG_NM LIKE '%동%'";

ESRI.ArcGIS.Geodatabase.ISelectionSet pSS = pFC.Select(pQF,
                           esriSelectionType.esriSelectionTypeIDSet,
                           esriSelectionOption.esriSelectionOptionNormal, null);

ESRI.ArcGIS.Carto.IFeatureSelection pFS = 
                    pFL as ESRI.ArcGIS.Carto.IFeatureSelection;
pFS.SelectionSet = pSS;

axMapControl1.ActiveView.Refresh();

아래는 그 실행 결과 화면입니다.

사용자 삽입 이미지

서울시의 행정구 중에 ‘동’자가 들어간 영역에 대한 총 4개의 도형이 선택된 것을 알 수 있습니다.