업데이트 버전: 2.2.1.15.183.g
-> 수정버전 : 2.2.1.15.183.h
오류 수정내용(2.2.1.15.185.g -> 2.2.1.15.185.h) :
1.U3dApp에 일부 존재하던 JQuery 의존성 코드가 제거되었습니다.
업데이트 내용:
2. 거리·면적 측정 기능 개선 안내
거리 측정(Distance)과 면적 측정(Area)에서 추가된 측정 종료, 개별 도형 선택·관리, 이벤트, 결과 조회 기능이 수정 및 추가 되었습니다.
1. 주요 변경 사항
아래의 항목이 변경 및 추가 되었습니다.
| 구분 |
변경 내용 |
| 측정점 입력 |
좌클릭뿐 아니라 우클릭으로도 측정점을 추가할 수 있습니다. |
| 측정 종료 |
좌측 더블클릭, 우측 더블클릭 또는 Esc 키로 현재 측정을 종료할 수 있습니다. |
| 잘못 시작한 측정 취소 |
거리 2점 미만, 면적 3점 미만인 상태에서 측정을 종료하면 현재 임시 도형만 삭제됩니다. |
| 개별 도형 선택 |
완료된 거리선 또는 면적 도형을 클릭해 선택할 수 있습니다. |
| 개별 도형 관리 |
선택한 도형의 측정값 확인, 스타일 변경·초기화, 개별 삭제가 가능합니다. |
| 이벤트 연동 |
측정 완료, 선택, 선택 해제, 스타일 변경, 삭제 이벤트를 제공합니다. |
| 결과 조회 |
완료된 도형 목록, 개별 결과, 전체 결과 목록을 API로 조회할 수 있습니다. |
2. 측정 조작 개선
- 좌클릭과 우클릭으로 측정점을 추가할 수 있습니다.
- 좌측 더블클릭, 우측 더블클릭 또는
Esc 키로 현재 측정을 종료할 수 있습니다.
- 우클릭으로 카메라를 이동하는 경우에는 측정점이 추가되지 않습니다.
- 거리 2점 미만, 면적 3점 미만에서 측정을 종료하면 현재 작성 중인 도형만 취소됩니다. 기존 측정 결과는 유지됩니다.
참고: 우클릭 한 번은 측정 종료가 아닌 측정점 추가입니다. 우클릭으로 측정을 종료하려면 빠르게 두 번 클릭해 주세요.
- 거리·면적 측정 모드와 측정점 입력 화면 ( 4점 추가 )
- 거리·면적 측정 모드와 측정점 마지막점 취소 ( ESC 입력 )
3. 완료된 측정 도형 개별 선택
- 측정이 완료된 거리선 또는 면적 도형을 클릭해 개별 선택할 수 있습니다.
- 다른 도형을 클릭하면 선택 대상이 변경되며, 빈 영역을 클릭하면 선택이 해제됩니다.
완료된 측정 도형 개별 선택 ( 예시 화면 )
4. 선택한 도형 관리하기
팝업에서 다음 작업을 할 수 있습니다.
- 거리 또는 면적 측정값 확인
- 선 색상 변경
- 면적 채우기 색상 변경
- 선 두께 변경
- 투명도 변경
- 해당 도형의 스타일만 기본값으로 초기화
- 해당 도형만 삭제
거리 도형에는 채우기 색상이 적용되지 않습니다.
선택한 측정 도형의 결과 및 스타일 관리 ( 관련 기능이 포함된 오버레이 예시 )
분석 객체의 measureselect 이벤트를 받아 필요한 팝업이나 업무 화면을 구성해야 합니다.
5. 분석 기능 가져오기
거리와 면적 분석 객체는 다음과 같이 가져옵니다.
측정 모드를 직접 활성화할 때는 U3dApp의 다음과 같이 사용합니다.
6. 이벤트 사용법
거리와 면적 분석 객체에 동일한 방식으로 이벤트를 등록할 수 있습니다. ( analy 는 거리, 면적 분석객체 입니다. )
이벤트별 발생 시점과 전달값
| 이벤트 |
발생 시점 |
주요 전달값 |
measureend |
측정 종료 또는 점 부족으로 임시 측정 취소 |
target, feature, type, value |
measureselect |
완료된 측정 도형 선택 |
target, feature, type, value, position |
measureunselect |
빈 영역 클릭, 다른 도형 선택 또는 선택 해제 API 호출 |
target, feature |
measurestylechange |
개별 스타일 적용 또는 초기화 |
target, feature, style |
measuredelete |
개별 도형 삭제 |
target, feature, type |
measureend의 feature가 undefined이면 필요한 점을 채우지 못해 확정 도형이 생성되지 않은 경우입니다.
이때 type도 undefined이고 value는 0입니다.
measurestylechange에서 style이 undefined이면 개별 스타일이 초기화되어 레이어 기본 스타일로 돌아간 경우입니다.
7. 측정 결과 조회하기
7.1 완료된 도형 목록 ( analy.getFeatures() )
getFeatures()는 해당 분석 기능에서 생성한 완료 도형 목록의 복사본을 반환합니다. 작성 중인 임시 도형은 포함하지 않습니다.
7.2 도형 하나의 결과 ( analy.getFeatureResult(feature) )
반환 결과는 다음 값을 포함합니다.
| 속성 |
설명 |
feature |
측정 도형 객체 |
type |
거리 LineString, 면적 Polygon |
value |
거리(m) 또는 면적(m²) |
coordinates |
측정에 사용한 좌표 목록 |
style |
도형에 실제 적용되는 스타일 |
coordinates의 각 항목은 {x, y, z} 형식이며, x는 경도, y는 위도, z는 높이입니다.
7.3 전체 결과 목록 (analy.getFeatureResults())
각 분석에 대한 결과 목록을 반환합니다.
8. 개별 스타일 변경과 초기화 (analy.setFeatureStyle(feature, styleOpt), analy.resetFeatureStyle(feature))
[ styleOpt ]설정 가능한 스타일은 다음과 같습니다.
| 속성 |
형식 |
설명 |
fillColor |
CSS 색상 문자열, 숫자 또는 THREE.Color |
면적 채우기 색상 |
strokeColor |
CSS 색상 문자열, 숫자 또는 THREE.Color |
외곽선 색상 |
strokeWidth |
숫자 |
선 두께 |
opacity |
숫자 |
투명도 |
개별 스타일을 제거하고 레이어 기본 스타일로 되돌리려면 다음 API를 사용합니다.
두 메서드는 적용 성공 시 true, 대상 도형을 찾지 못하면 false를 반환합니다.
9. 개별 도형 삭제 (analy.removeFeature(feature))
삭제 시 선택한 도형, 해당 도형의 측정값 라벨, 내부 관리 목록이 함께 정리되고 measuredelete 이벤트가 발생합니다. 다른 측정 도형은 유지됩니다.
전체 측정 결과를 초기화하려면 U3dApp의 전체 분석 초기화 기능을 사용합니다.
|
