JSLayer

지도 내 객체를 관리하기 위한 API 입니다.

Module.createLayer() API를 생성합니다.

createObjectLayer API로 사용자 레이어를 생성할 수 있습니다.

createXDServerLayer API로 서비스 레이어를 생성할 수 있습니다.

let layerList = new Module.JSLayerList(true);
let layer = layerList.createLayer("Layer Name");

Properties

Name	Type	Description
altitude_offset	number	포인트클라우드, 드론LOD 데이터 실시간 높이 설정.
lod_object_alpha	number	서비스 레이어 속성 색상 알파값 설정.
lod_object_detail_ratio	number	서비스 레이어 객체 가시화 거리 비율 설정.
serverURL	string	요청 서버 url 반환.
simple_real3d	boolean	건물 객체 심플모드 설정.
text_character_set	string	레이어 텍스트 문자셋 값 설정.
tile_load_ratio	number	서비스 레이어 가시화 거리 비율 설정.

Function

addObject(object, level)

사용자 레이어에 객체를 추가합니다.

사용자 레이어에서 사용할 수 있습니다.

입력 변수 level은 0으로 고정 사용(현재 미사용)

Infomation

Name	Type	Description
object	JSObject	Add created object
level	number	0 고정 사용

Template

let layername = "objectlayer";
let layerList = new Module.JSLayerList(true);
let layer = layerList.createLayer(layername);
layer.addObject(object, 0);

clearWMSCache()

로드된 WMS 레이어 이미지의 캐시를 지웁니다.

Infomation

Template

var layerList = new Module.JSLayerList(false);
//...(Add WMS layer)...
var layer = layerList.nameAtLayer(“WMSLayer”);
layer.clearWMSCache();

getObjectCount() → number

레이어의 객체 수를 반환합니다.

사용자 레이어에서 사용할 수 있습니다.

Infomation

• Return

  • result>0 : 레이어에 포함된 객체 수.

  • -1 : 레이어에 포하된 객체가 없는 경우.

Template

getObjectKeyList() → string

레이어에 포함된 객체의 고유 명칭을 반환합니다.

사용자 레이어에 포함된 객체는 목록으로 관리하고 모든 목록 객체의 고유 명칭을 반환합니다.

사용자 레이어에서만 사용할 수 있습니다.

Infomation

• Return

  • string : 반환 성공 (구분자 ",").

  • "" : 반환 실패.

  • 실패 조건

    • 사용자 레이어에 포함된 객체 수가 0인 경우.

    • 서비스 레이어인 경우(서비스 레이어에서 객체는 Tile에 종속)

Template

getType() → number

레이어 타입 번호를 반환합니다.

Infomation

• Return

  • number(0 이상) : 레이어 타입 반환(Layer Type List).
  • number(-1) : 레이어가 존재하지 않는 경우.

Template

var layerList = new Module.JSLayerList(false);
//...(Add WMS layer)...
var layer = layerList.nameAtLayer(“WMSLayer”);
var bVisible = layer.getType();

indexAtKey(index) → string

사용자 레이어에 포함된 객체 고유 명칭을 반환합니다.

사용자 레이어에 포함된 객체는 목록으로 관리하고 목록 Index에 해당되는 객체의 고유 명칭을 반환합니다.

사용자 레이어에서만 사용할 수 있습니다.

Infomation

Name	Type	Description
index	number	인덱스 번호.

• Return

  • string : 반환 성공.

  • "" : 반환 실패.

  • 실패 조건

    • 입력 변수 index가 레이어에 포함된 객체 목록의 범위를 초과하는 경우(0보다 작거나 목록의 개체 수보다 큰 경우).

    • 레이어의 포함 객체 수가 0인 경우.

Template

indexAtObject(index) → JSObject

사용자 레이어에 포함된 객체를 반환합니다.

사용자 레이어에 포함된 객체는 목록으로 관리하고 목록 Index에 해당되는 객체의 고유 명칭을 반환합니다.

사용자 레이어에서만 사용할 수 있습니다.

Infomation

Name	Type	Description
index	number	인덱스 번호.

• Return

  • JSObject : 반환 성공.
  • null : 반환 실패.

  • 실패 조건

    • 입력 변수 index가 레이어에 포함된 객체 목록의 범위를 초과하는 경우(0보다 작거나 목록의 개체 수보다 큰 경우).

    • 레이어의 포함 객체 수가 0인 경우.

Template

keyAtObject(name) → JSObject

사용자 레이어에 포함된 객체를 반환합니다.

사용자 레이어에 포함된 객체는 목록으로 관리하고 객체 고유 명칭과 입력 변수 name 비교 후 만족하는 객체를 반환합니다.

사용자 레이어에서만 사용할 수 있습니다.

Infomation

Name	Type	Description
name	string	객체 고유 명칭.

• Return

  • JSObject : 반환 성공.
  • null : 반환 실패.

  • 실패 조건

    • 동일한 고유 명칭 객체가 없는 경우.

    • 입력 변수 name 문자열 데이터가 없는 경우.

    • 레이어의 포함 객체 수가 0인 경우.

Template

removeAtIndex(index) → boolean

사용자 레이어에 포함된 객체를 삭제합니다.

사용자 레이어에 포함된 객체는 목록으로 관리하고 목록 Index에 해당되는 객체를 삭제합니다.

