[태그:] FingerEyes

오직 공간 도형에 대한 FID 값만을 알고 있는 상태에서 해당 도형의 MBR 영역을 얻어는 방법입니다. 물론 공간 데이터는 저…… 멀리 떨어진 서버에 존재하고 있습니다. 사용하는 클래스는 XrQueryMBRByFIDService이며 사용 예에 대한 코드는 다음과 같습니다.

var fid:int = 77707;
var layer:XrShapeMapLayer = map.layers.getLayer("JIBUN") as XrShapeMapLayer;
     
var svc:XrQueryMBRByFIDService =  
     new XrQueryMBRByFIDService(onRequestMBRComplete, onRequestMBRError);

if(!svc.run( { layer:layer, fid:fid } ))
{
    // 에라! 에러다! 에라이! ㅡ,.ㅡ
}

1번과 2번 코드를 통해 FID 값은 77707이며 검색 대상이 되는 레이어를 레이어 명으로 얻어옵니다. 그리고 XrQueryMBRByFIDService의 run 함수를 통해 FID와 대상 레이어를 인자로 해서 호출합니다.

성공적으로 MBR을 얻어오면 onRequestMBRComplete 함수가 호출되며 실패하면 onRequestMBRError가 호출됩니다. 이 함수들의 코드는 다음과 같은 형태가 될 수 있습니다.

private function onRequestMBRComplete(mbr:XrExtent):void
{
    map.moveMap(new XrCoordinate(mbr.centerX, mbr.centerY), false);
    map.update(true);
}
   
private function onRequestMBRError():void
{
    // 에라!    
}

MBR 얻기가 성공했을때 호출되는 콜백함수에는 MBR 값이 XrExtent 타입으로 넘어옵니다. 이 타입을 통해 MBR에 접근해 지도를 이동시키는 등의 작업을 할 수 있습니다.

아래의 이미지는 위의 코드를 기반으로 지적 검색 기능을 실제 프로젝트에 적용해 본 화면입니다. 읍면 그리고 리 등과 같은 정보를 입력하고 검색을 누르면 해당 지번이 검색되고 검색된 지번 중 하나를 선택하고 이동 버튼을 누르면 선택된 지번의 FID 값을 이용해 해당 위치로 이동합니다.

Flex 기반의 GIS 엔진인 핑거아이즈는 데이터베이스 테이블의 데이터를 쉽게 쿼리할 수 있는 매우 손쉬운 API를 내장하고 있습니다. XrQueryTableService라는 클래스로 이름에서도 알 수 있듯이 테이블에 대해 쿼리를 날려주는 서비스를 제공하는 녀석입니다. SQL 구문 중 SELECT 구문을 통해 쉽게 데이터를 질의할 수 있습니다. 아래는 이 클래스를 사용하는 한가지 예입니다.

var svc:XrQueryTableService = new XrQueryTableService(
    "127.0.0.1:8080",
    "postgis",
    searchQueryRequestComplete,
    searchQueryRequestError
);

var select:String = "SELECT * FROM yp_admindistrict_main";
svc.run({sql:select});

DBMS는 127.0.0.1:8080 주소에 존재하는 서버에 있습니다. 그리고 DBMS는 postgis이구요. arcsde나 jdbc로도 지정이 가능합니다. 쿼리가 성공했을 시 searchQueryRequestComplete라는 함수가 콜백되고 실패했을 시에는 searchQueryRequestError라는 함수가 콜백됩니다. 실제 SQL문의 지정은 XrQueryTableService의 run 매서드를 통해 실어 보낼 수 있습니다.

쿼리시 성공했을 때와 실패했을 때의 콜백 함수의 예는 다음과 같습니다.

private function searchQueryRequestComplete(result:String):void
{
    ta.text = result;
}
   
private function searchQueryRequestError():void
{
    ta.text = "err!";
}

위에서 ta는 Flex의 TextArea 컴포넌트입니다. 버튼을 클릭했을 시 위의 코드들을 통해 쿼리를 날리고 결과를 받아 화면에 표시하는 화면은 아래와 같습니다.

