[OpenLayers3] WMS의 GetFeatureInfo 사용하기

WMS는 웹 환경에서 지도를 서비스하는 것으로, 클라이언트가 요청한 영역에 대한 지도를 서버측에서 이미지로 생성해 제공해 주는 서비스입니다. 이 WMS의 기능 중 GetFeatureInfo라는 것이 있는데요. 특정 좌표 지점에 위치한 Feature의 정보를 클라이언트에게 제공해 주는 서비스입니다. 이 기능은 사용자가 지도 상에 클릭한 지점에 대한 정보를 제공하기 위한 용도로 가장 많이 사용됩니다. 아래의 지도에서 임이의 나라를 클릭해 보면 해당 나라의 정보가 지도 하단에 표시되는 것을 볼 수 있습니다.

 

위의 페이지를 ol3에서 어떻게 구현하는지 살펴 보겠습니다. 먼저 필요한 외부 css와 js 파일을 아래처럼 페이지에 포함합니다.




그리고 UI에 대한 Tag를 아래처럼 추가합니다.

id가 map인 div는 지도가 표시될 영역이고, id가 info인 div에는 사용자가 클릭한 지점에 위치한 나라의 정보를 표시합니다.

이제 스크립트 코드를 살펴보겠습니다. 먼저 jQuery의 ready 이벤트를 아래처럼 준비해 둡니다.


위의 … 부분에 앞으로의 모든 스크립트가 추가됩니다. 먼저 추가할 코드는 WMS에 대한 소스와 레이어 객체의 생성입니다. WMS 레이어는 데이터를 받을 소스가 필요합니다. 아래의 코드가 바로 그것입니다.

var wmsSource = new ol.source.TileWMS({
    url: 'https://ahocevar.com/geoserver/wms',
    params: { 'LAYERS': 'ne:ne' },
    serverType: 'geoserver',
    crossOrigin: 'anonymous'
});

var wmsLayer = new ol.layer.Tile({
    source: wmsSource
});

그리고 다음은 초기 지도가 표시될때 지도 화면 중심과 줌 레벨에 대한 View 객체입니다. 이 객체를 통해 WMS의 GetFeatureInfo 기능을 사용할때 필요한 현재 지도의 해상도값을 얻어올 수 있습니다.

var view = new ol.View({
    center: [0, 0],
    zoom: 3
});

WMS를 활용한 레이어 객체를 통해 다음의 코드처럼 지도 객체를 생성하는데요. 생성시 옵션값인 view에 위의 코드에서 생성한 view 객체를 할당해 주고 있습니다. 그리고 target 옵션에는 지도가 표시될 div의 id 값이 지정됩니다.

var map = new ol.Map({
    layers: [wmsLayer],
    target: 'map',
    view: view
});

이제 다음은 지도를 클릭하면 클릭한 지점에 대한 정보를 얻기 위한 WMS의 GetFeatureInfo 기능을 호출하는 기능에 대한 코드입니다. 코드는 아래와 같습니다.

map.on('singleclick', function (evt) {
    document.getElementById('info').innerHTML = '';
    
    var viewResolution = view.getResolution();
    var url = wmsSource.getGetFeatureInfoUrl(
        evt.coordinate, viewResolution, 'EPSG:3857',
        { 'INFO_FORMAT': 'text/html' }
    );
    
    if (url) {
        document.getElementById('info').innerHTML =
            '';
    }
});

지도 상의 클릭 이벤트로 singleclick 이라는 특화된 이벤트를 지도 객체에 등록하고 있습니다. 이 클릭 이벤트 함수에는 evt라는 객체가 넘어오는데요. evt의 coordinate 속성에 사용자가 클릭한 지점의 지도 좌표계 값이 담겨 있습니다. 가장 중요한 부분이 5번 코드인데요. 앞서 WMS를 위한 소스 객체인 wmsSource의 getGetFeatureInfoUrl이라는 함수를 호출하면 WMS의 GetFeatureInfo 기능을 위한 호출 가능한 URL이 문자열로 반환됩니다. 이 getGetFeatureInfoUrl 함수를 호출하기 위해서 필요한 인자는 사용자가 클릭한 지도 상의 좌표와 현재 지도의 줌 레벨에 대한 해상도값과 클릭한 좌표에 대한 좌표체계, 끝으로 GetFeatureInfo 서비스 호출 시 받을 데이터의 포맷인데요. getGetFeatureInfoUrl 함수의 호출 시 지정된 인자값들이 바로 이 인자들입니다. 만약 getGetFeatureInfoUrl 함수의 호출이 성공하면 url 문자열이 반환되고 이 url을 id가 info인 div에 innerHTML 값으로 iframe의 src 속성에 지정합니다. 코드는 단순한데 설명이 복잡합니다. 이 설명은 10번~13번 코드에 대한 설명이니 코드를 보시면 이해가 될 것입니다.

