JSAnalysis
지도 내 분석 기능 설정을 위한 API입니다.
Module.getAnalysis API를 생성합니다.
Function
createShadow(year, month, day, hour, minute) → boolean
설정한 날짜, 시간을 기준으로 건물에 대한 그림자를 생성합니다.
year
number
년도.
month
number
월.
day
number
일.
hour
number
시간.
minute
number
분.
Return
true: 생성 성공.
false: 생성 실패.
createSlopePlane(angle, color) → boolean
시곡면 분석 삼각형 평면을 생성합니다.
angle
number
지형과의 각도.
color
평면 색상.
Return
true: 생성 성공.
false: 생성 실패.
Sample
function getSlopePlane 참조.
CreateInterpolationPath(option) → array
보간된 선을 구성하는 좌표 목록을 반환합니다.
option
속성 정보.
Return
array: 보간된 선 좌표 목록 반환 성공.
NULL: 보간된 라인 좌표 모곩 반환 실패.
Sample
function createInterpolatedLine 참조.
getGridAnal() → JSGridAnal
JSGridAnal 클래스를 반환합니다.
Return
JSGridAnal: 반환 성공.
null : 반환 실패.
Sample
function setWindRenderMode 참조.
getJomangRatio(height) → string
조망 차폐율을 반환합니다.
입력 변수값이 설정한 높이 이하 인 지형 고도 값을 가진 영역은 지형, 이상은 산으로 판단합니다.
height
number
지형, 산 기준 높이 (meter 단위).
Return
다음 순서로 문자열이 구성 (건물#차폐율#산#차폐율#지형#차폐율#하늘#차폐율)
Sample
function getJomangRatio 참조.
getJudong(angle) → string
지동 길이를 측정하고 측정 정보를 반환합니다.
입력 변수값은 측정의 기준 퍼짐각도 입니다.
angle
number
퍼짐각
Return
다음 순서로 문자열이 구성 (레이어명#객체키#주동길이#경도#위도)
Sample
function getJudong 참조.
setAllObjectRenderShadow(type)
가시화 된 시설물에 대한 그림자 생성 유무를 설정합니다.
type
boolean
true: 모든 시설물 그림자 객체 생성. false: 선택 시설물 그림자 객체 생성.
Sample
function initPage 참조.
setShadowSimulation(type)
그림자 시뮬레이션 실행, 종료를 설정합니다.
type
boolean
true: 그림자 시뮬레이션 실행. false: 그림자 시뮬레이션 종료.
Sample
function executeShadowSimulation 참조.
setShadowSimulTerm(term)
그림자 시뮬레이션 진행 시간 간격을 설정합니다.
term
number
그림자 시뮬레이션 진행 간격 설정 (분 단위).
Sample
function setShadowSimulationTimeTerm 참조.
setShadowSimulTime(year, month, day, startHour, startMin, endHour, endMin)
그림자 시뮬레이션에 필요한 시간 정보를 설정합니다.
year
number
시뮬레이션 년도.
month
number
시뮬레이션 월.
day
number
시뮬레이션 일.
startHour
number
시뮬레이션 시작 시간.
startMin
number
시뮬레이션 시작 분.
endHour
number
시뮬레이션 종료 시간.
endMin
number
시뮬레이션 종료 분.
Sample
function setShadowSimulationTimeTerm 참조.
setViewshedMode(apply)
가시권 분석을 실행, 종료를 설정합니다.
apply
boolean
true: 가시권 분석 실행. false: 가시권 분석 종료.
setShadowDrawMode(mode)
그림자 종류를 설정합니다.
mode
number
0: 선택되지 않은 건물의 그림자영역 제외하고 가시화. 1: 선택된 건물의 그림자 가시화. 2: 그림자 가시화 중지. 3: 그림자를 선으로 가시화. 4: 그림자를 면으로 가시화.
CreateShadowOutLine(time, color) → boolean
그림자 종류를 설정합니다.
time
그림자 생성할 시간.
color
그림자 색상.
Return
true : 설정 성공.
false : 설정 실패.
실패 조건
엔진 로드에 실패했을 경우.
SetRenderTerrainShadow(option)
지형 그림자 생성여부를 설정합니다.
option
boolean
지형 그림자 생성 여부.
clearShadow()
그림자를 초기화 합니다.
checkInsideArea(array, object, type) → boolean
입력된 영역과 객체의 포함여부를 반환합니다.
array
비교할 영역 좌표 배열.
object
비교할 객체.
type
number
0: 완전 포함될 경우. 1: 일부라도 포함될 경우.
Return
true : 설정 성공.
false : 설정 조건에 맞는 객체가 없을 경우.
checkInsideAreas(array, parts, object, type) → boolean
여러개의 입력된 영역과 객체의 포함여부를 반환합니다.
array
비교할 영역 좌표 배열.
parts
비교할 영역 parts.
object
비교할 객체.
type
number
0: 완전 포함될 경우. 1: 일부라도 포함될 경우.
Sample
function setShadowSimulationTimeTerm 참조.
getSunset(year, month, day) → number
입력한 날짜를 기준으로 일몰 시간(시각)을 반환합니다.
year
number
년도
month
number
월 (1~12)
day
number
일 (1~31)
Return
number: 일몰 시간
0.0: 계산 실패 (지도 미로드 등)
getSunrise(year, month, day) → number
입력한 날짜를 기준으로 일출 시간(시각)을 반환합니다. 반환된 값은 24시간제 기준의 실수형 시간값입니다.
year
number
년도
month
number
월 (1~12)
day
number
일 (1~31)
Return
number: 일출 시간
0.0: 계산 실패 (지도 미로드 등)
setShadowMapSize(size)
그림자 맵 해상도를 설정합니다.
size
number
그림자 맵 해상도 (픽셀 단위) 입력
Return
없음 (void)
너무 큰 해상도를 설정할 경우 성능 저하가 발생할 수 있습니다.
setLimitSunAngle(enable, angle)
태양 고도 각도 제한 여부와 제한 각도를 설정합니다.
enable
boolean
true: 제한 활성화 false: 제한 비활성화
angle
number
제한할 최소 태양 고도 각도 (degree 단위)
Return
없음 (void)
setSunshineObject(objectNames)
일조량 분석 시 분석 대상 객체들을 설정합니다.
objectNames
string
분석 대상 객체들의 키 값
Return
없음 (void)
CalculateSunshineJson(options) → array
지정된 지점들의 일조 시간을 분석하여 각 지점의 일조 시간을 분 단위로 반환합니다.
options
object
일조 분석 옵션 객체.
options 필드 설명:
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.
positions
보간 선 시작점 목록.
input
보간 계산 입력점 목록.
rect
선 생성 영역.
vertexcount
number
선 형상 정점 수.
scale
number
선 생성 간격.
Last updated
Was this helpful?