JSMap

지도 설정 및 제어하기 위한 API 입니다.

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

var map = Module.getMap();

Function

addHeatMaps(coordinates)

히트맵 좌표 목록 추가합니다.

Information

Name	Type	Description
coordinates	JSVec3Array	히트맵 위치 좌표(경도, 위도, 고도) 목록.

• Sample

  • function loadHeatmapPoint 참조.

  • Sandbox_Heatmap

Template

var layerList = new Module.JSLayerList(true);
var layer = layerList.createLayer("HEATMAP_POI", Module.ELT_3DPOINT);
layer.setMaxDistance(60000000.0);

var vList = new Module.JSVec3Array();
var positions = [
    [129.12628252638348, 35.174613788186335, -127.18464569468051],
    [129.1278597986113, 35.1730738804656, -127.16845162212849],
    [129.12691776723804, 35.17243834516552, -127.23446262534708],
    [129.12837451707335, 35.171954803028704, -127.18164411373436],
];

positions.forEach(function (item, idx) {
    vList.push(new Module.JSVector3D(item[0], item[1], 0));
});

Module.getMap().clearHeatMap();
Module.getMap().setTerrainEffect(9);
Module.getMap().setDistance(200);
Module.getMap().setWeight(1);
Module.getMap().addHeatMaps(vList);
Module.getMap().setEffectDistance(1500000);

addInputPoint(lon, lat) → number

사용자 입력 지점을 추가합니다.

Information

Name	Type	Description
lon	number	경도 좌표 (degrees 단위).
lat	number	위도 좌표 (degrees 단위).

• Return

  • number: 등록된 사용자 입력 지점 총 수.

Template

Module.getMap().addInputPoint(127.4347, 35.7016);

clearHeatMap()

히트맵을 초기화 합니다.

Information

• Sample

  • function loadHeatmapPoint 참조.

  • Sandbox_Heatmap

Template

var layerList = new Module.JSLayerList(true);
var layer = layerList.createLayer("HEATMAP_POI", Module.ELT_3DPOINT);
layer.setMaxDistance(60000000.0);

var vList = new Module.JSVec3Array();
var positions = [
    [129.12628252638348, 35.174613788186335, -127.18464569468051],
    [129.1278597986113, 35.1730738804656, -127.16845162212849],
    [129.12691776723804, 35.17243834516552, -127.23446262534708],
    [129.12837451707335, 35.171954803028704, -127.18164411373436],
];

positions.forEach(function (item, idx) {
    vList.push(new Module.JSVector3D(item[0], item[1], 0));
});

Module.getMap().clearHeatMap();
Module.getMap().setTerrainEffect(9);
Module.getMap().setDistance(200);
Module.getMap().setWeight(1);
Module.getMap().addHeatMaps(vList);
Module.getMap().setEffectDistance(1500000);

clearInputPoint()

사용자 입력 좌표 목록을 초기화 합니다.

Information

• Sample

  • function clearInputPoint 참조.

  • Sandbox_LineBuffering

Template

Module.getMap().clearInputPoint();

clearSelectObj()

지도 내 선택된 모든 오브젝트를 선택 해제 상태로 변환합니다.

Information

Template

Module.getMap().clearSelectObj();

clearSnowfallArea()

적설 효과를 초기화 합니다.

Information

Template

var pMap = Module.getMap();
pMap.clearSnowfallArea();

getInputPointCount() → number

사용자 입력 좌표 목록 개수를 반환합니다.

Information

• Return

  • result >= 0 : 반환 성공.

  • -1: 반환 실패.

Template

var API = {
    Module.getMap();
};
var nCount = API.JSMap.getInputPointCount();

getInputPointList() → Collection

사용자 입력 좌표(경도, 위도, 고도)를 모두 반환합니다.

Information

• Return

  • Collection: 반환 성공.

  • null: 반환 실패.

• Sample

  • function createPipe 참조.

  • Sandbox_LineBuffering

Template

