JSAnalysis

지도 내 분석 기능 설정을 위한 API입니다.

Module.getAnalysis API를 생성합니다.

var analysis = Module.getAnalysis();

Function

createShadow(year, month, day, hour, minute) → boolean

설정한 날짜, 시간을 기준으로 건물에 대한 그림자를 생성합니다.

Name
Type
Description

year

number

년도.

month

number

월.

day

number

일.

hour

number

시간.

minute

number

분.

  • Return

    • true: 생성 성공.

    • false: 생성 실패.

createSlopePlane(angle, color) → boolean

시곡면 분석 삼각형 평면을 생성합니다.

Name
Type
Description

angle

number

지형과의 각도.

color

평면 색상.

CreateInterpolationPath(option) → array

보간된 선을 구성하는 좌표 목록을 반환합니다.

Name
Type
Description

option

속성 정보.

  • Return

    • array: 보간된 선 좌표 목록 반환 성공.

    • NULL: 보간된 라인 좌표 모곩 반환 실패.

  • Sample

getGridAnal() → JSGridAnal

JSGridAnal 클래스를 반환합니다.

getJomangRatio(height) → string

조망 차폐율을 반환합니다.

입력 변수값이 설정한 높이 이하 인 지형 고도 값을 가진 영역은 지형, 이상은 산으로 판단합니다.

Name
Type
Description

height

number

지형, 산 기준 높이 (meter 단위).

  • Return

    • 다음 순서로 문자열이 구성 (건물#차폐율#산#차폐율#지형#차폐율#하늘#차폐율)

  • Sample

getJudong(angle) → string

지동 길이를 측정하고 측정 정보를 반환합니다.

입력 변수값은 측정의 기준 퍼짐각도 입니다.

Name
Type
Description

angle

number

퍼짐각

setAllObjectRenderShadow(type)

가시화 된 시설물에 대한 그림자 생성 유무를 설정합니다.

Name
Type
Description

type

boolean

true: 모든 시설물 그림자 객체 생성. false: 선택 시설물 그림자 객체 생성.

setShadowSimulation(type)

그림자 시뮬레이션 실행, 종료를 설정합니다.

Name
Type
Description

type

boolean

true: 그림자 시뮬레이션 실행. false: 그림자 시뮬레이션 종료.

setShadowSimulTerm(term)

그림자 시뮬레이션 진행 시간 간격을 설정합니다.

Name
Type
Description

term

number

그림자 시뮬레이션 진행 간격 설정 (분 단위).

setShadowSimulTime(year, month, day, startHour, startMin, endHour, endMin)

그림자 시뮬레이션에 필요한 시간 정보를 설정합니다.

Name
Type
Description

year

number

시뮬레이션 년도.

month

number

시뮬레이션 월.

day

number

시뮬레이션 일.

startHour

number

시뮬레이션 시작 시간.

startMin

number

시뮬레이션 시작 분.

endHour

number

시뮬레이션 종료 시간.

endMin

number

시뮬레이션 종료 분.

setViewshedMode(apply)

가시권 분석을 실행, 종료를 설정합니다.

Name
Type
Description

apply

boolean

true: 가시권 분석 실행. false: 가시권 분석 종료.

setShadowDrawMode(mode)

그림자 종류를 설정합니다.

Name
Type
Description

mode

number

0: 선택되지 않은 건물의 그림자영역 제외하고 가시화. 1: 선택된 건물의 그림자 가시화. 2: 그림자 가시화 중지. 3: 그림자를 선으로 가시화. 4: 그림자를 면으로 가시화.

CreateShadowOutLine(time, color) → boolean

그림자 종류를 설정합니다.

Name
Type
Description

time

그림자 생성할 시간.

color

그림자 색상.

  • Return

    • true : 설정 성공.

    • false : 설정 실패.

    • 실패 조건

      • 엔진 로드에 실패했을 경우.

SetRenderTerrainShadow(option)

지형 그림자 생성여부를 설정합니다.

Name
Type
Description

option

boolean

지형 그림자 생성 여부.

clearShadow()

그림자를 초기화 합니다.

checkInsideArea(array, object, type) → boolean

입력된 영역과 객체의 포함여부를 반환합니다.

Name
Type
Description

array

비교할 영역 좌표 배열.

object

비교할 객체.

type

number

0: 완전 포함될 경우. 1: 일부라도 포함될 경우.

  • Return

    • true : 설정 성공.

    • false : 설정 조건에 맞는 객체가 없을 경우.

checkInsideAreas(array, parts, object, type) → boolean

여러개의 입력된 영역과 객체의 포함여부를 반환합니다.

Name
Type
Description

array

비교할 영역 좌표 배열.

parts

비교할 영역 parts.

object

비교할 객체.

type

number

0: 완전 포함될 경우. 1: 일부라도 포함될 경우.

getSunset(year, month, day) → number

입력한 날짜를 기준으로 일몰 시간(시각)을 반환합니다.

Name
Type
Description

year

number

년도

month

number

월 (1~12)

day

number

일 (1~31)

  • Return

    • number: 일몰 시간

    • 0.0: 계산 실패 (지도 미로드 등)

getSunrise(year, month, day) → number

입력한 날짜를 기준으로 일출 시간(시각)을 반환합니다. 반환된 값은 24시간제 기준의 실수형 시간값입니다.

Name
Type
Description

year

number

년도

month

number

월 (1~12)

day

number

일 (1~31)

  • Return

    • number: 일출 시간

    • 0.0: 계산 실패 (지도 미로드 등)

setShadowMapSize(size)

그림자 맵 해상도를 설정합니다.

Name
Type
Description

size

number

그림자 맵 해상도 (픽셀 단위) 입력

  • Return

    • 없음 (void)

너무 큰 해상도를 설정할 경우 성능 저하가 발생할 수 있습니다.

setLimitSunAngle(enable, angle)

태양 고도 각도 제한 여부와 제한 각도를 설정합니다.

Name
Type
Description

enable

boolean

true: 제한 활성화 false: 제한 비활성화

angle

number

제한할 최소 태양 고도 각도 (degree 단위)

  • Return

    • 없음 (void)

setSunshineObject(objectNames)

일조량 분석 시 분석 대상 객체들을 설정합니다.

Name
Type
Description

objectNames

string

분석 대상 객체들의 키 값

  • Return

    • 없음 (void)

CalculateSunshineJson(options) → array

지정된 지점들의 일조 시간을 분석하여 각 지점의 일조 시간을 분 단위로 반환합니다.

Name
Type
Description

options

object

일조 분석 옵션 객체.

options 필드 설명:

Field
Type
Required
Default
Description

positions

array

분석할 지점 목록. [longitude, latitude, altitude] 형식 배열.

timerange

object

오늘 5시~20시

시뮬레이션 시간 정보. year, month, day, starthour, endhour 등 포함.

interval

number

20

분석 시간 간격(단위: 분).

analysistype

number

1

분석 대상 타입. 0: 선택 객체, 1: 가시 객체.

skip

number

0

분석 생략할 객체 개수.

  • Return:

    • array: 각 지점별 일조 시간(분) 리스트.

    • null: 분석 실패.

Type Definitions

JSAnalysis.InterpolationOption

Interpolation line coordinate creation options.

Name
Type
Description

positions

array(JSVector2D)

보간 선 시작점 목록.

input

보간 계산 입력점 목록.

rect

선 생성 영역.

vertexcount

number

선 형상 정점 수.

scale

number

선 생성 간격.

Last updated

Was this helpful?