[GIS] DuraMap-Xr, ESRI Shp 파일 생성하기

DuraMap-Xr은 쉽게 ESRI의 SHP 파일을 생성할 수 있습니다. SHP 파일은 도형 정보와 속성 데이터가 별도의 파일로 분리된 파일 시스템으로 도형정보는 .shp 파일에 저장되고 속성정보는 .dbf 파일에 저장됩니다. 간단히 DuraMap-Xr에서 SHP 파일을 생성하는 예를 보이기 위해 아래와 같은 폴리곤 데이터를 만들어 보는 DuraMap-Xr의 API에 대해 살펴보겠습니다.

사용자 삽입 이미지
총 3개의 폴리곤으로 구성되어 있으며 속성에 대한 테이블의 필드 구조는 Name, Age, Height를 가집니다.

  1. Name은 문자열 타입
  2. Age는 정수 타입
  3. Height는 실수 타입

그림을 살펴보면 Name이 대길이는 도형은 가운데 구멍이 뚤린 Ring 형태입니다. 즉, 하나의 도형이 2개의 폴리곤으로 구성되는데 하나는 외각 폴리곤이고 두번째는 내부 폴리곤(Hole)입니다. 홍길동과 코난에 대한 도형은 하나의 폴리곤으로 구성되어 있구요.

DuraMap-Xr은 포인트, 폴리라인, 폴리곤 타입에 대한 SHP 파일을 생성할 수 있습니다. 여기서는 위의 그림에 해당하는 폴리곤 SHP 파일을 만들어 보겠습니다.

먼저 Visual Studio를 실행하고 윈도우즈 폼 응용프로그램에 해당하는 프로젝트를 시작합니다. 그리고 참조 추가를 통해 XrMapLib를 추가합니다. 제대로 되었다면 솔루션 탐색기의 참조에 다음 항목이 표시됩니다.

사용자 삽입 이미지
폼위에 버튼을 하나만을 올려 놓습니다. 이 버튼을 클릭하면 SHP 파일이 만들어 지게 됩니다. 지금부터는 클릭 이벤트에 대한 코드를 한줄 한줄 순서대로 소개하겠습니다. 만들고자하는 도형에 대한 그림과 비교하면서 잘 살펴보시기 바랍니다.

XrMapLib.FieldSetDefine FSD = new XrMapLib.FieldSetDefine();
FSD.AddStringField("Name", 20);
FSD.AddIntegerField("Age", 4);
FSD.AddFloatField("Height", 6, 2);

속성에 대한 필드를 정의하는 부분입니다. Name 필드를 위해 AddStringField 매서드를 호출했고 두번째 인자는 값의 최대 길이입니다. 그리고 Age 필드를 위해 AddIntegerField를 호출했고 두번째 필드는 정수값의 길이입니다. 즉 최대 9999까지의 값을 입력할 수 있습니다. 그리고 Height 필드를 위해 AddFloatField를 호출하는데 두번째 인자는 실수값의 길이이며 세번째 값은 소수부분에 대한 길이입니다. 지정한 값이 6과 2이므로 최대 999.99까지의 값을 지정할 수 있습니다.

XrMapLib.Tool tool = new XrMapLib.Tool();

XrMapLib.EsriShpFileHandler SFH = tool.CreateEsriShpFileHandler("d:/polygon.shp",
    XrMapLib.XrShapeTypeEnum.XrPolygon, FSD);