var inputPoints = Module.getMap().getInputPointList();

getInputPoints() → JSVec3Array

사용자 입력 좌표(경도, 위도, 고도)를 모두 반환합니다.

Information

• Return

  • JSVec3Array: 반환 성공.

  • null: 반환 실패.

• Sample

  • function createBufferPolygon 참조.

  • Sandbox_LineBuffering

Template

var line = Module.getMap().getInputPoints();

getTerrHeight(lon, lat) → number

입력 변수값(lon, lat)의 해발고도 기준 지형 높이값을 반환합니다.

Information

Name	Type	Description
lon	number	경도.
lat	number	위도.

• Return

  • result > 0: 반환 성공.

  • 0: 반환 실패

  • 실패 조건

    • 해당 지형 고도 데이터가 지도에 요청 되지 않는 경우.

    • 요청 지형 레벨이 낮은 경우.

Template

var height = Module.getMap().getTerrHeight(126.92836647767662, 37.52439503321471);

GetPointDistance(from, to, type) → number

입력 변수값(from, to) 두 지점의 실제 거리를 반환합니다.

Information

Name	Type	Description
from	JSVector3D	시작 좌표 (경도, 위도, 고도)
to	JSVector3D	종료 좌표 (경도, 위도, 고도)
type	boolean	지형 결합 유무를 설정합니다. true: 지형 결합 거리. false: 직선 거리.

• Return

  • result > 0: 반환 성공.

  • 0: 반환 실패

Template

var distance = Module.getMap().GetPointDistance(new Module.JSVector3D(129.128265, 35.171834, 500.0), new Module.JSVector3D(129.118265, 35.161834, 500.0), false);

getLineBuffer(coordinates, distance) → JSVec2Array

입력 변수값(coordinates)을 기준으로 직선에 대한 buffer의 폴리곤 좌표 목록을 반환합니다.

입력 변수값(distance)를 기준으로 버퍼 영역을 설정합니다.

Information

Name	Type	Description
coordinates	JSVec2Array	선 좌표 목록 (경위도).
distance	number	buffer의 반지름 크기 (meter 단위).

• Return

  • JSVec2Array: 반환 성공.

  • null: 반환 실패.

• Sample

  • function createBufferPolygon 참조.

  • Sandbox_LineBuffering

Template

var map = Module.getMap();
var line = map.getInputPoints();
var line2D = new Module.JSVec2Array();
for (var i = 0; i < line.count(); i++) {
    line2D.push(new Module.JSVector2D(line.get(i).Longitude, line.get(i).Latitude));
}
var polygonLine = map.getLineBuffer(line2D, 100);

MapRender()

3D 지도 화면을 재 갱신합니다.

Information

Template

Module.getMap().MapRender();

MapToScreenPointEX(position) → JSVector2D

3D 지도에서 특정 지점에 대한 화면 좌표를 반환합니다.

Information

Name	Type	Description
position	JSVector3D	지도 위치 좌표 (경도, 위도, 고도).

• Return

  • JSVector2D: 반환 성공.

  • null: 반환 실패.

• Sample

  • function displayPopUp 참조.

  • Sandbox_MapToScreenCoordinate

Template

var pointMapPos = Module.getMap().MapToScreenPointEX(new Module.JSVector3D(129.128265, 35.171834, 100.0));

ScreenToMapPointEX(position) → JSVector3D

화면 좌표에서 특정 지점에 대한 3D 지도 좌표를 반환합니다.

Information

Name	Type	Description
position	JSVector2D	화면 좌표 (x, y).

• Return

  • JSVector3D: 반환 성공.

  • null: 반환 실패.

• Sample

  • function init 참조.

  • Sandbox_ScreenToMapCoordinate

Template

var mapPosition = Module.getMap().ScreenToMapPointEX(10, 10);

setCircleInputPoint(center, radius, segment)

특정 지점에 대한 반경 좌표 목록을 반환합니다.