사용자 레이어에서만 사용할 수 있습니다.

Infomation

Name	Type	Description
index	number	인덱스 번호.

• Return

  • true : 삭제 성공.

  • false : 삭제 실패.

  • 실패 조건

    • 입력 변수 index가 레이어에 포함된 객체 목록의 범위를 초과하는 경우(0보다 작거나 목록의 개체 수보다 큰 경우).

    • 레이어의 포함 객체 수가 0인 경우.

    • 서비스 레이어인 경우(서비스 레이어에서 객체는 Tile에 종속).

    • 외부 서버를 통해 가시화 된 데이터인 경우(Ex. WMS, WFS).

Template

let layername = "objectlayer"
let layerList = new Module.JSLayerList(true);
let layerList.createLayer(layername );

layer.addObject(object, 0);
layer.removeAtIndex(0);

removeAtKey(name) → boolean

사용자 레이어에 포함된 객체를 삭제합니다.

사용자 레이어에 포함된 객체는 목록으로 관리하고 객체 고유 명칭과 입력 변수 name 비교 후 만족하는 객체를 삭제합니다.

사용자 레이어에서만 사용할 수 있습니다.

Infomation

Name	Type	Description
name	string	객체 고유 명칭.

• Return

  • true : 삭제 성공.

  • false : 삭제 실패.

  • 실패 조건

    • 사용자 레이어에 포함된 객체을 고유 명칭이 입력 변수 name와 동일한 객체가 없는 경우.

    • 입력 변수 name 문자열 데이터가 없는 경우.

    • 레이어의 포함 객체 수가 0인 경우.

    • 서비스 레이어인 경우(서비스 레이어에서 객체는 Tile에 종속).

    • 외부 서버를 통해 가시화 된 데이터인 경우(Ex. WMS, WFS).

Template

removeAtObject(object) → boolean

사용자 레이어에 포함된 객체를 삭제합니다.

사용자 레이어에 포함된 객체는 목록으로 관리하고 입력 변수 object와 비교 후 만족하는 객체를 삭제합니다.

사용자 레이어에서만 사용할 수 있습니다.

Infomation

Name	Type	Description
object	JSObject	객체.

• Return

  • true : 삭제 성공.

  • false : 삭제 실패.

  • 실패 조건

    • 사용자 레이어에 포함된 객체와 입력 변수 object와 동일한 객체가 없는 경우.

    • 레이어의 포함 객체 수가 0인 경우.

    • 서비스 레이어인 경우(서비스 레이어에서 객체는 Tile에 종속).

    • 외부 서버를 통해 가시화 된 데이터인 경우(Ex. WMS, WFS).

Template

removeAll() → boolean

사용자 레이어에 포함된 객체를 삭제합니다.

사용자 레이어에 포함된 객체 목록의 모두 삭제합니다.

사용자 레이어에서만 사용할 수 있습니다.

Infomation

• Return

  • true: 삭제 성공.

  • false: 삭제 실패.

  • 실패 조건

    • 레이어의 포함 객체 수가 0인 경우.

    • 서비스 레이어인 경우(서비스 레이어에서 객체는 Tile에 종속).

    • 외부 서버를 통해 가시화 된 데이터인 경우(Ex. WMS, WFS).

Template

setConnectionWFS(url, port, param) → boolean

WFS 서비스 레이어 연결 정보를 설정합니다.

Infomation

Name	Type	Description
url	string	데이터 요청 url.
port	number	데이터 요청 port.
param	string	데이터 요청 파라미터.

• Return

  • true : 설정 성공.

  • false : 설정 실패.

  • 실패 조건

    • 생성한 레이어가 WFS 서비스 레이어가 아닌 경우.

    • 생성한 레이어가 사용자 레이어인 경우.

Template

var API = {
    JSLayerList : new Module.JSLayerList(false)
};
var layer = API.JSLayerList.createWFSLayer(“newWFSLayer”, 0);
var dataURL = “http://...(Data request URL)...”;
var parameter= “...(Data request parameters)...”;
layer.setConnectionWFS(dataURL, 0, parameter);

setConnectionWMS(url, port, param) → boolean

WMS 레이어 연결 정보를 설정합니다.

Infomation

Name	Type	Description
url	string	데이터 요청 url.
port	number	데이터 요청 port.
param	string	데이터 요청 파라미터.

• Return

  • true : 설정 성공.

  • false : 설정 실패.

  • 실패 조건

    • 생성한 레이어가 WMS 레이어가 아닌 경우.

    • 생성한 레이어가 사용자 레이어인 경우.

Template

var API = {
    JSLayerList : new Module.JSLayerList(false)
};
var layer = API.JSLayerList.createWMSLayer(“newWMSLayer”, 0);
var dataURL = “http://...(Data request URL)...”;
var parameter= “...(Data request parameters)...”;
layer.setConnectionWMS(dataURL, 0, parameter);

setFontStyle(fontName, fontSize, fontWeight, color, outColor)

WFS 폰트 스타일을 설정합니다.

WFS를 통해 POI 생성 시 사용됩니다.

Infomation

Name	Type	Description
fontName	string	폰트 명칭.
fontSize	number	폰트 크기.
fontWeight	number	폰트 굵기.
color	JSColor	폰트 색상.
outColor	JSColor	폰트 외각 색상.

