김형준 GIS 연구소 (for Developers) -

[BlackPoint] Identify 기능 구현

안드로이드 기반의 범용 GIS 엔진인 블랙포인트에서 SHP 파일을 화면에 표시한 뒤에 터치를 통해 도형의 속성을 확인하는 Identify 기능에 대한 API 사용 방법입니다.

먼저 터치를 통한 속성을 확인할 SHP 파일을 레이어로 추가하는 코드는 다음과 같습니다.

private void addLayer() { String ess = Environment.getExternalStorageState(); String sdCardPath = null; if(ess.equals(Environment.MEDIA_MOUNTED)) { sdCardPath = Environment.getExternalStorageDirectory().getAbsolutePath(); ShapeLayer riLayer = new ShapeLayer( "ri_layer", sdCardPath + "/external_sd/ri.shp"); LayerManager layerMan = map.getLayerManager(); layerMan.addLayer(riLayer); riLayer.setKeepShownFID(true); // Option Code SimpleDrawShapeTheme riTheme = (SimpleDrawShapeTheme)riLayer.getTheme(); riTheme.getStrokeSymbol().setWidth(2); riTheme.getStrokeSymbol().setAntiAlias(true); riTheme.getFillSymbol().setHollow(true); } } 기억해야 할 것은 추가한 레이어의 이름을 7번 코드처럼 ri_layer로 지정했다는 것과 10번 코드를 통해 화면 상에 표시되는 도형에 대한 FID를 기억해 두라는 코드입니다. 10번 코드가 꼭 필요한 것은 아니지만 속도 향상을 위해서라면 추가해 주는 것이 좋습니다. 위의 코드를 통해 레이어가 추가된 화면은 다음과 같습니다.

다음 코드는 레이어를 추가한 후에 지도의 위치를 설정해 주는 코드입니다.

private void moveMap() {
    CoordMapper coordMapper = map.getCoordMapper();

    coordMapper.moveTo(145207, 263662);
    coordMapper.zoomByMapScale(740000);
  
    map.update();
}

(145207, 263662) 좌표가 화면의 중심에 놓일 것이며 지도 축척은 1:740000이 될 것입니다. 위의 addLayer 함수와 moveMap 코드를 Activity의 onStart 함수에서 실행합니다.

@Override
public void onStart() {
    super.onStart();
    
    DisplayMetrics outMetrics = new DisplayMetrics();
    getWindowManager().getDefaultDisplay().getMetrics(outMetrics);
    int DPI = outMetrics.densityDpi;
    
    map = (XrMap)findViewById(R.id.map);
    map.setDPI(DPI);
    
    addLayer(); // 레이어 추가 !
    moveMap(); // 지도 이동 !

    map.setMouseMode(MouseMode.PickingMode);
    setTouchEvent();
}

12번과 13번 코드가 바로 레이어 추가와 지도 이동에 대한 함수입니다. 15번 코드는 블랙포인트의 맵 컴포넌트에서 터치 이벤트를 발생할 수 있도록 풀어주는 코드입니다. 15번 코드처럼 마우스 모드를 PickingMode로 지정하지 않으면 지도 조작(지도 확대/축소, 이동, 회전)으로 화면 터치 이벤트가 활용됩니다. PickingMode로 지정해 줌으로써 화면 터치가 더 이상 지도 조작 기능이 아닌 본래의 터치 이벤트 발생으로써 반응합니다. 16번 코드는 화면 터치에 대한 이벤트를 설정해 주기 위한 함수로 다음과 같습니다.

private void setTouchEvent() {
    map.setOnTapUpListener(new OnTapUpEventListener() {
        public void onTapUp(MotionEvent event) {
            boolean bDrawing = map.getRendererManager().isWorking();
            map.getRendererManager().waitForDrawing(true);
 
            String layerName = "ri_layer";
            ShapeLayer layer = (ShapeLayer)map.layers()
                .getLayerByName(layerName);
            if(layer != null) {
                PointD coord = 
                    map.getCoordMapper().V2W(
                        new PointD(event.getX(), event.getY()));
                try {
                    Vector<Integer> fids = layer.getFIDsByMapCoord(coord);
                    if(fids != null) {
                        int cntFIDs = fids.size();
                        for(int iFID=0; iFID<cntFIDs; ++iFID) {
                            ShapeAccess sa = (ShapeAccess)layer.getAccess();
                            AttributeRowSet ars = 
                                (AttributeRowSet)sa.getAttributeRowSet();
                            int FID = fids.get(iFID);
                            AttributeRow ar = sa.loadAttributeById(FID);
                            StringBuilder msg = new StringBuilder();
                            FieldSet fs = ars.getFieldSet();
                            int cntFields = fs.getFieldsCount();
            
                            for(int iField=0; iField<cntFields; ++iField) {
                                Field field = fs.getField(iField);
                                String fieldName = field.getFieldName();
                                String fieldValue = 
                                    ar.getValueAsString(iField);
             
                                msg.append(fieldName);
                                msg.append(": ");
                                msg.append(fieldValue);
                                msg.append("\n");
                            }
               
                            new AlertDialog.Builder(BP_IdentifyActivity.this)
                                .setTitle(
                                    "지번조회 결과(" + 
                                        (iFID+1) + "/" + cntFIDs + ")")
                                .setMessage(msg)
                                .setPositiveButton("확인", 
                                    new DialogInterface.OnClickListener() {
                                    public void onClick(
                                        DialogInterface dialog, 
                                        int whichButton) {}
                            }).show();
                        }
 
                        if(bDrawing) {
                            map.update();
                        }
 
                        return;
                    }
                } catch(IOException e) {
                    e.printStackTrace();
                }        
            }
    
            new AlertDialog.Builder(BP_IdentifyActivity.this)
                .setTitle("지번조회 결과")
                .setMessage("검색 결과가 없습니다.")
                .setPositiveButton("확 인", 
                    new DialogInterface.OnClickListener() {
                public void onClick(DialogInterface dialog, int whichButton) {}
            }).show();
    
            if(bDrawing) {
                map.update();
            }
        }
    });
}

코드가... 졸라맨입니다.. ㅡ_ㅜ 어렵지 않은 코드이니.. 하나 하나 설명드리면 다음과 같습니다. 2번 코드는 일반적으로 안드로이드에서 터치에 대한 TapUp 이벤크 리스너를 할당하는 코드입니다. 4번 코드는 터치가 발생하는 순간에 지도가 그려지고 있는지를 상태를 저장해 둡니다. 5번 코드는 인자를 true로 줌으로써 강제로 지도 그리기를 멈추게 합니다. 만약 false를 주면 지도 그리기가 완료될때까지 대기합니다. 7~8번 코드는 앞서 레이어를 추가할때 지정해 둔 레이어 이름으로 레이어를 얻어옵니다. 11~13번 코드는 화면 좌표를 지도 좌표로 변환하는 코드입니다. 15번 코드가 터치된 위치의 도형의 ID 목록을 얻어오는 코드입니다. 19~26번 코드는 터치된 도형의 속성을 얻기 위한 객체를 준비하는 것이고 실제 24번 코드를 통해 파일에서 속성값을 로드(load)합니다. 28~38번 코드는 속성값으로 메세지로 표시할 문자열값을 구성합니다. 그리고 40~50번 코드를 통해 문자열을 화면에 대화창으로 표시합니다. 53~55번은 앞에서 저장해둔 터치 당시에 지도 그리기 중이였다면 다시 지도를 그리도록 합니다. 그리고 57번의 return문을 통해 함수를 종료합니다. 이후의 코드는 터치한 위치에 도형이 존재하지 않는다라는 메세지를 표시하는 코드입니다. 코드보다... 설명이 더 간단하군요... ㅡOㅡ; 아래의 결과는 실제 터치를 통해 속성값 정보가 표현된 화면입니다.

장황한 설명이였지만.. 실제 코드는 어렵지 않습니다. 아래 URL을 통해 전체 소스 코드를 다운로드해 다시 살펴보시기 바랍니다.

Identify.zip

Tag : BlackPoint, GIS, Xr

posted at 2011/12/18 00:50 | GIS 개발/BlackPoint-Xr | Comment(0)

블랙포인트는 지오서비스(www.geoservice.co.kr)에서 개발한 안드로이드 기반의 GIS 엔진으로써 수치지도와 항공영상을 표시할 수 있으며 GPS로부터 위치를 받아 빠르게 자신의 위치를 지도 상에서 파악할 수 있습니다. 또한 사용자 정의 그래픽 요소를 화면 터치나 API를 통해 입력할 수 있으며 수치지도를 생성하고 편집할 수 있습니다.

아래의 코드는 블랙포인트에서 SHP 파일을 통한 레이어를 추가하는 코드입니다. SD 메모리에 존재하는 SHP 파일을 추가합니다. 레이어를 추가하고 색상 심벌과 라벨을 설정하는 전반적인 코드를 제시하고 있습니다.

String ess = Environment.getExternalStorageState();   
String sdCardPath = null;   
if(ess.equals(Environment.MEDIA_MOUNTED)) {
    sdCardPath = Environment.getExternalStorageDirectory().getAbsolutePath();
    LayerManager layerMan = map.getLayerManager();
      
    ShapeLayer buildingsLayer = new ShapeLayer(
        "buildings", 
        sdCardPath + "/external_sd/seoul/buildings.shp"
    );
    
    SimpleDrawShapeTheme buildingsTheme = 
        (SimpleDrawShapeTheme)buildingsLayer.getTheme();
    buildingsTheme.getStrokeSymbol().setWidth(1);
    buildingsTheme.getStrokeSymbol().setColor(Color.GRAY);
    buildingsTheme.getFillSymbol().setHollow(true);
    
    layerMan.addLayer(buildingsLayer);
   
    ShapeLayerLabel buildingsLbl = (ShapeLayerLabel)buildingsLayer.getLabel();
    buildingsLbl.setFieldName("NAME");
    buildingsLbl.setEnable(true);
    buildingsLbl.getFontSymbol().setTextSize(13);      
}

1~4번 코드는 SD 메모리가 디바이스에 마운트된 상태인지를 판단하는 코드입니다. 안드로이드가 리눅스 기반이므로 외부 저장장치에 대한 사용 가능성은 마운트라는 개념으로 판단됩니다. 5번 코드의 map은 블랙포인트에서 제공하는 맵 뷰(View) 컴포넌트입니다. 안드로이드의 View 컴포넌트로부터 상속받습니다. 7~10번 코드가 실제 SHP 파일로부터 레이어를 생성하는 코드입니다. 12~16번은 레이어를 그리기 위한 색상 심벌을 지정하는 코드입니다. 18번 코드가 실제로 맵에 레이어를 추가하는 코드입니다. 20~23번 코드는 레이어에 라벨을 표시하도록 지정하는 코드로 반드시 맵에 레이어로 추가된 이후에 호출해야합니다. 이유는 라벨 표시를 위해 속성 정보를 필요로 하며 이 속성 정보의 사용가능 여부는 맵에 레이어로 추가되어 연결된(Connected) 상태여야 하기 때문입니다. 실행 결과는 아래와 같습니다.

다음 코드는 블랙포인트에서 위성영상에 해당하는 영상 레이어를 추가하는 코드입니다. 위의 코드와 마찬가지로 SD 메모리의 가능 여부를 체크할 필요가 있으나 위의 코드와 중복되므로 생략합니다.

LayerManager layerMan = map.getLayerManager();
String filename = sdCardPath + "/external_sd/XrR/o71261.XrR";
ILayer layer = new TileImageLayer(filename, filename);

Visibility visbility = layer.getVisibility();
visbility.setVisibleByScale(true);
visbility.setFromScale(0);
visbility.setToScale(120000);

layerMan.addLayer(layer);

항공영상 레이어는 TileImageLayer라는 클래스로 생성되는데 이는 항공영상의 빠른 화면 표출을 위해 피라미드 형태로 이미지를 가공하고 다시 일정한 크기의 타일 이미지로 가공되어 처리된 데이터 파일로부터 데이터를 읽어오기 때문입니다. 블랙포인트에서 사용하는 항공영상은 geotiff를 자체 포맷으로 변환한 XrR을 사용하며 변환툴은 http://www.gisdeveloper.co.kr/741 을 통해 다운로드 받을 수 있습니다. 5~8번은 축척에 따라 레이어가 보이고 않보이고의 여부를 지정하고 있는 코드입니다. 실행결과는 아래와 같습니다.

« 2012/05 »

일

월

화

수

목

금

토