입력 변수값(center)을 기준으로 입력 변수값(radius)을 반지름으로 반경에 대한 좌표를 반환합니다.

입력 변수값(segment)으로 반경을 정밀도를 설정합니다.

Information

Name	Type	Description
center	JSVector2D	반경의 중심 좌표(경도 위도).
radius	number	반경의 반지름 (meters 단위).
segment	number	반경의 정밀도.

Template

var vCenter = new Module.JSVector(129.1475, 35.184338);
Module.getMap().setCircleInputPoint(vCenter, 500.0, 12);

setDistance(distance)

히트맵 반경거리를 설정합니다.

Information

Name	Type	Description
distance	number	히트맵 영역 거리.

• Sample

  • function loadHeatmapPoint 참조.

  • Sandbox_Heatmap

Template

var layerList = new Module.JSLayerList(true);
var layer = layerList.createLayer("HEATMAP_POI", Module.ELT_3DPOINT);
layer.setMaxDistance(60000000.0);

var vList = new Module.JSVec3Array();
var positions = [
    [129.12628252638348, 35.174613788186335, -127.18464569468051],
    [129.1278597986113, 35.1730738804656, -127.16845162212849],
    [129.12691776723804, 35.17243834516552, -127.23446262534708],
    [129.12837451707335, 35.171954803028704, -127.18164411373436],
];

positions.forEach(function (item, idx) {
    vList.push(new Module.JSVector3D(item[0], item[1], 0));
});

Module.getMap().clearHeatMap();
Module.getMap().setTerrainEffect(9);
Module.getMap().setDistance(200);
Module.getMap().setWeight(1);
Module.getMap().addHeatMaps(vList);
Module.getMap().setEffectDistance(1500000);

setEffectDistance(max)

홍수, 적설, 히트맵 가시화 최대 거리를 설정합니다.

Information

Name	Type	Description
max	number	가시화 최대 가시거리.

• Sample

  • function loadHeatmapPoint 참조.

  • Sandbox_Heatmap

Template

var layerList = new Module.JSLayerList(true);
var layer = layerList.createLayer("HEATMAP_POI", Module.ELT_3DPOINT);
layer.setMaxDistance(60000000.0);

var vList = new Module.JSVec3Array();
var positions = [
    [129.12628252638348, 35.174613788186335, -127.18464569468051],
    [129.1278597986113, 35.1730738804656, -127.16845162212849],
    [129.12691776723804, 35.17243834516552, -127.23446262534708],
    [129.12837451707335, 35.171954803028704, -127.18164411373436],
];

positions.forEach(function (item, idx) {
    vList.push(new Module.JSVector3D(item[0], item[1], 0));
});

Module.getMap().clearHeatMap();
Module.getMap().setTerrainEffect(9);
Module.getMap().setDistance(200);
Module.getMap().setWeight(1);
Module.getMap().addHeatMaps(vList);
Module.getMap().setEffectDistance(1500000);

setSnowfallArea(array)

적설 효과를 표현할 영역을 설정합니다.

Information

Name	Type	Description
array	JSVec3Array	영역 좌표 목록 (경도, 위도, 고도).

Template

var vAreaList = new Module.JSVec3Array();
vAreaList.push(new Module.JSVector3D(129.0952984771729, 35.26956608261821, 130.72385844029486));
vAreaList.push(new Module.JSVector3D(129.17153320599272, 35.26955240007246, 171.6742866402492));
vAreaList.push(new Module.JSVector3D(129.17146263440185, 35.17317375381265, 34.883301799185574));
vAreaList.push(new Module.JSVector3D(129.09531779839347, 35.17318816290076, 60.5584503589198));
vAreaList.push(new Module.JSVector3D(129.0952984771729, 35.26956608261821, 130.72385844029486));
Module.getMap().setSnowfallArea(vAreaList);

setSnowfallColor(color)

적설 효과에서 표현되는 색상을 설정합니다.

Information

Name	Type	Description
color	JSColor	적설 색상.