보시는 것처럼 TextArea에 쿼리 결과가 XML 형태로 넘어 오는 것을 알 수 있습니다. 핑거아이즈는 개발자가 쉽게 DBMS에 접근하여 개발할 수 있도록 XrQueryTableService라는 클래스를 제공합니다. 이 외에도 ID를 통해 공간 도형의 MBR을 가져오는 서비스 등도 클라이언트 맵 엔진 단에서 제공하고 있습니다.

핑거아이즈는 지오서비스에서 개발한 RIA 맵엔진입니다. 기존에 PC 기반의 견고한 GIS 시스템 개발에 안정적으로 활용되어 왔습니다.

최근 플래시를 개발한 Adobe에서 RIA를 통해 한번의 개발로 Android, iOS, BlackBerry 기반의 디바이스에서 구동이 가능한 앱 개발을 적극 지원함으로써 이에 대해 핑거아이즈를 활용하여 안드로이드에서 지도를 볼 수 있는 앱을 간단히 만들어 공개해 봅니다.

어도비의 AIR의 성능이 향상됨에 따라 모바일 디바이스에서 핑거아이즈의 지도 표출 속도 역시 매우 향상되었습니다. 다음은 위의 앱에 대한 안드로이드 설치 파일(APK)입니다. 안드로이드 디바이스를 가지고 계시는 분들은 받아서 설치해 테스트 해보시기 바랍니다.

핑거아이즈(FingerEyes-Xr)는 지오서비스(www.geoservice.co.kr)에서 개발한 GIS 엔진입니다. LGPL 기반의 오픈소스(OpenSource)이며 전체 소스코드는 지오서비스 홈페이지 자료실을 통해 다운로드 받으실 수 있습니다.

핑거아이즈에 대한 마지막 API 사용 실습 튜토리얼로써 공간상에 의미있게 분포되어 있는 수치데이터를 차트로 표현하는 기능에 대해 살펴보겠습니다. 이 글에 대한 최종 결과에 대한 실행은 아래와 같습니다. 각 집계구에 나이대별 인구수를 파이차트로 표현하는 예입니다.

실행 결과 보기 및 소스코드 다운로드

위의 실행 결과를 살펴보면 어플리케이션에 대한 UI는 총 3개입니다. 차트표시라는 버튼, 범례표시라는 버튼 그리고 맵 컴포넌트입니다. 이 UI를 구성하기 위해 먼저 MXML Application을 추가하고 UI 구성을 위한 MXML에 다음과 같은 코드를 추가합니다.

맵 컴포넌트에 대한 네임스페이스를 xr로 잡고 있는데 이 네임스페이스가 유효하기 위해서는 Application 태그쪽에 다음과 같은 네임스페이스 속성이 필요합니다.

다시 UI 구성을 위한 코드를 살펴보면.. 맵 컴포넌트의 id를 map으로 주어 다른 코드부에서 참조할 수 있게 했으며 차트표시 버튼의 이벤트는 onChartClick 핸들러 함수에 할당했고 범례표시는 onLegendClick 핸들러 함수에 할당했습니다. 이 두개의 핸들러 함수에 집중하기 전에 먼저 배경이 되는 지도 레이어를 구성하는 코드를 살펴보겠습니다. 지도 레이어 준비는 어플리케이션의 initialize 이벤트가 적당하며 여기서는 onInit 핸들러 함수에 이 이벤트를 할당했습니다.

protected function onInit(event:FlexEvent):void
{
    var lyr:XrTileMapLayer = new XrTileMapLayer("basemap", 
        "http://www.geoservice.co.kr/tilemap1");
    map.layers.addLayer(lyr);
    
    map.viewControls.scaleLevels = 
    [
        3000000, 1800000, 800000, 460000, 250000, 
        110000, 50000, 25000, 14000, 7500, 3500, 2000
    ];
    map.moveMap(new XrCoordinate(317782, 544590));
    map.viewControls.scaleLevel = 11;
    
    var lyr2:XrShapeMapLayer = new XrShapeMapLayer("population", 
        "http://www.geoservice.co.kr:8080/Xr?layerName=population_polygon");
    lyr2.theme.properties = 
    {
        fillColor:0xff000000, fillAlpha:0.01, 
        lineThickness:2.0, lineAlpha:1.0, lineColor:0xff5522
    };
    lyr2.requestAttributeAlways = true;
    lyr2.visibleByLevel = true;
    lyr2.fromVisibleLevel = 10;
    lyr2.toVisibleLevel = 11;
    map.layers.addLayer(lyr2);
    
    addChartLayer();
}

