[태그:] FingerEyes

Geometry로 Feature를 가져온다는 의미는 임의의 지오메트리와 공간상에서 교차하는 Feature를 가져온다는 의미입니다. 임의의 지오메트리이므로 폴리곤, 폴리라인, 포인트 등 제약이 없습니다. 기준 지오메트리는 WKT 형식으로 쉽게 지정할 수 있습니다. 다음은 지정한 폴리라인과 교차하는 Feature를 서버측으로부터 가져오라는 코드 예입니다.

var pnuLyr:XrShapeMapLayer = map.layers.getLayer("JIBUN") as XrShapeMapLayer;
if(pnuLyr != null)
{
    var bOK:Boolean = pnuLyr.queryByGeometry(
        "LINESTRING(250661 54225, 250343 53233)",
        true,
        callback);

    if(!bOK)
    {
        // Error !
    }
}

대상이 되는 레이어를 1번 코드를 통해 가져옵니다. 속성과 도형에 대한 기능이므로 XrShapeMapLayer만이 가능합니다. 그리고 4번에서 queryByGeometry 매서드를 통해 쿼리 합니다. 첫번째 인자는 기준 지오메트리로써 WKT 형식으로 지정합니다. 그리고 두번째 인자는 도형 데이터 뿐만 아니라 속성 데이터까지 가져오라는 의미입니다. 그리고 세번째 인자는 공간 데이터 쿼리가 완료되었을때 발생하는 콜백함수이며 아래는 그 예입니다.

private function callback(arg:XrSpatialQueryResult):void  
{   
    if(arg != null)   
    {   
        var shp:IXrShape = null;   
        var shapes:Object = arg.shapeSet.rows;   
        for each(shp in shapes)   
        {   
            var attribute:XrAttributes =    
                arg.attributeSet.rows[shp.fid] as XrAttribute;   
            if(attribute != null)   
            {   
                trace(shp.centroid.x + " " + shp.centroid.y    
                    + " " + attribute.getValueAsString(1));   
            }   
        }   
    }   
    else  
    {   
        // 아무것도 오질 않았음..   
    }   
}  

서버 측으로 받은 결과에서 도형의 중심점과 2번째 속성값만을 확인하는 예입니다.

FID값은 FeatureID로써 이 값에 대한 Feature를 가져오는 예제 코드입니다. 참고로 Feature는 공간 데이터 + 속성 데이터의 셋입니다.

var pnuLyr:XrShapeMapLayer = map.layers.getLayer("JIBUN") as XrShapeMapLayer;
if(pnuLyr != null) {
    var fids:Vector. = new Vector.();
    fids.push(100, 200, 300, 400, 500, 600, 700, 10000);
    if(!pnuLyr.queryByFIDs(fids, true, callback))
    {
        // Query Request Error !!
    }
}

먼저 대상 레이어를 파악해야 합니다. FID에 관련된 레이어이므로 1번 코드에서 XrShapeMapLayer가 필요하고 요청할 FID의 리스트를 3~4번에서 만들고 있습니다. 그리고 5번 코드에서 queryByFIDs 매서드를 통해 리퀘스트를 서버에 날립니다.

서버에 대한 응답은 비동기적으로 처리되므로 콜백함수가 필요하며 queryByFIDs의 세번째 인자에 지정합니다. 두번째 인자는 공간 데이터 뿐만 아니라 속성 데이터까지 가져오라는 의미입니다. 그렇다면 서버로부터 받은 Feature를 처리하기 위한 콜백함수를 살펴보면, 그 예는 다음과 같습니다.

private function callback(arg:XrSpatialQueryResult):void
{
    if(arg != null)
    {
        var shp:IXrShape = null;
        var shapes:Object = arg.shapeSet.rows;
        for each(shp in shapes)
        {
            var attribute:XrAttributes = 
                arg.attributeSet.rows[shp.fid] as XrAttribute;
            if(attribute != null)
            {
                trace(shp.centroid.x + " " + shp.centroid.y 
                    + " " + attribute.getValueAsString(1));
            }
        }
    }
    else
    {
        // 아무것도 오질 않았음..
    }
}

결과가 오면 도형의 중심점과 두번째 속성값을 표시하는 코드입니다.

핑거아이즈는 서버측의 DBMS에 UPDATE, INSERT, DELETE와 같은 SQL 문을 실행할 수 있도록 요청할 수 있습니다. 다음 코드는 그 예입니다.

var svc:XrUpdateTableService = new XrUpdateTableService(
    "127.0.0.1:8076",
    "postgis",
    __completed,
    __error
);

var sql:String = "INSERT INTO tstTbl VALUES (100, '안녕하세요!')";

svc.run({sql:sql});