Template

var API = {
    JSLayerList : new Module.JSLayerList(false)
};
var layer = API.JSLayerList.createWFSLayer(“newWFSLayer”, 0);
var dataURL = “http://...(Data request URL)...”;
var parameter= “...(Data request parameters)...”;
layer.setConnectionWFS(dataUrl, 0, parameter);
var clrFont     = new Module.JSColor(255, 255, 255, 255);
var clrOutLine  = new Module.JSColor(255, 0, 0, 0);
layer.setFontStyle(“Arial ”, 20, 10, clrFont, clrOutLine);

setLevelWFS(level)

WFS 서비스 레이어의 데이터 출력 레벨 범위를 설정합니다.

Infomation

Name	Type	Description
level	number	가시화 최대 레벨.

Template

var API = {
    JSLayerList : new Module.JSLayerList(false)
};
var layer = API.JSLayerList.createWFSLayer(“newWFSLayer”, 0);
var dataURL = “http://...(Data request URL)...”;
var parameter= “...(Data request parameters)...”;
layer.setConnectionWFS(dataUrl, 0, parameter);
layer.setLevelWFS(10);

setLevelWMS(minLevel, maxLevel) → boolean

WMS 레이어의 데이터 출력 레벨 범위를 설정합니다.

Infomation

Name	Type	Description
minLevel	number	가시화 최소 레벨.
maxLevel	number	가시화 최대 레벨.

• Return

  • true : 설정 성공.

  • false : 설정 실패.

Template

var API = {
    JSLayerList : new Module.JSLayerList(false)
};
var layer = API.JSLayerList.createWMSLayer(“newWMSLayer”);
var dataURL = “http://...(Data request URL)...”;
var parameter= “...(Data request parameters)...”;
layer.setConnectionWMS(dataUrl, 0, parameter);
layer.setLevelWMS(10, 12);

setLODRatio(ratio)

레이어 가시화 범위를 설정합니다.

서비스 레이어 LOD 변경으로 객체 가시화 거리를 조절합니다.

서비스 레이어에서만 사용할 수 있습니다.

Infomation

Name	Type	Description
ratio	number	가시화 거리 비율(높을수록 가시화범위 증가).

• Sample

  • function init 참조.

  • Sandbox_Parabolic Line

Template

setProxyRequest(type)

서비스 레이어에 대한 프록시 사용을 설정합니다.

객체 통신 요청에 프록시 통신 사용 유무를 설정합니다.

낮은 통신 속도를 가집니다.

서비스 레이어에서만 사용할 수 있습니다.

Infomation

Name	Type	Description
type	boolean	true: 프록시 서버 사용. false: 기본 서버 사용.

• Return

  • true : 설정 성공.

  • false : 설정 실패.

  • 실패 조건

    • 사용자 레이어인 경우.

• Sample

  • function createLayerWMS 참조.

  • Sandbox_WMS

Template

setRecoverHsvValue(hue, saturation, value) → boolean

서비스 레이어의 HSV 색상 채널을 설정합니다.

입력 변수 hue(색상), saturation(채도), value(명도) 값으로 객체 HSV 색상 채널을 설정합니다.

시설물, 드론 LOD 레이어만 적용 합니다.

Infomation

Name	Type	Description
hue	number	HSV channel (색상).
saturation	number	HSV channel (채도).
value	number	HSV channel (명도).

• Return

  • true: 설정 성공.

  • false: 설정 실패.

• Sample

  • function setHSV 참조.

  • Sandbox_Adjust layer color

Template

setRequestFeatureCount(count)

WFS 데이터 요청 단위의 타일 크기를 설정합니다.

Infomation

Name	Type	Description
count	number	타일 크기.

• Return

  • true: 설정 성공.

  • false : 설정 실패.

  • 실패 조건

    • 서비스 레이어가 아닌 경우.

    • WFS 서비스 레이어 타입이 아닌 경우.

• Note

  • 요창 단위가 클수록 큰 타일 범위의 WFS 데이터 요청.

Template

var layerList = new Module.JSLayerList(false);
var layer = GLOBAL.JSLayerList.createWFSLayer(“NewWFSLayer”, 0);
layer.setRequestFeatureCount(64);

setStylesWMS(style)

WMS 데이터 요청 시 스타일을 설정합니다.

Infomation

Name	Type	Description
style	string	스타일.

• Return

  • true: 설정 성공.

  • false : 설정 실패.

  • 실패 조건

    • 서비스 레이어가 아닌 경우.

    • WMS 레이어 타입이 아닌 경우.

• Note

  • 스타일 설정 참조

Template

var API = {
    JSLayerList : new Module.JSLayerList(false)
};
var layer = API.JSLayerList.createWMSLayer(“newWMSLayer”);
var dataURL = “http://...(Data request URL)...”;
var parameter= “...(Data request parameters)...”;
layer.setConnectionWMS(dataUrl, 0, parameter);
layer.setStylesWMS(“LT_C_UQ111”);

setTileAltitudeOffset(offset) → boolean

서비스 레이어의 초기 설정 고도값을 설정합니다.

서비스 레이어에서 객체를 불러올 때 입력 변수 offset을 기준으로 높이 설정합니다.