3~5번 코드는 배경도로써 타일맵 레이어를 추가하는 코드이고 7~13번 코드는 어플리케이션이 시작할때 초기 지도뷰를 설정하는 코드이며 15~26번 코드는 차트 데이터를 위한 Shape 지도 레이어를 추가하는 코드입니다. 17~21번 코드는 Shape 지도 레이어의 그리기 심벌을 지정하는 코드이고 22번 코드는 통계 데이터에 대한 속성값을 할당 서버로부터 가져오라는 의미입니다. 그리고 23~25번 코드는 해당 Shape 맵 레이어가 사용자에게 보여지는 레벨을 10~11단계 사이에서만 보여지도록 하겠다는 의미입니다. 끝으로 28번 코드는 사용자 정의함수로 여기에 차트 표시를 위한 차트 레이어 추가를 위한 함수입니다. addChartLayer 함수를 살펴보겠습니다.

private function addChartLayer():void
{
    var chartLyr:XrChartLayer = new XrChartLayer("chart", null);
    chartLyr.defines.stroke.color = 0xffffff;
    chartLyr.defines.stroke.thickness = 2;
    
    var fillSym1:XrFillSymbol = new XrFillSymbol({fillColor:0xff1111});
    var fillSym2:XrFillSymbol = new XrFillSymbol({fillColor:0xff4444});
    var fillSym3:XrFillSymbol = new XrFillSymbol({fillColor:0xff8888});
    var fillSym4:XrFillSymbol = new XrFillSymbol({fillColor:0xffbbbb});
    var fillSym5:XrFillSymbol = new XrFillSymbol({fillColor:0xffdddd});
    var fillSym6:XrFillSymbol = new XrFillSymbol({fillColor:0x11ff11});
    var fillSym7:XrFillSymbol = new XrFillSymbol({fillColor:0x44ff44});
    var fillSym8:XrFillSymbol = new XrFillSymbol({fillColor:0x88ff88});
    var fillSym9:XrFillSymbol = new XrFillSymbol({fillColor:0xccffcc});
    var fillSym10:XrFillSymbol = new XrFillSymbol({fillColor:0x1111ff});
    var fillSym11:XrFillSymbol = new XrFillSymbol({fillColor:0x4444ff});
    var fillSym12:XrFillSymbol = new XrFillSymbol({fillColor:0x8888ff});
    var fillSym13:XrFillSymbol = new XrFillSymbol({fillColor:0xbbbbff});
    var fillSym14:XrFillSymbol = new XrFillSymbol({fillColor:0xddddff});
    
    chartLyr.defines.add("4세 이하", fillSym1);
    chartLyr.defines.add("5~9세", fillSym2);
    chartLyr.defines.add("10~14세 이하", fillSym3);
    chartLyr.defines.add("15~19세 이하", fillSym4);
    chartLyr.defines.add("20~24세 이하", fillSym5);
    chartLyr.defines.add("25~29세 이하", fillSym6);
    chartLyr.defines.add("30~34세 이하", fillSym7);
    chartLyr.defines.add("35~39세 이하", fillSym8);
    chartLyr.defines.add("40~44세 이하", fillSym9);
    chartLyr.defines.add("44~49세 이하", fillSym10);
    chartLyr.defines.add("50~54세 이하", fillSym11);
    chartLyr.defines.add("55~59세 이하", fillSym12);    
    chartLyr.defines.add("60~64세 이하", fillSym13);
    chartLyr.defines.add("65세 이상", fillSym14);
    
    map.layers.addLayer(chartLyr);    
}