if (SFH == null)
{
    MessageBox.Show("Error: Creating shp file");
} 
else
{
    ....

위의 코드는 실제로 SHP 파일을 생성하는 코드로 Xr의 Tool 객체의 CreateEsriShpHandler를 이용하여 d:/ 폴더 위치에 polygon.shp 파일과 polygon.dbf 파일을 생성합니다. 두번째 인자는 생성하고자 하는 도형의 종류로써 여기서는 폴리곤(XrPolygon)을 지정했고 세번째 인자로 앞서 정의한 속성의 필드정의에 대한 객체를 넘깁니다. 성공적으로 파일이 생성되면 EsriShpFileHandler의 인스턴스가 반환되고 실패하면 null을 반환합니다. 실패한 이유로는 기존에 동일한 이름의 파일이 존재하거나 필드 정의가 잘못된 경우 등입니다. 다음의 코드는 성공적으로 파일을 생성했을때의 코드 부분입니다.

XrMapLib.CoordinateListCollection CLC = new XrMapLib.CoordinateListCollection();
XrMapLib.CoordinateList CL = new XrMapLib.CoordinateList();
XrMapLib.ValueList VL = new XrMapLib.ValueList();

실제 좌표값과 속성값을 저장할 객체드를 생성합니다. CoordinateList는 다수의 포인트 좌표들로 구성되는 리스트이고 CoordListCollection은 다수의 CoordinateList를 포함하는 객체입니다. 여러개의 폴리곤으로 구성된 도형을 추가할때 CoordinateListCollection을 사용해야 하며 위의 예에서 “대길이”에 해당하는 도형을 위한 객체입니다.

CL.Clear();
CL.Add(10, 10);
CL.Add(20, 10);
CL.Add(20, 20);
CL.Add(10, 20);

VL.Clear();
VL.AddByString("홍길동");
VL.AddByInteger(19);
VL.AddByFloat(173.4, 1);
SFH.AddSinglePart(CL, VL);

홍길동에 해당하는 도형을 추가하는 코드입니다. 주의할점은 속성값의 지정순서는 필드의 정의 순서와 일치해야 합니다.

CL.Clear();
CL.Add(30, 10);
CL.Add(40, 10);
CL.Add(40, 20);
CL.Add(30, 20);

VL.Clear();
VL.AddByString("코난");
VL.AddByInteger(16);
VL.AddByFloat(161.4, 1);
SFH.AddSinglePart(CL, VL);

코난에 대한 도형을 추가하는 코드입니다. 앞의 홍길동에 대한 도형 추가 코드와 매우 유사합니다.

CLC.Clear();
CL.Clear();
CL.Add(20, 30);
CL.Add(30, 30);
CL.Add(30, 40);
CL.Add(20, 40);
CLC.Add(CL);
CL.Clear();
CL.Add(22, 32);
CL.Add(28, 32);
CL.Add(28, 38);
CL.Add(22, 38);
CLC.Add(CL);

VL.Clear();
VL.AddByString("대길이");
VL.AddByInteger(24);
VL.AddByFloat(171.4, 1);
SFH.AddMultiPart(CLC, VL);

끝으로 대길이에 대한 폴리곤입니다. 이 도형은 2개의 폴리곤으로 구성되었다는 것을 앞서 그림을 통해 살펴보았습니다.

도형과 속성을 통해 원하는 도형들의 추가가 완료되었으면 가장 마지막으로 다음 코드를 호출하여 마무리합니다.

SFH.Close();

실제로 생성된 파일을 탐색기를 통해 살펴본 그림은 아래와 같습니다.

사용자 삽입 이미지

이 생성된 shp 파일을 DuraMap-Xr로 만든 BeautifyMap으로 살펴보면 아래와 같습니다.

사용자 삽입 이미지

[GIS] DuraMap-Xr, SHP 파일 표시하기

DuraMap-Xr은 지도 데이터를 2가지의 큰 카테고리로 나눠 레이어 개념으로 관리합니다. 여기서 레이어(Layer)란 흔히 GIS에서 사용하는 용어와 동일한 의미를 가집니다.

  • ShapeMapLayer : DXF, SHP 등과 같은 수치지도 지도 레이어
  • GridMapLayer : 이미지, 라스터 등과 같은 그리드 지도 레이어

여기서는 ESRI에서 제시한 범용 수치지도 포맷인 SHP 파일을 추가하여 Xr 맵엔진에서 표시하는 API를 C#을 통해 설명합니다.

먼저 Visual Studio를 실행하여 C#의 Windows Forms 응용 프로그램 프로젝트를 생성 한 후에 폼에 XrMap 컨트롤과 지도뷰를 조작하기 위한 버튼을 다음 화면처럼 추가합니다.

사용자 삽입 이미지
이제 이 폼에 대한 Load 이벤트에서 Shp 파일을 통해 도형 지도 레이어를 추가하는 코드를 아래와 같이 작성합니다.

axXr1.Layers.AddShapeMapLayer("행정동", "d:/__data__/dong.shp");
axXr1.WaitForAllConnections();
axXr1.ZoomFullExtent();

axXr1은 앞서 폼에 추가한 DuraMap-Xr 컨트롤의 이름입니다. AddShapeMapLayer는 2개의 인자를 받는데 첫번째는 레이어의 식별자로써 레이어의 이름이고 두번째는 공간데이터에 대한 연결 문자열로 파일경로로 적합한 연결문자열입니다. 이렇게 레이어를 추가한 뒤에 WaitForAllConnections을 호출하여 레이어를 추가하는데 필요한 공간데이터를 모두 읽을 때까지 대기합니다. 참고로 공간데이터를 읽는 코드는 스레드로 작동됩니다. WaitForAllConnections 매서드가 반환되면 모든 지도 레이어가 완벽하게 추가되었음을 보장하므로 지도를 화면에 꽉 차게 표시되도록 ZoomFullExtent를 호출합니다. 실행 결과는 아래와 같습니다.

사용자 삽입 이미지

이제 지도 뷰를 조작하기 위해 추가했던 전체 보기, 확대, 축소, 이동, 이전 보기, 보기 되돌리기 버튼에 대한 클릭 이벤트를 구성하는 코드를 살펴보겠습니다.

먼저 전체보기는 이미 앞서 설명드렸던 axXr1.ZoomFullExtent()가 해당되어 아래와 같습니다.

axXr1.ZoomFullExtent();

그리고 현재 보이는 지도를 확대하기 위한 확대 버튼의 코드는 다음과 같습니다.

axXr1.MouseMode = XrMapLib.XrMapViewModeEnum.XrZoomInMode;

그리고 축소 버튼의 코드는 다음과 같습니다.

axXr1.MouseMode = XrMapLib.XrMapViewModeEnum.XrZoomOutMode;

그리고 지도를 이동하는 코드는 다음과 같습니다.

axXr1.MouseMode = XrMapLib.XrMapViewModeEnum.XrPanMode;

그리고 지도에 대한 뷰의 변화에 대한 Undo 기능에 대한 버튼인 이전 보기의 코드는 다음과 같습니다.

axXr1.UndoView();

이전보기에 대한 반개 기능은 보기 되돌리기 버튼의 코드는 다음과 같습니다.

axXr1.RedoView();

이상으로 SHP 파일을 표시하고 사용자가 마우스를 통해 표시된 지도를 조회해 보는 기능에 대해 간단히 살펴보았습니다.