포인트 클라우드 레이어만 적용됩니다.

입력 변수 offset 입력값에 따른 높이 고도 설정은 offset<0(상승), 0(원본 고도), offseta>0하강)

Infomation

Name	Type	Description
offset	number	초기 고도 설정값.

• Return

  • true: 설정 성공.

  • false: 설정 실패.

• Sample

  • function init 참조.

  • Sandbox_Point Cloud

Template

setTileSizeWMS(size)

WMS 레이어에서 이미지 요청 크기를 설정합니다.

Infomation

Name	Type	Description
size	number	이미지 크기.

• Return

  • true: 설정 성공.

  • false: 설정 실패.

  • 실패 조건

    • 서비스 레이어가 아닌 경우.

    • WMS 레이어 타입이 아닌 경우.

• Note

  • 스타일 설정 참조

Template

var API = {
    JSLayerList : new Module.JSLayerList(false)
};
var layer = API.JSLayerList.createWMSLayer(“newWMSLayer”);
var dataURL = “http://...(Data request URL)...”;
var parameter= “...(Data request parameters)...”;
layer.setConnectionWMS(dataUrl, 0, parameter);
layer.setTileSizeWMS(tileSize);

setUseRecoverHsv(type) → boolean

서비스 레이어 HSV 색상 적용 유무를 설정합니다.

setRecoverHsvValue 설정된 색상 채널을 가시화 유무를 설정합니다.

시설물, 드론 LOD 레이어만 적용 합니다.

Infomation

Name	Type	Description
type	boolean	true: HSV 색상 채널 시각화. false: 일반 시각화.

• Return

  • true : 설정 성공.

  • false : 설정 실패.

• Sample

  • function setHSV 참조.

  • Sandbox_Terrain Color Adjustment

Template

setWFSDescField(fieldName) → boolean

WFS 데이터 중 Description 데이터로 저장할 태그 이름을 설정합니다.

Infomation

Name	Type	Description
fieldName	string	태그 명칭.

• Return

  • true: 설정 성공.

  • false: 설정 실패.

Template

var layerList = new Module.JSLayerList(false);
var layer = GLOBAL.JSLayerList.createWFSLayer(“NewWFSLayer”, 0);
layer.setWFSPropertyName(“STD_SGGCD,BONBUN,AG_GEOM”);
layer.setWFSDescField(“STD_SGGCD”);

"Received WFS Data"
<gml:featureMember>
<LT_P_BONBUN gml:id="LT_P_BONBUN.253000">
//...omitted...
<STD_SGGCD>26500</STD_SGGCD>
<BONBUN>708</BONBUN>
<AG_GEOM>
//...omitted...
</gml:featureMember>

setWFSPointName(fieldName)

WFS 서비스 레이어에서 요창 받은 XML 포맷에서 POI 가시화 문자열 태그 이름을 설정합니다.

Infomation

Name	Type	Description
fieldName	string	태그 명칭.

• Return

  • true: 설정 성공.

  • false : 설정 실패.

  • 실패 조건

    • 서비스 레이어가 아닌 경우.

    • WFS 레이어 타입이 아닌 경우.

Template

var API = {
    JSLayerList : new Module.JSLayerList(false)
};
var layer = API.JSLayerList.createWFSLayer(“newWFSLayer”, 0);
var dataURL = “http://...(Data request URL)...”;
var parameter= “...(Data request parameters)...”;
layer.setConnectionWFS(dataUrl, 0, parameter);
layer.setWFSPointName(“BONBUN”);

"Received WFS Data"
<gml:featureMember>
<LT_P_BONBUN gml:id="LT_P_BONBUN.253000">
//...omitted...
<STD_SGGCD>26500</STD_SGGCD>
<BONBUN>708</BONBUN>
<AG_GEOM>
//...omitted...
</gml:featureMember>

setWFSPropertyName(propertyName)

WFS에 대한 속성 데이터로 받을 태그 이름을 설정합니다.

Infomation

Name	Type	Description
propertyName	string	태그 명칭.

• Return

  • true : 설정 성공.

  • false : 설정 실패.

  • 실패 조건

    • 서비스 레이어가 아닌 경우.

    • WFS 레이어 타입이 아닌 경우.

• Note

  • 설정된 WFS 태그 목록은 WFS 데이터 요청 파라미터 중 “propertyname” 파라미터에 설정한 내용이 적용된다.

Template

var layerList = new Module.JSLayerList(false);
var layer = GLOBAL.JSLayerList.createWFSLayer(“NewWFSLayer”, 0);
layer.setWFSPropertyName(“STD_SGGCD,BONBUN,AG_GEOM”);

setWFSTextColor(lineColor, fillColor)

WFS 서비스 레이어 중 POI 객체를 출력하기 위한 텍스쳐의 윤곽선 및 채우기 색상을 설정합니다.

Infomation

Name	Type	Description
lineColor	JSColor	문자 윤곽선 색상.
fillColor	JSColor	문자 색상.

• Return

  • true : 설정 성공.

  • false : 설정 실패.

  • 실패 조건

    • 서비스 레이어가 아닌 경우.

    • WFS 레이어 타입이 아닌 경우.

Template

