[GIS] FingerEyes, 매쉬업 레이어 추가 및 코드를 통한 매쉬업

이해하기 쉽고.. 소개하는데 좀더 효율적인 방법을 위해 글의 진행 순서를 결과를 먼저 보이고.. 결과를 얻기 위한 방법을 제시하는 것으로 하겠습니다. 결과에 대한 화면은 아래와 같습니다.

사용자 삽입 이미지실행 결과 보기 및 소스코드 다운로드

자 이제, 스피드하게 진행하도록 하겠습니다. ^^ MXML Application을 추가하고 기본이 되는 코드로써 어플리케이션의 initialize 이벤트에 다음과 같은 코드를 작성합니다.

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(305849, 547877));
    map.viewControls.scaleLevel = 0;
}

배경도로 타일맵을 깔아줬으며 초기 지도 위치와 축척 레벨을 지정하고 있습니다. 참고로 import해야할 클래스는 다음과 같습니다.

import geoservice.view.layers.*;
import geoservice.base.*;
import geoservice.controls.*;

이제 다음으로 위의 onInit 함수에 매쉬업으르 위한 레이어인 XrMashupLayer를 추가하는 코드를 작성합니다.

protected function onInit(event:FlexEvent):void
{
    ...

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

여기까지 실행해 보면 다음처럼 타일맵 레이어만이 표시됩니다. 매쉬업 레이어는 아무 것도 매쉬업 하지 않았으므로 표시될것이 없지요.

사용자 삽입 이미지
이제 위의 지도 위에 매쉬업레이어를 통해 원하는 정보를 매쉬업하는 코드를 작성해 보도록 하겠습니다.

가장 먼저 타원 모양의 매쉬업을 추가하는 코드입니다. 간단히 하기 위해 매쉬업을 추가하는 코드는 매쉬업 레어어를 추가하는 코드 바로 다음에 입력하도록 하겠습니다.

var item1:IXrMashup = 
    new XrEllipseMashup(0, new XrCoordinate(472780, 428800), 30000, 15000, false);
item1.fillSymbol = new XrFillSymbol({fillColor:0xff0000, fillAlpha:0.8});
item1.lineSymbol = 
    new XrLineSymbol({lineThickness:2.0, lineAlpha:1.0, lineColor:0x000000});
(item1 as Sprite).filters = [ new DropShadowFilter(3, 45, 0, 0.6) ];
ml.addMashup(item1);

타원 매쉬업을 위해 1번 코드에서 XrEllipseMashup 클래스를 통해 매쉬업을 생성하고 있습니다. 생성자의 첫번째 인수는 고유한 ID값으로 이 값을 통해 추후 매쉬업 항목을 참조할 수 있습니다. 두번째 코드는 타원의 중심점이고 세번째와 네번째는 가로 너비와 세로 너비입니다. 마지막 인자는 타원에 대한 정보(넓이등)에 대한 값을 함께 표시하는 진위형 값입니다. 그리고 매쉬업을 위한 그리기 심벌을 지정하고 있으며 이렇게 만들어진 매쉬업(IXrMashup 타입)은 매쉬업 레이어에 addMashup 매서드를 통해 추가됩니다.

다음으로 정방형 원을 매쉬업하는 코드입니다.

var item2:IXrMashup = 
    new XrCircleMashup(1, new XrCoordinate(653319, 546113), 10000, false);
item2.fillSymbol = new XrFillSymbol({fillColor:0xffff000, fillAlpha:0.5});
item2.lineSymbol = 
    new XrLineSymbol({lineThickness:2.0, lineAlpha:1.0, lineColor:0xffffff});
ml.addMashup(item2);
(item2 as Sprite).filters = [ new DropShadowFilter(3, 45, 0, 0.6) ];

정방형 매쉬업을 위해 XrCircleMashup 클래스를 통해 매쉬업 항목을 생성했는데… 생성자의 첫번째 인자는 ID이며 두번째는 원의 중심점 그리고 세번째는 반지름입니다.

다음은 직사각형 매쉬업을 위한 코드입니다.

var item3:IXrMashup = 
    new XrRectangleMashup(2, 501727, 358703, 30000, 40000, false);
item3.fillSymbol = new XrFillSymbol({fillColor:0x0000ff, fillAlpha:0.7});
item3.lineSymbol = 
    new XrLineSymbol({lineThickness:2.0, lineAlpha:1.0, lineColor:0xffffff});
ml.addMashup(item3);
(item3 as Sprite).filters = [ new DropShadowFilter(3, 45, 0, 0.6) ];

직사각형 매쉬업은 XrRectangleMashup 클래스로 생성하며 생성자의 인자는 ID와 사각형의 left, top 그리고 width와 height 값 등을 지정하면 됩니다.

다음은 폴리라인 매쉬업을 위한 코드입니다.

var polylines:Array = [ 
    [
        new XrCoordinate(435356, 577345), 
        new XrCoordinate(363847, 463841), 
        new XrCoordinate(419456, 329770) 
    ]];
var item4:IXrMashup = new XrPolylineMashup(7, polylines, false);
item4.lineSymbol = 
    new XrLineSymbol({lineThickness:5.0, lineAlpha:1.0, lineColor:0x00ff00});
ml.addMashup(item4);
(item4 as Sprite).filters = [ new DropShadowFilter(3, 45, 0, 0.6) ]; 

1번 코드에서 폴리라인을 구성하는 정점을 정의하고 폴리라인 매쉬업을 위해 XrPolylineMashup 클래스를 통해 매쉬업 아이템을 생성하고 있습니다. 생성자의 인자는 ID와 1번 코드에서 정의한 폴리라인을 구성하는 정점 정보 등입니다.

다음은 폴리곤 매쉬업을 위한 코드입니다.

var polygons:Array = [
    [
        new XrCoordinate(366894, 488218), 
        new XrCoordinate(398126, 479077),
        new XrCoordinate(374511, 453938), 
        new XrCoordinate(356229, 461556)
    ]];
var item5:IXrMashup = new XrPolygonMashup(8, polygons, false);
item5.lineSymbol = 
    new XrLineSymbol({lineThickness:5.0, lineAlpha:1.0, lineColor:0xffff00});
item5.fillSymbol = new XrFillSymbol({fillColor:0xff00000, fillAlpha:1.0});
ml.addMashup(item5);
(item5 as Sprite).filters = [ new DropShadowFilter(3, 45, 0, 0.6) ];

이제 포인트 매쉬업에 대해서 알아보도록 하겠습니다. 포인트는 매쉬업에서 마커(Marker) 개념으로 접근할 수 있습니다. FingerEyes에서는 마커의 종류는 원, 사각형, 이미지, 텍스트가 가능합니다. 아래는 순서대로 원, 사각형, 이미지를 매쉬업하는 코드입니다.

// 사각형 마커 매쉬업
var item6:IXrMashup = 
    new XrMarkerMashup(3, new XrCoordinate(303667, 411279), false);
item6.fillSymbol = new XrFillSymbol({fillColor:0xffff000, fillAlpha:1.0});
item6.lineSymbol = 
    new XrLineSymbol({lineThickness:2.0, lineAlpha:1.0, lineColor:0x000000});
item6.markerSymbol = new XrRectangleMarkerSymbol(null);
ml.addMashup(item6);
(item6 as Sprite).filters = [ new DropShadowFilter(3, 45, 0, 0.6) ];

// 원형 마커 매쉬업
var item7:IXrMashup = 
    new XrMarkerMashup(4, new XrCoordinate(512233, 598750), false);
item7.fillSymbol = new XrFillSymbol({fillColor:0xff00000, fillAlpha:1.0});
item7.lineSymbol = 
    new XrLineSymbol({lineThickness:2.0, lineAlpha:1.0, lineColor:0x000000});
item7.markerSymbol = new XrCircleMarkerSymbol(null);
ml.addMashup(item7);
(item7 as Sprite).filters = [ new DropShadowFilter(3, 45, 0, 0.6) ];

// 이미지 마커 매쉬업
var item8:IXrMashup = 
    new XrMarkerMashup(5, new XrCoordinate(312315, 548750), false);
item8.markerSymbol = new XrImageMarkerSymbol(
    {border:4, markerUrl:"http://www.geoservice.co.kr/gsy.jpg"});
ml.addMashup(item8);
(item8 as Sprite).filters = [ new DropShadowFilter(4, 45, 0, 0.6, 18, 18) ];

마커는 일단 XrMarkerMashup 클래스로 생성하며 생성자의 인자로 마커의 위치 등을 받습니다. 마커의 모양을 지정하기 위해 markerSymbol에 원하는 마커를 지정해 주게 됩니다. 사각형 모양의 경우 XrRectangleMarkerSymbol이며 원형은 XrCircleMarkerSymbol 그리고 이미지는 XrImageMarkerSymbol 클래스를 통해 지정됩니다.

[GIS] GeoTools를 이용해 SHP, DBF 파일 읽기

GeoTools(http://www.geotools.org)는 자바 기반의 GIS 시스템을 구축할 수 있는 다양한 기능을 갖춘 오픈소스입니다. 제가 처음 GeoTools에 관심을 가졌던 이유는 SHP 파일을 읽기 위한 자바 라이브러리가 필요해서 였는데요. 이 기능을 파악하기 위해 테스트로 작성했던 코드를 공유해 봅니다.

먼저 SHP 파일에서 좌표를 읽어 들이는 코드입니다.

import java.io.IOException;
import java.net.MalformedURLException;

import org.geotools.data.shapefile.shp.ShapefileException;
import org.geotools.data.shapefile.shp.ShapefileReader;
import org.geotools.data.shapefile.shp.ShapefileReader.Record;
import org.geotools.data.shapefile.ShpFiles;

import com.vividsolutions.jts.geom.Geometry;
import com.vividsolutions.jts.geom.GeometryFactory;
import com.vividsolutions.jts.geom.Point;

public class ShapefileReaderTestMainEntry {
    public static void main(String[] args) {
        ShapefileReader r = null;
        try {
            ShpFiles shpFile = new ShpFiles("G:\\__Data__\\dong.shp");

            GeometryFactory geometryFactory = new GeometryFactory();
            r = new ShapefileReader(shpFile, true, false, geometryFactory);

            while (r.hasNext()) {
                Record record = r.nextRecord();
                Geometry shape = (Geometry)record.shape();
                Point centroid = shape.getCentroid();
                System.out.println(
                    "(" 
                    + centroid.getX() 
                    + ", " 
                    + centroid.getY() 
                    + ")"
                );
            }
            r.close();
        } catch (MalformedURLException e1) {
            e1.printStackTrace();   
        } catch (ShapefileException e) {
            e.printStackTrace();
        } catch (IOException e) {
            e.printStackTrace();
        };
    }
}

다음으로는 DBF 파일에서 값을 읽어 들이는 코드입니다.

import java.io.IOException;
import java.net.MalformedURLException;
import java.nio.charset.Charset;

import org.geotools.data.shapefile.ShpFiles;
import org.geotools.data.shapefile.dbf.DbaseFileHeader;
import org.geotools.data.shapefile.dbf.DbaseFileReader;

public class DbaseFileReaderTestMainEntry {
    public static void main(String[] args) {
        DbaseFileReader r = null;
        try {
            ShpFiles shpFile = new ShpFiles("G:\\__Data__\\dong.shp");
            r = new DbaseFileReader(shpFile, false, Charset.defaultCharset());
            DbaseFileHeader header = r.getHeader();

            int numFields = header.getNumFields();
            for(int iField=0; iField < numFields; ++iField) {
                String fieldName = header.getFieldName(iField);
                System.out.println(fieldName);
            }

            while (r.hasNext()) {
                Object[] values = r.readEntry();
                for(int iField=0; iField < numFields; ++iField) {
                    System.out.println(values[iField].toString());
                }
                System.out.println("---------------");
            }

            r.close();
        } catch (MalformedURLException e) {
            e.printStackTrace();
        } catch (IOException e) {
            e.printStackTrace();
        }  
    }
}

[GIS] FingerEyes, 수치지도 레이어 추가하기

수치지도 레이어는  이미지로 만들어진 지도가 아닌 좌표값으로 구성된 지도 레이어를 의미하며 핑거아이즈에서는 Shape Map Layer라고 불립니다. 이 글은 ShapeMapLayer를 추가하는 API에 대해 설명합니다.

먼저 실습을 위해 FingerEyes, 타일맵 레이어 추가을 통해 만들어진 소스 코드를 토대로 하겠습니다. 토대가 되는 소스 코드는 FingerEyes, 타일맵 레이어 추가를 통해 다운로드 받으실 수도 있습니다.

여타 다른 레이어와 마찬가지로 ShapeMapLayer 역시 어플리케이션이 초기화 되는 시점에서 추가하는 것이 적당합니다. 해서 Application의 initialize 이벤트에 대해 이미 지정된 onInit 함수에서 ShapeMapLayer를 추가하는 코드를 작성하면 다음과 같습니다.

protected function onInit(event:FlexEvent):void
{
    ....

    var shapeLyr:XrShapeMapLayer = new XrShapeMapLayer("road", 
        "http://www.geoservice.co.kr:8080/Xr?layerName=road_line");
    shapeLyr.theme.properties = 
        {lineThickness:4.0, lineAlpha:1.0, lineColor:0xff2222};
    map.layers.addLayer(shapeLyr);
}

수치지도맵 레이어에 대한 클래스 타입은 XrShapeMapLayer로써 레이어 이름과 지도 데이터에 연결하기 위한 연결 문자열(Connection String)을 갖습니다. 레이어의 이름은 road라고 이해하기 쉬운 단어로써 원하는 값으로 지정했으며 연결 문자열은 지도 데이터 서버와 지도 데이터 서버(http://www.geoservice.co.kr:8080/Xr)에서 제공하는 데이어명(road_line)으로 구성됩니다.

ShapeMapLayer는 타일맵 레이어처럼 이미지로써 이미 만들어진 레이어가 아니므로 원하는 색상등과 같은 심벌로 그릴 수 있으며 이런 심벌을 지정하기 위해 XrShapeMapLayer의 theme 속성을 사용합니다. 7번 코드가 여기에 해당하는데 추가하고자 하는 수치지도가 폴리라인 형태이므로 선의 굵기를 4로 지정했으며 선의 투명알파값을 1.0로 지정하여 불투명하게 했으며 선의 색상값을 빨간색계열로 지정했습니다. 이렇게 생성된 레이어를 8번 코드에서처럼 추가하면 기본적인 수치지도 레이어가 화면상에 표시됩니다.

사용자 삽입 이미지
여기까지가 기본적인 수치지도 레이어를 추가하는 방법이고 이제 이렇게 추가한 수치지도를 원하는 축척 단계에서 표시하는 API 사용에 대해 설명하도록 하겠습니다.

먼저 핑거아이즈에서 축척 단계에 대한 이해가 필요합니다. onInit 함수 안에는 다음과 같은 코드가 있습니다.

map.viewControls.scaleLevels = [120000, 60000, 25000, 15000, 7000, 2500, 1200];
map.viewControls.scaleLevel = 5;

1:120000, 1:60000, 1:25000, 1:15000, 1:7000, 1:2500, 1:1200에 대한 축척 레벨을 지정했으며 현재의 축척 레벨을 5번인 1:2500으로 지정하고 있습니다. 즉 축척 레벨의 번호는 0부터 시작하여 구성되며 지정할 수 있습니다.

여기서 앞서 추가한 수치지도 레이어를 축척 레벨이 4~6번일때문 화면상에 표시되도록 하기 위해 다음 코드를 레이어를 생성하는 코드 바로 아래에 추가합니다.

shapeLyr.visibleByLevel = true;
shapeLyr.fromVisibleLevel = 4;
shapeLyr.toVisibleLevel = 6;

이제 다음으로 수치지도에 라벨을 달아 보도록 하겠습니다. 수치지도는 지도를 구성하는 좌표뿐만 아니라 속성값에 대한 데이터도 가지고 있으며 이 속성 데이터를 지도 위에 표시할 수 있습니다. 우리가 추가한 수치지도는 도로에 대한 중심선으로써 도로명을 표시해 보도록 하겠습니다. 수치지도에 대해 라벨을 지정하는 코드는 다음과 같으며 레이어를 생성하는 코드 바로 아래에 추가하면 됩니다.

shapeLyr.label.enable = true;
shapeLyr.label.fieldName = "RD_NM";    
shapeLyr.label.visibleByLevel = true;
shapeLyr.label.fromVisibleLevel = 4;
shapeLyr.label.toVisibleLevel = 6;

1번 코드는 라벨을 사용하겠다는 의미이며 2번 코드는 도로명에 대한 필드명입니다. 그리고 3번 코드는 축척 레벨에 따라 라벨을 보이겠다는 의미이며 4번과 5번 코드에 축척 레벨의 범위를 지정해 줍니다. 이제 실행해 보면 다음 처럼 라벨이 표시됩니다.

사용자 삽입 이미지
이상으로 핑거아이즈에서 수치지도맵 레이어인 ShapeMapLayer를 추가하는 방법에 대한 대략적인 설명을 마무리 하면서…. 수치지도맵 레이어는 범용 GIS 엔진이라면 반드시 갖춰야 하는 레이어입니다. 이 수치지도레이어를 잘 활용하면 방대한 데이터를 처리할 수 있는 GIS 시스템을 쉽게 구현할 수 있습니다.

예를 들어서 새로운 도로나 건물 등을 새롭게 추가하거나 편집할 수 있으며 도로나 건물에 대한 속성값을 마우스로 클릭하여 사용자에게 제공할 수 있습니다. ShapeMapLayer는 TileMapLayer와 달리 자주 변경되는 공간데이터를 표현하는데 매우 효율적인 레이어입니다.

사용자 삽입 이미지
실행 결과 및 소스 코드 보기

[GIS] FingerEyes, 스케일바, 줌레벨 컨트롤바, 인덱스맵컨트롤 추가하기

사용자가 직관적이고 효율적으로 지도뷰를 조작하고 현재 지도뷰에 대한 정보를 얻기 위해 필요한 컨트롤들은 다음과 같습니다.

  • 스케일바 컨트롤(Scale Bar Control)
  • 줌레벨 컨트롤(Zoom Level Control)
  • 인덱스맵 컨트롤(Index Map
    Control)

스케일바 컨트롤은 현재 지도에 대한 축척값에 대한 정보를 제공하며 줌레벨 컨트롤은 현재 지도의 축척 레벨을 마우스를 통해 조절하기 위한 컨트롤입니다. 그리고 인덱스맵 컨트롤은 현재 보고 있는 지도가 어느 위치에 해당하는지에 대한 정보를 제공하며 아울러 손쉽고 빠르게 원하는 위치로 지도뷰를 변경할 수 있습니다.

사용자 삽입 이미지
이 글은 핑거아이즈(FingerEyes)에서 이러한 컨트롤을 지도 상에 추가하기 위한 방법에 대한 내용입니다. 또한 이 글은 기본적으로 타일맵 레이어 추가하기(FingerEyes, 타일맵 레이어 추가)에서 실습한 코드를 토대로 진행됩니다. 즉, 기본적인 배경도로써 타일맵 레이어가 하나 추가된 상태에서 시작됩니다.

스케일바 컨트롤과 줌레벨 그리고 인덱스맵 컨트롤이 추가되는 시점은 어플리케이션이 초기화될때가 가장 적당합니다. 해서.. 어플리케이션의 초기화 이벤트인 initialize에 컨트롤을 추가하는 코드를 작성합니다. 먼저 스케일바 컨트롤을 추가하는 코드는 다음과 같습니다.

protected function onInit(event:FlexEvent):void
{
    ....

    var sbc:IXrViewControl = new XrScaleBarControl("scalebar");
    map.viewControls.addControl(sbc);
}

스케일바는 XrScaleBarControl 클래스로 생성하며 생성자의 인자는 이름으로써 개발자가 원하는 이름을 지어주면 됩니다.  이렇게 생성한 컨트롤을 map의 viewControls 프로퍼트 객체의 addControl 매서드를 통해 추가해 줍니다.

이제 다음으로 줌레벨 컨트롤을 추가하는 코드를 살펴 보도록 하겠습니다.

protected function onInit(event:FlexEvent):void
{
        ....

    var zlc:IXrViewControl = new XrZoomLevelControl("zoomcontrol");
    map.viewControls.addControl(zlc);
}

줌 레벨 컨트롤은 XrZoomLevelControl 클래스를 통해 생성되며 생성자의 인자 및 추가하는 방식은 앞의 스케일바 컨트롤과 동일합니다.

이제 마지막으로 인덱스맵 컨트롤을 추가하는 코드를 살펴보겠습니다.

protected function onInit(event:FlexEvent):void
{
         ....

    var imc:XrIndexMapControl = new XrIndexMapControl("indexmap", 200, 150);
    var indexLyr:XrShapeMapLayer = new XrShapeMapLayer("INDEXMAP", 
        http://www.geoservice.co.kr:8080/Xr?layerName=seoul_index);
    indexLyr.theme.properties = {
        lineThickness:1.0, lineAlpha:1.0, lineColor:0x999999, 
        fillColor:0xeeeeee, fillAlpha:1.0
    };

    map.viewControls.addControl(imc);
    imc.setIndexLayer(indexLyr);
}

앞서 소개한 컨트롤에 비해 다소 복잡합니다. 인덱스맵 컨트롤은 XrIndexMapControl 클래스로부터 생성되며 생성자로써 인자는 컨트롤의 이름 그리고 인덱스맵의 크기(너비와 높이)를 갖습니다. 이렇게 생성된 인덱스맵 컨트롤에 사용될 지도를 지정해야 하는데.. 지정할 지도를 생성하기 위해 지도 레이어를 추가하게 됩니다. 여러가지 지도 레이어 중에 수치지도 레이어인 XrShapeMapLayer를 인덱스맵으로 지정하고 있습니다. 6번 코드가 바로 수치지도 레이어를 생성하는 코드로써 XrShapeMapLayer의 생성자에 대한 첫번째 인자는 레이어의 이름이며 두번째 인자는 지도 데이터에 대한 연결문자열(Connection String)입니다. 이제 이 지도에 대한 그리기 심벌을 지정하기 위해 8번 코드가 사용됩니다. 이제 인덱스맵 컨트롤을 지도에 추가(13번 코드)하고 인덱스맵으로써 앞서 생성한 수치지도 레이어로 지정(14번 코드)하면 됩니다.

사용자 삽입 이미지

실행 결과 및 소스코드 보기