3번코드가 차트 레이어를 생성하는 코드입니다. 그리고 4~5번 코드는 차트 레이어를 그릴때 외곽선에 대한 심벌입니다. 그리고 7~20번은 차트를 그릴때 사용하는 채움심벌을 위한 것으로 총 14개를 생성하고 있습니다. 왜 14개인가 하면… 22~35번 코드를 살펴보면 쉽게 이해할 수 있습니다. 우리는 파이차트를 그릴 것인데.. 이 차트를 구성하는 각 항목이 총 14개이고.. 나이대별(4세 이하, 5~9세 등등) 항목으로 구성하게 됩니다. 각 항목에 대해 앞서 생성해 놓은 채움심벌을 각각 지정해 놓고 있습니다. 이러한 설정이 적동된 차트레이어를 37번 코드를 통해 레이어로써 추가해 놓습니다. 이제 차트 레이어까지 추가되어 차트를 구성하기 위한 준비가 끝났군요! 다음으로 차트표시 버튼에 대한 이벤트 코드를 살펴봄으로써 차트를 어떻게 표현하는지 알아보겠습니다!

protected function onChartClick(event:MouseEvent):void
{
    var chartLyr:XrChartLayer = map.layers.getLayer("chart") as XrChartLayer;
    if(chartLyr == null) return;
    chartLyr.items.clear();
    
    var shpLyr:XrShapeMapLayer = 
        map.layers.getLayer("population") as XrShapeMapLayer;
    if(shpLyr != null)
    {
        var shpRows:Object = shpLyr.shapeSet.rows;
        for(var key:String in shpRows)   
        {    
            var shp:XrShape = shpRows[key] as XrShape; 
            var centroid:XrCoordinate = shp.centroid;
            if(shp != null)
            {
                var fid:int = shp.fid;
                var row:XrAttribute = shpLyr.attributeSet.rows[fid] as XrAttribute;
                if(row != null)
                {
                    var fs:XrFieldSet = shpLyr.attributeSet.fieldSet;
                    var A00_01:int = fs.getFieldIndex("A00_01");
                    var A00_02:int = fs.getFieldIndex("A00_02");
                    var A00_03:int = fs.getFieldIndex("A00_03");
                    var A00_04:int = fs.getFieldIndex("A00_04");
                    var A00_05:int = fs.getFieldIndex("A00_05");
                    var A00_06:int = fs.getFieldIndex("A00_06");
                    var A00_07:int = fs.getFieldIndex("A00_07");
                    var A00_08:int = fs.getFieldIndex("A00_08");
                    var A00_09:int = fs.getFieldIndex("A00_09");
                    var A00_10:int = fs.getFieldIndex("A00_10");
                    var A00_11:int = fs.getFieldIndex("A00_11");
                    var A00_12:int = fs.getFieldIndex("A00_12");
                    var A00_13:int = fs.getFieldIndex("A00_13");
                    var A00_14:int = fs.getFieldIndex("A00_14");  

                    var A00_01_value:Number = row.getValueAsDouble(A00_01);
                    var A00_02_value:Number = row.getValueAsDouble(A00_02);
                    var A00_03_value:Number = row.getValueAsDouble(A00_03);
                    var A00_04_value:Number = row.getValueAsDouble(A00_04);
                    var A00_05_value:Number = row.getValueAsDouble(A00_05);
                    var A00_06_value:Number = row.getValueAsDouble(A00_06);
                    var A00_07_value:Number = row.getValueAsDouble(A00_07);
                    var A00_08_value:Number = row.getValueAsDouble(A00_08);
                    var A00_09_value:Number = row.getValueAsDouble(A00_09);
                    var A00_10_value:Number = row.getValueAsDouble(A00_10);
                    var A00_11_value:Number = row.getValueAsDouble(A00_11);
                    var A00_12_value:Number = row.getValueAsDouble(A00_12);
                    var A00_13_value:Number = row.getValueAsDouble(A00_13);
                    var A00_14_value:Number = row.getValueAsDouble(A00_14);
        
                    chartLyr.items.add(new XrChartItem(null, 
                    [
                        A00_01_value, A00_02_value, A00_03_value, A00_04_value, 
                        A00_05_value, A00_06_value, A00_07_value, A00_08_value, 
                        A00_09_value, A00_10_value, A00_11_value, A00_12_value,
                        A00_13_value, A00_14_value
                    ], centroid));
                } 
            }
        }
     
        if(!chartLyr.items.build())
        {
             trace("Chart Building Error!");
        }
     
        map.update(false);
    }
}