var layerList = new Module.JSLayerList(false);
var layer = GLOBAL.JSLayerList.createWFSLayer(“NewWFSLayer”, 0);
var lineColor = new Module.JSColor(255, 255, 255, 255);
var fillColor = new Module.JSColor(255, 0, 0, 0);
layer.setWFSTextColor(lineColor , fillColor);

setWMSProvider(option) → string

WMS 서비스 레이어를 생성합니다.

Infomation

Name	Type	Description
option	WMSOptions	속성 정보.

• Return

  • success : 생성 성공.

  • string : 생성 실패 (실패 오류 메시지 반환).

• Sample

  • function createLayerWMS 참조.

  • Sandbox_WMS

Template

let slopeoption = {
	url: strUrl,
	layer: strLayer,
	minimumlevel: 0,
	maximumlevel: 20,
	tilesize: 256,
	crs: "EPSG:5174",
	parameters: {
		version: "1.1.0",
		SERVICE=WMS,
		REQUEST=GetMap,
		FORMAT=image/png,
		VERSION=1.1.0,
		TRANSPARENT=TRUE,
		enablePickFeatures: true,
	}
};

setWMSTransparent(transparent)

WMS 서비스 레이어의 투명 유무를 설정합니다.

Infomation

Name	Type	Description
transparent	boolean	true: 반투명 가시화. false: 불투명 가시화

• Note

  • true로 설정한 경우 지형 이미지가 함께 보이는 반투명 상태로 출력되며, False로 설정한 경우 지형 이미지가 보이지 않는 불투명 상태로 출력된다.

Template

var layerList = new Module.JSLayerList(false);
//...
var layer = layerList.nameAtLayer(“WMSLayer”);
layer.setWMSTransparent(true);

setWMSVersion(version)

WMS 서비스 레이어 이밎 요청 버전을 설정합니다.

Infomation

Name	Type	Description
version	string	버전 정보.

• Return

  • true : 설정 성공.

    • false : 설정 실패.

  • 실패 조건

    • 서비스 레이어가 아닌 경우.

    • WMS 레이어 타입이 아닌 경우.

Template

var layerList = new Module.JSLayerList(false);
//...(Add WMS layer)...
var layer = layerList.nameAtLayer(“WMSLayer”);
layer.setWMSVersion(“1.1.0”);

setWMTSProvider(option)

WMTS 서비스 레이어를 설정합니다.

Infomation