이상으로 필요한 코드를 전부 살펴보았습니다. 지금까지 작성한 전체 코드는 아래 url을 통해 다운로드 받을 수 있습니다.

[OpenLayers3] 지도 위에 DOM 요소를 올려놓기(Overlay)

ol3에서 DIV 등과 같은 DOM 요소를 지도 상에 올려 놓는 내용을 설명합니다. 일단 지도 위에 올려 놨다는 것은 지도의 뷰가 변경되면, 변경된 지도에 따라 올려 놓은 DOM 요소도 함께 이동되어야 한다는 것인데요. 구현하고자 하는 내용에 대한 화면은 아래와 같습니다.


위의 지도를 보면 지도 상에 이미지와 문자열이 보입니다. 이미지는 DIV 요소 안에 IMG 요소로 표현했고, 문자열은 A 요소로 표현했습니다. A 요소로 표현했으니 문자열을 클릭하면 A 요소의 href 속성에 지정된 URL에 대한 페이지가 뜹니다.

위의 지도 기능을 위해 필요한 외부 css와 js 파일을 아래처럼 페이지에 추가합니다.




다음은 화면을 구성하는 UI 요소에 대한 코드입니다.

id가 map인 DIV에 지도가 표시될 것입니다. 또한 id가 txtlink인 A 요소와 id가 marker인 DIV 요소는 ol3의 Overlay로써 지도와 함께 원하는 지점에 표시되도록 할 것입니다. 아래는 UI 요소에 대한 스타일입니다.


이제 스크립트 코드를 작성할 것인데요. 먼저 jQuery의 ready 이벤트를 아래처럼 미리 준비해 둡니다.


위의 ….에 스크립트를 추가해 나가겠습니다. 먼저 지도에 오픈스트리트맵을 배경지도로 구성하기 위해 타일 레이어 객체를 준비합니다.

var layer = new ol.layer.Tile({
    source: new ol.source.OSM()
});

그리고 id가 map인 DIV 요소에 지도를 표시하기 위해 지도 객체를 아래처럼 추가하는데요. 이때 앞서 만들어 둔 레이어 객체를 지정합니다.

var map = new ol.Map({
    layers: [layer],
    target: 'map',
    view: new ol.View({
        center: [0, 0],
        zoom: 2
    })
});

앞서 id가 txtlink와 marker인 두 요소를 지도 상에 원하는 위치에 Overlay 한다고 하였습니다. 그 원하는 위치를 아래처럼 pos라는 변수에 담아 둡니다.

var pos = ol.proj.fromLonLat([16.3725, 48.208889]);

먼저 id가 marker인 DIV 요소에 대한 Overlay를 위한 코드입니다.

var marker = new ol.Overlay({
    position: pos,
    positioning: 'center-center',
    element: document.getElementById('marker'),
    stopEvent: false
});

map.addOverlay(marker);

Overlay 생성을 위해서 먼저 위의 코드의 1번에서처럼 ol.Overlay 클래스 타입을 생성합니다. 생성시에 Overlay될 위치와 이 위치를 기준으로 어떻게 자리를 잡을지를 위한 positioning 옵션을 지정하고, Overlay 대상이 되는 요소를 element 옵션에 지정합니다. stopEvent 옵션을 false로 지정함으로써 다른 요소와 중첩될때 그 요소의 이벤트가 발생하도록 허용 합니다. 이처럼 Overlay 객체를 생성했으면 8번 코드처럼 map 객체의 addOverlay 함수를 호출하여 Overlay 요소를 추가하면, 지도와 함께 항상 지정된 위치에 표시됩니다. 다음은 id가 txtlink인 요소에 대한 Overlay 생성 및 지도에 추가하는 코드입니다.

var txtlink = new ol.Overlay({
    position: pos,
    positioning: 'center-center',
    element: document.getElementById('txtlink')
});

map.addOverlay(txtlink);

이제 실행해 보면, 처음 살펴봤던 Overlay 지도 기능을 볼 수 있습니다. 아래의 링크는 지금까지 작성한 전체 코드에 대한 다운로드입니다.