Template

var snowColor = new Module.JSColor(178, 178, 178);
Module.getMap().setSnowfallColor(snowColor);

setTerrLODRatio(ratio)

지형 LOD 요청 거리 비율을 설정합니다.

설정에 따라 먼거리에서 정밀한 지형 데이터가 가시화 됩니다.

<LOD에 따른 지형 갱신 거리> = \ratio * <지형 메쉬 사이즈>

Information

Name	Type	Description
ratio	number	갱신 거리 비율.

Template

Module.getMap().setTerrLODRatio(1.0);

setWeight(weight)

히트맵 가중치를 설정합니다.

Information

Name	Type	Description
weight	number	히트맵 가중치.

• Sample

  • function loadHeatmapPoint 참조.

  • Sandbox_Heatmap

Template

var layerList = new Module.JSLayerList(true);
var layer = layerList.createLayer("HEATMAP_POI", Module.ELT_3DPOINT);
layer.setMaxDistance(60000000.0);

var vList = new Module.JSVec3Array();
var positions = [
    [129.12628252638348, 35.174613788186335, -127.18464569468051],
    [129.1278597986113, 35.1730738804656, -127.16845162212849],
    [129.12691776723804, 35.17243834516552, -127.23446262534708],
    [129.12837451707335, 35.171954803028704, -127.18164411373436],
];

positions.forEach(function (item, idx) {
    vList.push(new Module.JSVector3D(item[0], item[1], 0));
});

Module.getMap().clearHeatMap();
Module.getMap().setTerrainEffect(9);
Module.getMap().setDistance(200);
Module.getMap().setWeight(1);
Module.getMap().addHeatMaps(vList);
Module.getMap().setEffectDistance(1500000);

setFog(color, start, end, density)

안개 효과를 설정합니다.

Information

Name	Type	Description
color	JSColor	안개 색상.
start	number	가시화 최소 거리 (최소값 1).
end	number	가시화 최대 거리.
density	number	안개 농도 (0.0 and 1.0 사이값).

• Sample

  • function loadHeatmapPoint 참조.

  • Sandbox_Fog

Template

var pMap = Module.getMap();
pMap.setFogLimitAltitude(6000000.0);
pMap.setFogEnable(true);
var color = new Module.JSColor(255, 255, 255, 255);
pMap.setFog(color, 0, 5000, 0.3);

setFogEnable(type)

안개효과 가시화 유무를 설정합니다.

Information

Name	Type	Description
type	boolean	true: 안개 효과 가시화. false: 안개 효과 비가시화

• Sample

  • function loadHeatmapPoint 참조.

  • Sandbox_Fog

Template

var pMap = Module.getMap();
pMap.setFogLimitAltitude(6000000.0);
pMap.setFogEnable(true);
var color = new Module.JSColor(255, 255, 255, 255);
pMap.setFog(color, 0, 5000, 0.3);

setRainImageURL(url) → boolean

비 효과에 사용할 이미지를 설정합니다.

Information

Name	Type	Description
url	string	이미지 경로.

• Return

  • true: 설정 성공.

  • false: 설정 실패.

• Sample

  • function changeRainEffectOption 참조.

  • Sandbox_Rain

Template

var pMap = Module.getMap();
pMap.setRainImageURL("./data/snow./png");
pMap.startWeather(1, 5, 5);

setSnowfall(state)

지형에 적설 효과적설 가시화 유무를 설정합니다.

Information

Name	Type	Description
state	number	0: 지형 적설 효과 비가시화 1: 지형 적설 효과 가시화

• Sample

  • function setUseSnowEffect 참조.

  • Sandbox_Snow

Template

var pMap = Module.getMap();
pMap.startWeather(0, 5, 5);
pMap.setSnowfall(1);
pMap.setSnowfallLevel(2.0);

setSnowfallLevel(level) → number

적설 교과 가시화 중 적설 적설량 설정합니다.

Information