코드가 상당히 긴편인데요. 실제로 참조하는 속성값이 14개나 되기때문에 길어보일뿐입니다. 하나 하나 살펴보면 단순합니다. 먼저 3번코드는 앞서 추가한 차트 레이어를 구합니다. 그리고 5번 코드를 통해 기존의 차트 데이터를 깨끗하게 지움니다. 이렇게 지우니 매번 버튼을 누를때마다 새롭게 차트를 구성할 수 있게 됩니다. 7번 코드는 차트를 구성하기 위한 수치 데이터를 참조할 Shape 맵 레이어를 구합니다. 12번 코드에 대한 반복문을 통해 Shape 맵 레이어를 구성하는 모든 도형에 대한 중심점(15번 코드)와 이 도형의 fid를 통해 얻은 속성값(19번 코드)를 통해 차트를 구성하게 됩니다. 참고로 앞서 모든 도형이라고 언급했으나 실제로는 화면상에 표시되는 도형입니다. 화면 밖의 표시되지 않은 도형은 해당사항이 없습니다. 23~36번 코드가 앞서 언급한 총 14개의 통계값을 읽기 위한 필드 인덱스를 구하는 코드들이고 실제 통계 데이터를 가져오는 코드는 38~51번 코드들입니다. 이렇게 구한 통계 값들을 53번 코드를 통해 지정하여 차트의 아이템으로써 도형의 중심점 좌표와 함께 추가해 줍니다. 최종적으로 차트 아이템들이 추가 완료되면 64번 코드를 통해 새롭게 재구성해 줘야 합니다. 이 재구성이 완료되면 차트가 화면상에 짠~ 하고 표시됩니다. 이제 이 차트 레이어에 대한 범례 구성을 위한 범례표시 버튼에 대해 이벤트 코드에 대해 살펴보겠습니다.

protected function onLegendClick(event:MouseEvent):void
{
    var legend:XrLegend = new XrLegend("legend");
    
    var vbox:XrVAlignLegendItemGroup = new XrVAlignLegendItemGroup();
    legend.content = vbox;
    
    var fontSym_title:XrFontSymbol = 
        new XrFontSymbol({fontName:"HY견고딕", fontSize:15});
    var text_title:XrTextLegendItem = 
        new XrTextLegendItem("차트 범례", fontSym_title);
    text_title.centerAlign = true;
    text_title.fillParentWidth = true;
    vbox.addItem(text_title);
    
    var lineSym_bar:XrLineSymbol = 
        new XrLineSymbol({lineColor:0x000000, lineThickness:1});
    var bar:XrBarLegendItem = new XrBarLegendItem(true, lineSym_bar);
    vbox.addItem(bar);
    
    var fontSym_Content:XrFontSymbol = 
        new XrFontSymbol(
            {fontName:"맑은 고딕", bold:true, fontSize:9, fontColor:0x000000}
        );
    var chartLyr:XrChartLayer = map.layers.getLayer("chart") as XrChartLayer;
    var chartLgd:XrPieChartLegendItem = 
        new XrPieChartLegendItem(chartLyr, 100, 100, fontSym_Content);
    chartLgd.marginLeft = 75;
    chartLgd.marginRight = 75;
    chartLgd.marginTop = 20;
    chartLgd.marginBottom = 20;
    vbox.addItem(chartLgd);
    
    legend.position.horizontalAlignment=XrRelativePosition.HORIZONTAL_ALIGN_LEFT;
    legend.position.verticalAlignment=XrRelativePosition.VERTICAL_ALIGN_BOTTOM;

    map.legends.addLegend(legend);
}  

차트 레이어에 대한 범례 구성은 듀라맵의 레이아웃 구성 기법에 유사합니다. 이에 대한 자세한 내용은

DuraMap-Xr, 통계 데이터를 이용한 주제도 작성을 참고하시기 바랍니다. 다른 점은 차트 레이어에 대해 특별하게 제공되는 범례 구성 항목으로써 XrPieChartLegendItem이 있으며 이 항목을 차트레이어와 연계하여 쉽게 차트 범례를 구성할 수 있습니다.

이상으로 Xr 솔루션 중 RIA 기반의  GIS 솔루션을 담당하는 핑거아이즈에 대한 기본적인 API 사용법에 대한 포스팅을 마무리 하도록 하겠습니다.