JSTerrain

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

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

var map = Module.getTerrain();

Properties

Name	Type	Description
demRate	number	DEM 높이 표현 비율
recoverHSV	number	색상 조정 설정 여부
recoverHue	number	색상 Hue 조정 값
recoverSaturation	number	색상 Saturation 조정 값
recoverValue	number	색상 Value 조정 값

Function

makeTerrainElevationCellData(option) → object

입력된 정점 좌표 목록을 기반으로 변수값 격자 구조를 생성하고 정보를 반환합니다.

격자 구조는 위치Returns information after creating GRID data with an argument variable.

Information

Name	Type	Description
option	JSTerrain.GridOption	속성 정보.

• Return

  • .result: API success status ( 1 : success, 0 : failure ).

  • .name: Name of the operation API.

  • .return: API return information ( JSTerrain.GridData : Normal return value, string : Failure error code ).

Template

let point = new Module.JSVec3Array();
point.push(new Module.JSVector3D(127.01969238371277, 37.56514815604788, 24.40620245039463));
point.push(new Module.JSVector3D(127.01962748647728, 37.56392380491751, 25.515124042518437));
point.push(new Module.JSVector3D(127.02194230953037, 37.56375530181643, 33.266184841282666));
point.push(new Module.JSVector3D(127.02220846619382, 37.56494396175599, 26.32035342976451));

let parameter = {
    coordinates: {
        style: "JSVector3D",
        coordinate: point,
    },
    vertical: 10,
    horizontal: 10,
};
let result = Module.getTerrain().makeTerrainElevationCellData(parameter);

getServerAltitude(options, callback) → boolean

입력된 좌표 목록에 대해 서버로부터 고도값을 요청하고, 결과를 콜백 함수로 반환합니다.

Information

Name	Type	Description
options	object	요청할 좌표 정보.
callback	function	요청 완료 후 결과 고도값을 반환하는 콜백 함수.

options 구조

Key	Type	Description
level	number	요청할 지형 타일 레벨.
positions	array	고도 요청할 좌표 목록. 2D 배열(lon, lat) 또는 JSVec2Array 가능.

• Return

  • true: 요청 성공.

  • false: 파라미터 오류 또는 실패.

• Error Conditions

  • callback이 함수가 아닌 경우.

  • positions가 배열도 JSVec2Array도 아닌 경우.

  • level 또는 positions가 누락된 경우.

• Sample

  • Sandbox_TerrainAltitude

Template

var input = {
    level: 10,
    positions: [
        [127.01, 37.55],
        [127.02, 37.56]
    ]
};

Module.getTerrain().getServerAltitude(input, function (result) {
    console.log("Altitude result:", result);
});

Type Definitions

JSTerrain.GridOption

Basic Grid setting options.

Name	Type	Attributes	Default	Description
option	coordinates Type			List of latitude and longitude coordinates for the analysis area, coordinate list type setting.
vertical	number	optional	5	Length of the Cell composing the Grid vertically (in meters).
horizontal	number	optional	5	Length of the Cell composing the Grid horizontally (in meters).

JSTerrain.GridData

Grid return information.

Name	Type	Description
min	JSVector2D	Lower left latitude and longitude coordinates of the Grid.
max	JSVector2D	Upper right latitude and longitude coordinates of the Grid.
center	JSVector2D	Center latitude and longitude coordinates of the Grid.
vertical	number	Length of the Cell composing the Grid vertically (in meters).
verticalCount	number	Number of Cells composing the Grid vertically.
horizontal	number	Length of the Cell composing the Grid horizontally (in meters).
horizontalCount	number	Number of Cells composing the Grid horizontally.
cells	JSTerrain.CellData	Array of Cell information composing the Grid.

JSTerrain.CellData

Data information of the Cell composing the Grid.

Name	Type	Description
type	boolean	Inclusion status of the analysis area.
elevation	number	Elevation of the cell center latitude and longitude coordinates.
min	JSVector2D	Lower left latitude and longitude coordinates of the Cell.
max	JSVector2D	Upper right latitude and longitude coordinates of the Cell.
center	JSVector2D	Center latitude and longitude coordinates of the Cell.