Name	Type	Description
level	number	적설량(0~100 사이값).

• Return

  • number: 설정된 적설량.

• Sample

  • function setUseSnowEffect 참조.

  • Sandbox_Snow

Template

var pMap = Module.getMap();
pMap.startWeather(0, 5, 5);
pMap.setSnowfall(1);
pMap.setSnowfallLevel(2.0);

setSnowImageURL(url) → boolean

적설 효과 시 눈 이미지를 설정합니다.

Information

Name	Type	Description
url	string	눈 표현 이미지 경로.

• Return

  • true: 설정 성공.

  • false: 설정 실패.

• Sample

  • function changeRainEffectOption 참조.

  • Sandbox_Snow

Template

var pMap = Module.getMap();
pMap.setSnowImageURL("./data/snow./png");
pMap.startWeather(0, 5, 5);
pMap.setSnowfall(1);
pMap.setSnowfallLevel(2.0);

startWeather(type, size, speed) → boolean

날씨 효과 가시화 유무를 설정합니다.

Information

Name	Type	Description
type	number	날씨 유형(0: 눈, 1: 비).
size	number	날씨 강도 (0: 약함, 1: 보통, 2: 강항).
speed	number	날씨 표현 속도 (0: 느림, 1: 보통, 2: 빠름).

• Return

  • true: 설정 성공.

  • false: 설정 실패.

• Sample

  • function setUseRainEffect 참조.

  • Sandbox_Rain

Template

var pMap = Module.getMap();
pMap.startWeather(1, 5, 5);

stopWeather()

날씨 효과 기능을 비활성화 합니다.

Information

Template

var pMap = Module.getMap();
pMap.stopWeather();

setSimpleMode(type) → boolean

시설물 색상 표현 심플 모드 설정합니다.

시설물 텍스쳐가 없는 색상으로 가시화 됩니다.

Information

Name	Type	Description
type	boolean	true: 심플 모드 활성화. false: 심플 모드 비활성화.

• Return

  • true: 설정 성공.

  • false: 설정 실패.

• Sample

  • function setUseRainEffect 참조.

  • Sandbox_BuildingSimpleMode

Template

Module.getMap().setSimpleMode(true);

setTerrainEffect(value)

지형 가시화 효과를 설정합니다.

Information

Name	Type	Description
value	number	지형 가시화 효과 (0: 일반, 10: 경사향, 11: 경사도)

• Sample

  • function setUseRainEffect 참조.

  • Sandbox_BuildingSimpleMode

Template

Module.getMap().setTerrainEffect(10);

updateRTT()

3D 지도에 RTT 가시화를 재 갱신합니다.

Information

Template

Module.getMap().updateRTT();

Getter / Setter

getSelectObject(), setSelectObject(object) → JSObject

객체의 선택 상태를 설정합니다.

Infomation

Name	Type	Description
object	JSObject	시설물 객체.

• Return

  • JSObject: 시설물 객체.

Template

var selObject = Module.getMap().getSelectObject();
// ... or ...
var object = GLOBAL.Layer.keyAtObject("object_select");
Module.getMap().setSelectObject(object);

getFogLimitAltitude(), setFogLimitAltitude(altitude) → number

안개 효과가 적용되는 영역에 대한 고도값을 설정합니다.

카메라가 반환 고도 아래에 있으면 안개효과가 적용됩니다.

Infomation

Name	Type	Description
altitude	number	안개 효과 높이 (meter 단위).

• Return

  • number: 안개 효과가 적용된 해발고도 기준 높이값.

• Sample

  • function loadHeatmapPoint 참조.

  • Sandbox_Fog

Template

var limitAltitude = Module.getMap().getFogLimitAltitude();
// ... or ...
var pMap = Module.getMap();
pMap.setFogLimitAltitude(6000000.0);
pMap.setFogEnable(true);
var color = new Module.JSColor(255, 255, 255, 255);
pMap.setFog(color, 0, 5000, 0.3);