GeOnDT for JS는 웹 브라우저에서 3차원 공간 정보를 시각화하고 분석하는 JavaScript 제품입니다. 지도·지형·시설물과 다양한 공간 데이터를 함께 표현하고, 사용자 조작과 업무 데이터를 연결하여 디지털 트윈 서비스를 개발할 수 있습니다. TypeScript 개발 환경에서 사용할 수 있는 타입 선언도 제공합니다.
GeOnDT로 다음과 같은 기능을 웹 서비스에 구성할 수 있습니다.
- 지도와 공간 데이터 시각화: 영상 지도, 지형, 벡터 데이터와 3D 모델을 함께 표시합니다.
- 시설물과 객체 제어: 시설물을 배치·선택·편집하고, 속성과 표시 상태를 바꾸거나 움직임을 표현합니다.
- 측정과 공간 분석: 거리·면적 측정, 지형·토공량·가시권 분석 등을 사용자 화면과 연결합니다.
- 서비스 기능 조합: 지도 이벤트, 데이터 조회, 분석 결과를 고객 서비스의 UI와 업무 흐름에 맞게 구성합니다.
이 공개 패키지는 개발자와 AI 작업자가 GeOnDT를 이해하고, 사용자 요구에 맞는 기능을 찾아 서비스 코드를 작성하는 데 필요한 자료를 모은 참조 아카이브입니다. 공개 소스와 인터페이스, 동작 명세, API 문서, 시작하기 안내와 공식 예제를 함께 제공합니다. 공개·비공개 분류가 진행됨에 따라 참고할 수 있는 공개 소스도 늘어납니다.
GeOnDT를 처음 접한다면 **GeOnDT for JS 소개 페이지**에서 기본 개념과 사용법을 확인하십시오. 예제 페이지에서 기능을 실행하고 사용 코드를 살펴본 뒤, 개발 중 필요한 메서드와 옵션은 API 페이지에서 확인할 수 있습니다.
| 공식 페이지 | 제공하는 내용 |
|---|---|
| GeOnDT 제품 지원 | 제품 정보, 공지, 질문답변과 라이선스 요청 |
| GeOnDT for JS 소개 | 시작하기, 기본 사용법과 기능별 안내 |
| GeOnDT for JS 예제 | 기능 실행, 예제 코드 확인과 편집 |
| GeOnDT for JS API | 클래스·메서드·옵션의 의미와 사용 계약 |
이 아카이브에도 시작하기와 기능 안내, 공식 예제, API 문서가 포함되어 있습니다. 온라인 문서와 사용 중인 제품의 버전이 다를 수 있으므로 실제 개발에는 해당 배포본의 선언과 문서를 함께 확인하십시오.
GitHub에서 동봉된 HTML 파일을 열면 화면 대신 소스가 보일 수 있습니다. 바로 실행해 보려면 위의 온라인 예제 페이지를 이용하십시오. 로컬에서 문서를 실행한다면 아카이브 루트를 기준으로 HTTP 서버를 열어 상대 경로를 유지하십시오. 라이선스와 데이터 서비스 접속 조건은 사용 중인 제품 환경을 따릅니다.
사용자 서비스에 배치하는 제품은 **dist**입니다. 아카이브의 src·markdown·문서를 서비스에 설치할 필요는 없습니다. 일반 스크립트는 GeOnDT.min.js, ES 모듈은 GeOnDT.modules.js를 사용하며, TypeScript는 같은 배포본의 선언 파일을 사용합니다.
실행에 필요한 GeOnDT.config.js·worker·resource·wasm을 포함한 dist의 구조를 유지하십시오. 제품 연결과 지도 생성 방법은 위의 시작하기 안내와 공식 예제에서 확인할 수 있습니다. 이 아카이브에서 제품 엔진을 다시 빌드하는 절차는 제공하지 않습니다.
GeOnDT for JS를 실행하려면 사용하는 웹 서비스에 맞는 라이선스를 발급받아 적용해야 합니다.
-
라이선스 요청: GeOnDT 라이선스 요청 페이지에서 요청합니다. 요청 시 GeOnDT를 사용하는 웹 서비스의 개발 도메인과 운영 도메인을 모두 전달하십시오.
-
라이선스 로드: 발급받은 라이선스 스크립트를 서비스에 배치하고, GeOnDT 스크립트보다 먼저 로드합니다. 아래는 발급 파일을
license.js로 배치한 일반 스크립트 방식의 로드 순서 예시입니다. 파일 경로는 실제 서비스 배치에 맞게 수정하십시오.<!-- 발급받은 라이선스를 먼저 로드합니다. --> <script src="./license.js"></script> <!-- 라이선스 로드 후 GeOnDT를 로드합니다. --> <script id="GeOnDT" src="./dist/GeOnDT.min.js"></script>
ES 모듈 방식에서도
GeOnDT.modules.js를 import하는 앱 진입 스크립트보다 라이선스 스크립트를 먼저 로드해야 합니다. 라이선스 스크립트에async를 붙여 실행 순서가 바뀌지 않도록 하십시오. -
적용 확인: 서비스를 실행하고 브라우저 개발자 도구의 Console에서 라이선스 인증 결과를 확인합니다. 정상 인증 시 다음 메시지가 출력됩니다.
GeOnDT for JS 라이센스 인증완료.
인증에 실패하면 라이선스 파일의 로드 여부·순서와 실제 접속 도메인이 발급받은 개발·운영 도메인에 해당하는지 확인하십시오. 라이선스 인증 이후에도 제품의 리소스 준비가 이어지므로, 지도 생성은 GeOnDT.ready에서 수행하고 초기화 실패는 GeOnDT.fail로 확인합니다.
| 자료 | 확인할 내용 |
|---|---|
| 배포 타입 선언 | 해당 배포본의 타입과 값 export |
| 참조 소스와 인터페이스 | 파일별 d.ts, 공개된 JS와 동작 명세인 spec.md |
| API 이름 색인 | 공개 이름에 대응하는 d.ts·공개 소스·spec의 경로 |
| 배포 파일 정보 | 아카이브 생성 시각과 파일별 크기·해시 |
src의 d.ts는 납품 선언을 파일별로 나눈 읽기용 자료입니다. 공개 JS는 분류가 끝난 일부 구현만 포함하므로, 이 폴더 전체가 실행 가능한 소스 프로젝트는 아닙니다. 클래스에 공개 JS가 없어도 d.ts와 API 문서로 인터페이스를 확인할 수 있습니다. spec은 공개 참조용 발췌본이며 관찰 초안 상태인 문서는 그 상태를 함께 고려하십시오.
아래 문서는 사용자의 개발 요청을 수행하는 AI 작업자가 참고하는 지침입니다. GeOnDT의 자료를 찾아 근거를 확인하고, 여러 기능을 조합하여 서비스 코드를 구현·검증하는 방법을 담고 있습니다. 제품 사용법을 배우는 분은 위의 시작하기·공식 예제·API 문서부터 읽으면 됩니다.
GeOnDT를 사용하는 코드를 작성하는 AI 작업자는 다음 지침을 참고하십시오.
| 지침 | 참고할 내용 |
|---|---|
| AI 작업자를 위한 GeOnDT 개발 지침 | 사용자 요구와 기존 프로젝트를 파악하고, 기능 간 연결을 설계하며, 구현 결과를 검증하는 방법 |
| AI 작업자를 위한 공식 자료 탐색 방법 | 사용자 표현에서 검색어·API 이름을 발견하고, 예제·선언·spec·공개 소스로 사용 근거를 확인하는 방법 |
AI에게 개발을 요청할 때 이 README를 참고 자료로 전달할 수 있습니다. 별도의 스킬 설치나 호출은 필요하지 않습니다.