Name	Type	Description
serverSetting	[WMTSOption.Server](jslayer.md#wmtsoption.server	서버 정보 설정.
userSetting	[WMTSOption.User](jslayer.md#wmtsoption.user	서비스 정보 설정.

• Return

  • success : 생성 성공.

  • string : 생성 실패 (실패 오류 메시지 반환).

• Sample

  • Sandbox_WMTS

Template

Getter / Setter

getAlpha(), setAlpha(alpha) → number

서비스 건물 레이어에 존재하는 객체 투명도 설정합니다.

서비스 건물 레이어 심플 모드 객체 투명도 설정합니다.

Infomation

Name	Type	Description
alpha	number	투명도.

• 실패 조건

  • 사용자 레이어인 경우.

  • 시설물 이외 서비스 레이어인 경우.

Template

getBBoxOrder(), setBBoxOrder(type) → boolean

WMS 서비스 레이어 옵션 설정을 설정합니다.

geoserver로 요청하는 좌표 정보 옵션을 설정합니다.

입력 변수값(type)에 따른 요청 파라미터 변경가 변경됩니다 (true(BBOX=minx,miny,maxx,maxy), false(BBOX=minY,minX,maxY,maxX).maxX)).

WMS 레이어에서만 사용할 수 있습니다.

Infomation

Name	Type	Description
type	boolean	좌표 옵션.

• Sample

  • function createLayerWMS 참조.

  • Sandbox_WMS

Template

getEditable(), setEditable(edit) → boolean

레이어를 편집 레이어로 설정합니다.

엔진 내부에서 생성되는 객체를 관리하는 레이어 입니다.

편집레이어 변경 시 기존 편집레이어는 사용자 레이어로 변경됩니다.

사용자 레이어에서만 사용할 수 있습니다.

Infomation

Name	Type	Description
edit	boolean	true: 편집 레이어 설정. false: 일반 레이어로 설정.

• 실패 조건

  • 서비스 레이어인 경우(서비스 레이어에서 객체는 Tile에 종속)

• Sample

  • function initSamplePage 참조.

  • Sandbox_Shape Creation

Template

getMinDistance(), setMinDistance(distance) → number

사용자 레이어 가시 거리를 설정합니다.

사용자 레이어 최소 가시 거리를 설정합니다.

사용자 레이어에서만 사용할 수 있습니다.

Infomation

Name	Type	Description
distance	number	최소 가시 거리 (meters 단위).

• 실패 조건

  • 최소 가시거리가 최대 가시거리보다 큰 경우.

  • 서비스 레이어인 경우.

• Sample

  • function showGrid 참조.

  • Sandbox_Grid (2D)

Template

getMaxDistance(), setMaxDistance(distance) → number

사용자 레이어 가시 거리를 설정합니다.

사용자 레이어 최대 가시 거리를 설정합니다.

사용자 레이어에서만 사용할 수 있습니다.

Infomation

Name	Type	Description
distance	number	최대 가시 거리 (meters 단위).

• 실패 조건

  • 최대 가시거리가 최소 가시거리보다 작은 경우.

  • 서비스 레이어인 경우.

• Sample

  • function showGrid 참조.

  • Sandbox_Grid (2D)

Template

getMaxLevel(), setMaxLevel(level) → number

서비스 레이어 가시 레벨을 설정합니다.

서비스 레이어에서만 사용할 수 있습니다.

Infomation

Name	Type	Description
level	number	최대 가시 레벨.

• 실패 조건

  • 사용자 레이어인 경우.

Template

getName(), setName(name) → string

레이어 명칭을 설정합니다.

Infomation

Name	Type	Description
name	string	레이어 명칭.

Template

var layerList = new Module.JSLayerList(false);
//...(Add WMS layer)...
var layer = layerList.nameAtLayer(“WMSLayer”);
layer.setName(“WMSLayer2”);

getObjectHorizontal(), setObjectHorizontal(horizontal) → number

레이어에 종속된 박스 크기를 설정합니다.

시계월 애니메이션에서 가시화 되는 박스 크기를 실시간으로 설정합니다.

박스 객체의 가로 크기를 설정합니다.

Infomation

Name	Type	Description
horizontal	number	객체 가로 크기.

• 실패 조건

  • 0 보다 작은 값이 입력 된 경우.

  • createTimeSeriesObject() API로 객체 생성이 안된 경우.
• Sample

  • function JsonLoad 참조.

  • Sandbox_Time Series Bar

Template

getObjectVertical(), setObjectVertical(vertical) → number

레이어에 종속된 박스 크기를 설정합니다.

시계월 애니메이션에서 가시화 되는 박스 크기를 실시간으로 설정합니다.

박스 객체의 세로 크기를 설정합니다.

Infomation

Name	Type	Description
vertical	number	객체 세로 크기.

• 실패 조건

  • 0 보다 작은 값이 입력 된 경우.

  • createTimeSeriesObject() API로 객체 생성이 안된 경우.
• Sample

  • function JsonLoad 참조.

  • Sandbox_Time Series Bar

Template

getSelectable(), setSelectable(type) → boolean

레이어에 포함된 객체에 대한 선택 유무를 설정합니다.

레이어에 대한 객체 선택 이벤트를 설정합니다.

사용자 및 서비스 레이어 모두에서 사용할 수 있습니다.

Infomation

Name	Type	Description
type	boolean	true: 선택 이벤트 활성화. false: 선택 이벤트 비활성화.

Template

getTimeSeriesCount(), setTimeSeriesCount(step) → number

레이어에 포함된 시계월 애니메이션 단계를 설정합니다.

Infomation

Name	Type	Description
step	number	애니메이션 단계.

• 실패 조건

  • 입력 변수값(step)이 설정된 최소 step보다 작은값이 입력된 경우.

  • 입력 변수값(step)이 설정된 최대 step보다 큰값이 입력된 경우.

  • createTimeSeriesObject() API로 객체 생성이 안된 경우.
• Sample

  • function JsonLoad 참조.

  • Sandbox_Time Series Bar

Template

getTimeSpeed(), setTimeSpeed(speed) → number

레이어에 포함된 시계월 애니메이션 step 변경 시 객체 변환 속도를 설정합니다.

Infomation

Name	Type	Description
speed	number	변환 속도.

• 실패 조건

  • createTimeSeriesObject() API로 객체 생성이 안된 경우.

Template

getViewLimit(), setViewLimit(tilt) → number

서비스 레이어 tilt 시 서비스 레이어에 포함된 객체 가시화 제한을 설정합니다.

입력 변수값(tilt)이 카메라 tilt 보다 작으면 투명 상태로 설정합니다.

csv, billboard, poi, 시설물 객체에 대해 제한을 설정합니다.

서비스 레이어에서만 사용할 수 있습니다.

Infomation

Name	Type	Description
tilt	number	제한 tilt(degrees 단위).

Template

getVisible(), setVisible(type) → boolean

레이어에 포함된 객체에 대한 가시화 유무를 설정합니다.

레이어가 투명/불투명 정보를 반환합니다.

사용자 및 서비스 레이어 모두에서 사용할 수 있습니다.

Infomation

Name	Type	Description
type	boolean	true: 레이어 포함 객체 가시화. false: 레이어 포함 객체 비가시화.

• Sample

  • function JsonLoad 참조.

  • Sandbox_Time Series Bar

Template

getWMSRequestParam(), setWMSRequestParam(parameter) → string

Infomation

• 대체 API: setWMSProvider

Template

getWMSVersion(), setWMSVersion(version) → string

Infomation

• 대체 API: setWMSProvider

Template

getUnion(), setUnion(union) → boolean

Infomation

• 사용되지 않음

Template

setPointCloudRenderModeRGB(offsetR, offsetG, offsetB) → boolean

포인트 클라우드 레이어의 RGB 색상 오프셋을 설정하고, 렌더링 모드를 RGB 모드로 설정합니다.

Information

Name	Type	Description
offsetR	number	빨간색(R) 채널 오프셋 (0~255)
offsetG	number	초록색(G) 채널 오프셋 (0~255)
offsetB	number	파란색(B) 채널 오프셋 (0~255)

• Return

  • true: 설정 성공

  • false: 포인트 클라우드 레이어가 아닌 경우

• Note

  • alpha 값은 항상 255로 고정됨

Template

let layerList = new Module.JSLayerList(false);
let layer = layerList.nameAtLayer("PointCloudLayer");
layer.setPointCloudRenderModeRGB(255, 100, 100);

setPointCloudRenderModeIntensity(min, max, useColor) → boolean

포인트 클라우드 레이어의 Intensity 기반 렌더링 모드를 설정합니다.

Information

Name	Type	Description
min	number	Intensity 최소값
max	number	Intensity 최대값
useColor	boolean	true: 컬러맵 적용, false: 그레이스케일

• Return

  • true: 설정 성공

  • false: 포인트 클라우드 레이어가 아닌 경우

Template

let layerList = new Module.JSLayerList(false);
let layer = layerList.nameAtLayer("PointCloudLayer");
layer.setPointCloudRenderModeIntensity(0.0, 255.0, true);

setPointCloudRenderModeAltitude(min, max, useColor) → boolean

포인트 클라우드 레이어의 고도 기반 렌더링 모드를 설정합니다.

Information

Name	Type	Description
min	number	고도 컬러맵 적용 범위 최소값 (meter 단위).
max	number	고도 컬러맵 적용 범위 최대값 (meter 단위).
useColor	boolean	true: 컬러맵 적용, false: 그레이스케일 적용.

• Return

  • true: 설정 성공

  • false: 포인트 클라우드 레이어가 아닌 경우

Template

let layerList = new Module.JSLayerList(false);
let layer = layerList.nameAtLayer("PointCloudLayer");
layer.setPointCloudRenderModeAltitude(0.0, 100.0, true);

setPointCloudPointSize(size) → boolean

포인트 클라우드 객체의 점 크기를 설정합니다.

Information

Name	Type	Description
size	number	점 크기(0.001 이상, meter 단위).

• Return

  • true: 설정 성공

  • false: 잘못된 값이거나 포인트 클라우드 레이어가 아닌 경우

Template

let layerList = new Module.JSLayerList(false);
let layer = layerList.nameAtLayer("PointCloudLayer");
layer.setPointCloudPointSize(0.05);

getPickInfoAtView(lineFrom, lineTo) → object

주어진 뷰 라인(lineFrom → lineTo)을 기준으로 해당 레이어 내 피킹된 객체 정보를 반환합니다.

Information

Name	Type	Description
lineFrom	JSVector3D	피킹 라인의 시작 좌표.
lineTo	JSVector3D	피킹 라인의 끝 좌표.

• Return

  • object : 피킹 성공 시 위치 및 객체 정보 반환

  • null : 피킹 실패 시

• 반환 객체 구조

Key	Type	Description
position	JSVector3D	피킹된 좌표 위치.
objectKey	string	피킹된 객체의 고유 키.
layerName	string	피킹된 객체가 포함된 레이어 이름.

• Note

  • 현재 타일 기반 레이어에서만 동작합니다.

Template

let from = new Module.JSVector3D(127.0, 37.5, 100.0);
let to = new Module.JSVector3D(127.0, 37.5, 0.0);

let pickInfo = layer.getPickInfoAtView(from, to);

if (pickInfo) {
    console.log("Position:", pickInfo.position);
    console.log("Object Key:", pickInfo.objectKey);
    console.log("Layer Name:", pickInfo.layerName);
}

setTileLoadCallback(callback) → boolean

타일 로딩 완료 시 호출될 콜백 함수를 설정합니다. 타일 기반 레이어(ELST_PLANET_TILE)에서만 사용할 수 있습니다.

Information

Name	Type	Description
callback	function	타일 로딩 시 호출될 콜백 함수.

• Return

  • true : 설정 성공

  • false : 설정 실패

    • 비타일 레이어일 경우

    • 월드가 초기화되지 않은 경우

• Note

  • 콜백 함수는 JavaScript 함수 객체로 전달되어야 합니다.

  • 콜백은 각 타일 로드 완료 시마다 실행됩니다.

Template

let layer = Module.getLayerByName("MyTileLayer");
layer.setTileLoadCallback(function() {
    console.log("Tile loaded!");
});

addTileInObject(tileInfo, object) → boolean

지정한 타일 위치에 객체를 수동으로 삽입합니다. 지구본 타일 기반 레이어에서만 사용할 수 있습니다.

Information

Name	Type	Description
tileInfo	object	타일 위치 정보 {level, idx, idy}.
object	JSObject	삽입할 객체.

• Return

  • true : 객체 추가 성공

  • false : 실패

    • 비타일 기반 레이어

    • 유효하지 않은 오브젝트

    • RTT(Render to Texture) 객체

    • 이미 등록된 객체

    • tileInfo 누락 또는 오류

    • 타일 존재하지 않음

• Note

  • 해당 타일에 객체를 삽입하고 렌더링을 갱신합니다.

Template

layer.addTileInObject(tileInfo, obj);

setTileInObjectEnd(tileInfo) → boolean

지정한 타일의 객체 수동 삽입 종료를 명시적으로 설정합니다. 객체 수동 삽입 이후 타일의 요청 플래그를 비활성화합니다. 지구본 타일 기반 레이어에서만 사용할 수 있습니다.

Information

Name	Type	Description
tileInfo	object	타일 위치 정보 {level, idx, idy}.

• Return

  • true : 설정 성공

  • false : 실패

    • 비타일 기반 레이어

    • tileInfo 누락 또는 오류

    • 타일 존재하지 않음

Template

layer.setTileInObjectEnd(tileInfo);

setUserTileLoadCallback(callback) → boolean

사용자 레이어 또는 콜백 레이어에서 타일 로드 시 사용자 정의 콜백 함수를 등록합니다.

Information

Name	Type	Description
callback	function	사용자 정의 콜백 함수.

• Return

  • true: 콜백 등록 성공

  • false: 콜백 등록 실패

    • 레이어 타입이 사용자 또는 콜백 타입이 아닌 경우

    • 지구본 타일 기반 레이어가 아닌 경우

Template

let layerList = new Module.JSLayerList(true);
let layer = layerList.createLayer("UserCallbackLayer");

layer.setUserTileLoadCallback(function(...) {
    ...
});

setObjectHeight(height)

애니메이션 오브젝트에서 레이어에 포함된 객체의 높이 기준값을 설정합니다.

Information

Name	Type	Description
height	number	객체 기준 높이 값(m).

• Note

  • 객체 생성 시 높이 보정이 필요한 경우 사용합니다.

  • 값 변경 시, 가시화 정보가 즉시 갱신됩니다.

Template

var layerList = new Module.JSLayerList(true);
var layer = layerList.createLayer("MyLayer");
layer.setObjectHeight(30.0);

SetPointCloudRenderModeIntensity(intensityMin, intensityMax, colorMode) → boolean

포인트 클라우드의 intensity 기반 렌더링 모드를 설정합니다.

Information

Name	Type	Description
intensityMin	float	intensity 값의 최소 범위
intensityMax	float	intensity 값의 최대 범위
colorMode	boolean	true: 색상 모드 사용, false: intensity 단일 색상 사용

• Return

  • true: 설정 성공

  • false: 설정 실패 (레이어 타입이 포인트 클라우드가 아닐 경우 등)

• Description

  • 포인트 클라우드 레이어에 대해 intensity 기반 렌더링 모드를 설정합니다.

Template

var API = {
    JSLayer : Module.getLayerByName("MyPointCloud")
};

// intensity 범위 50 ~ 200, 색상 모드 사용
var success = API.JSLayer.SetPointCloudRenderModeIntensity(50.0, 200.0, true);

if (!success) {
    console.error("설정 실패: 해당 레이어는 포인트 클라우드 타입이 아닙니다.");
}

Type Definitions

WMSOptions

WMS 레이어의 기본 생성 옵션.

Name	Type	Attributes	Default	Description
url	string			GeoServer 요청 url.
layer	string			GeoServer 요청 레이어 명칭.
minimumLevel	number	optional	0	WMS 가시화 최소 레벨.
maximumLevel	number	optional	15	WMS 가시화 최대 레벨.
tileSize	number	optional	256	WMS 요청 이미지 크기.
crs	string	optional	EPSG:4326	WMS 등록 레이어 원본 좌표계.
parameters	WMSOptions.SubOptions	optional		WMS 요청 스타일, 속성 정보..

WMSOptions.SubOptions

WMS 레이어 추가 생성 옵션.

추가 옵션은 parameters 구성 시 키, 벨류로 추가하며 자동으로 요청 url 구성에 포함.

ex) style 옵션 등.