SQL문의 실행을 서버측에 요청하고 그 결과를 받아오는 일련의 과정을 사용하기 쉽게 캡슐화된 XrUpdateTableService 클래스를 이용합니다. 서버의 IP와 사용하는 DBMS의 종류 그리고 SQL 문이 서버측에서 성공적으로 실행되었을때와 실패했을때에 대한 콜백함수를 생성자의 인자로 지정합니다.

아래는 SQL문이 성공적으로 실행되었을때와 실패했을때에 대한 콜백함수의 예입니다.

protected function __completed(cntRowUpdated:uint):void
{
    // cntRowUpdated는 SQL문의 실행에 의해 영향을 받은 Row의 수
}

protected function __error():void
{
    // SQL 실행하는데 문제 있음
}

핑거아이즈에서 마우스로 거리와 면적을 측정하는 방법에 대한 설명입니다. 펑거아이즈는 면적과 거리에 대해서도 스냅핑 기능을 적용할 수 있음으로 보다 정확하게 면적과 거리를 측정할 수 있습니다. 예를 들어 지적도를 대상으로 스냅핑을 적용할 경우 면적과 거리를 마우스를 이용해 측정할때 지적도의 도형의 정점이나 선분에 스냅핑되어 지적도를 정확히 참조하여 거리와 면적을 측정할 수 있습니다.

핑거아이즈의 거리와 면적의 측정은 매쉬업 레이어를 대상으로 작동합니다. 그러므로 거리와 면적을 측정하기 위해서는 지도 컴포넌트에 XrMashupLayer 클래스를 통해 매쉬업 레이어를 추가해야 합니다. 아래의 코드는 “mashup”이라는 레이어 고유 식별자를 지정하여 매쉬업 레이어를 추가하는 코드입니다. 레이어 고유 식별자는 임이의 문자열로 지정 가능하며 각 레이어 마다 고유해야 합니다.

var ml:XrMashupLayer = new XrMashupLayer("mashup");
map.layers.addLayer(ml);
map.edit.targetLayer = ml;

보시면, 매쉬업 레이어를 추가한 후에 편집 대상 레이어로써 추가한 매쉬업 레이어를 지정해 줘야 합니다. 면적 측정이나 거리 측정은 마우스를 통한 새로운 폴리곤과 폴리라인을 만들어 내는 작업이므로 간단한 편집 기능으로 분류되기 때문입니다.

이제 거리와 면적을 측정하는 코드에 대해 살펴보겠습니다. 먼저 면적을 측정하기 위한 버튼을 클릭하게 되면 발생하는 클릭 이벤트 처리 함수에 대해 다음처럼 코딩합니다.

private function onAddPolygon(event:MouseEvent):void
{
    map.edit.editMode = true;
    var id:uint = fid++;
    var bOK:Boolean = map.edit.addPolygon(id, true);
    if(!bOK)
    {
        trace("폴리곤 매쉬업 실패");
    }
}

먼저 3번 코드를 통해 맵의 상태를 편집 상태로 지정합니다. 편집 상태가 되면 마우스에 대한 조작은 모두 편집 행위로 간주됩니다. 다시 지도를 확대하고 축소하고 이동하려면 editMode를 false로 지정해 주면 됩니다. 그리고 4번 코드를 통해 고유한 id 값을 하나 만듭니다. fid 변수는 int 타입의 전역 변수로써 계속 1씩 증가해 중복되지 않은 값을 유지합니다. 물론 정말 중복되지 않도록 하려면 필요할 경우 다양한 방법이 적용되어야 할 것입니다. 5번 코드는 폴리곤을 그리라는 코드로써 앞서 만들어 놓은 중복되지 않는 정수값 인자 하나와 true 값 인자가 사용됩니다. 중요한 것이 바로 이 두번째 인자인 true입니다. true값이 지정되면 그래픽 요소를 그릴때 그래픽 요소에 관련된 측정값이 함께 표시됩니다. 여기서는 폴리곤이므로 폴리곤의 면적이 표시됩니다. 아래의 이미지는 면적 측정 버튼을 누른후 마우스 클릭을 통해 면적을 측정하는 화면입니다.

다음은 거리를 측정하는 코드입니다.

private function onAddPolyline(event:MouseEvent):void
{
    map.edit.editMode = true;
    var id:uint = fid++;
    var bOK:Boolean = map.edit.addPolyline(id, true);
    if(!bOK)
    {
        trace("폴리라인 매쉬업 실패");
    }
}

면적 측정과 다른 부분은 5번 코드 뿐입니다. 즉, addPolygon 대신에 거리 측정에 대한 폴리라인인 addPolyline 매서드로 대체되었습니다. 아래의 그림은 거리 측정 버튼을 클릭하고 마우스로 거리를 측정하는 화면입니다.