Name	Type	Attributes	Default	Description
version	string	optional	1.1.0	GeoServer 버전.
service	string	optional	WMS	GeoServer 요청 타입.
request	string	optional	GetMap	GeoServer 요청 지도 타입.
format	string	optional	image/png	GeoServer 요청 이미지 타입.
transparent	string	optional	TRUE	Transparency 이미지 요청 시 투명 옵션.

WMTSOption.Server

WMTS 레이어 서버 정보.

Name	Type	Attributes	Default	Description
url	string			요청 서버 URL 구성요소.
vworldTileSet	boolean	optional	false	브이월드 타일구조로 타일링일 경우(true).
projection	string			지도 원본 EPSG 코드.
tileExtent	Rect2D			지도 타일링 영역 설정(좌하단, 우상단).
gridSubset	Range2D	optional	지구전체 영역	데이터 최소/최대 영역 설정(좌하단, 우상단).
tileSize	number	optional	256	타일에 가시화 이미지 사이즈 설정.
resolutions	array(number)			타일링 해상도.
matrixIds	array(number)			타일링 레벨(해상도와 매칭).
indexOrder	boolean	optional	true	타일 인덱싱 기준점(false: 좌하단, true: 좌상단).
serviceLevel	Range2D			최소, 최대 이미지 가시화 레벨 설정.

WMTSOption.User

WMTS 레이어 서비스 정보.

Name	Type	Attributes	Default	Description
zeroLevel	number	optional	2	서로 다른 타일구조의 매칭을 위한 보간 값(높은값일 수록 요청수가 많아진다).
quality	string	optional	256	이미지 해상도.
iscrack	boolean	optional	false	타일링시 크랙이 발생 할 경우(true).
crackvalue	number	optional	1000	크랙발생시 보간값(보간값 만큼 이미지를 더 생성한다).