분류:GeoSpace Script

§ GeoSpace 스크립트 작성 방법

• GeoSpace 스크립트는 Xml 문서 형식으로 작성합니다.

1. Xml 문서

• Template:

<complex>
	<pavilion>
		<id></id>
		<label></label>
		<position>
			<latitude></latitude>
			<longitude></longitude>
			<altitude></altitude>
		</position>
		<reference>
			<icon></icon>
			<vr></vr>
			<textpage></textpage>
			<network></network>
			<gallery></gallery>
			<model></model>
		</reference>
	</pavilion>
</complex>

• 예시 1:

<complex>
	<pavilion>
		<id>aks_central</id>
		<label>한국학중앙연구원 중앙</label>
		<position>
			<longitude>127.054242</longitude>
			<latitude>37.392349</latitude>
			<altitude>114.696</altitude>
		</position>
		<reference>
			<vr>http://digerati.aks.ac.kr/DhLab/2021/Pavilions/aks/aks_central/aks_central.htm</vr>
		</reference>
	</pavilion>
	<pavilion>
		<id>aks_west</id>
		<label>한국학중앙연구원 서편</label>
		<position>
			<longitude>127.051544 </longitude>
			<latitude>37.392732</latitude>
			<altitude>126.321</altitude>
		</position>
		<reference>
			<vr>http://digerati.aks.ac.kr/DhLab/2021/Pavilions/aks/aks_west/aks_west.htm</vr>
		</reference>
	</pavilion>
	<pavilion>
		<id>aks_east</id>
		<label>한국학중앙연구원 동편</label>
		<position>
			<longitude>127.054177</longitude>
			<latitude>37.393398</latitude>
			<altitude>125.713</altitude>
		</position>
		<reference>
			<vr>http://digerati.aks.ac.kr/DhLab/2021/Pavilions/aks/aks_east/aks_east.htm</vr>
		</reference>
	</pavilion>
	<pavilion>
		<id>motionVideo</id>
		<label>보미네</label>
		<position>
			<longitude>127.081632</longitude>
			<latitude>37.357351</latitude>
			<altitude>98.8601</altitude>
		</position>
		<reference>
			<vr>http://digerati.aks.ac.kr/DhLab/2021/Pavilions/motionVideo/video360.htm</vr>
		</reference>
	</pavilion>
</complex>

• 예시 2:

<complex>
	<pavilion>
		<id>D00-0289-0000</id>
		<label>구 목포 일본영사관</label>
		<position>
			<longitude>126.382</longitude>
			<latitude>34.7875</latitude>
			<altitude>51.0</altitude>
		</position>
		<reference>
			<icon>http://www.cha.go.kr/unisearch/images/history_site/thumb/1627104.jpg</icon>
			<textpage>http://www.heritage.go.kr/heri/cul/culSelectDetail.do?ccbaCpno=1333602890000</textpage>
			<network>http://dh.aks.ac.kr/~sandbox/cgi-bin/Story02.py?db=mokpo&project=mokpo&key=목포일본영사관</network>
			<vr>http://dh.aks.ac.kr/~mokpo/pavilion/gallery/land/area/D00-0289-0000/museum.htm</vr>
			<gallery>http://dh.aks.ac.kr/~mokpo/wiki/index.php/Photo:Heritage:D00-0289-0000</gallery>
			<model>http://dh.aks.ac.kr/~mokpo/cgi-bin/ModelView2.py?url=dh.aks.ac.kr/~mokpo/model/D00-0289-0000.glb</model>
		</reference>
	</pavilion>
</complex>

2. 스크립트 Xml 요소 설명

• complex ....... 이 xml 문서의 최상위 요소.
• complex/pavilion ....... 이 컴플렉스에 포함시킬 파빌리온의 갯수만큼 작성합니다. (1개 이상 필수 요소)
• complex/pavilion/id ....... 각 파빌리온을 시스템이 식별할 수 있게 할 고유한 이름, 한 컴플렉스 안에서 중복 id가 있으면 안됩니다. (필수 요소)
• complex/pavilion/label ....... 해당 파빌리온이 세슘 지도상에 표시될 보일 이름 (필수 요소)
• complex/pavilion/pisition/longitude ....... 해당 파빌리온의 위치 .... 경도 값 (필수 요소)
• complex/pavilion/pisition/latitude ....... 해당 파빌리온의 위치 .... 위도 값 (필수 요소)
• complex/pavilion/pisition/altitude ....... 해당 파빌리온의 위치 .... 고도 값 (필수 요소)
• complex/pavilion/reference/icon ........ 해당 파빌리온 마커를 클릭했을 때 정보 창 안에서 보여 줄 썸네일 이미지 (선택 요소)
• complex/pavilion/reference/vr ........ 해당 파빌리온의 3D VR 씬 링크 주소 (선택 요소)
• complex/pavilion/reference/text ........ 해당 파빌리온의 위키 텍스트 씬 링크 주소 (선택 요소)
• complex/pavilion/reference/network ........ 해당 파빌리온의 네트워크 그래프 링크 주소 (선택 요소)
• complex/pavilion/reference/gallery ........ 해당 파빌리온의 사진 갤러리 링크 주소 (선택 요소)
• complex/pavilion/reference/model ........ 해당 파빌리온의 3D 모델 링크 주소 (선택 요소)

3. 위키 문서상에 3D 지도를 출력하는 방법

• GeoSpace라는 이름의 틀(Template)을 스크립트 Xml에 지정한 내용을 3D 지도로 표현합니다.

  {{ GeoSpalce | title=XML_문서_이름 }}

§ 고도 (altitude) 값 획득 방법

• Cesium 3D 지도 상에서 컴플렉스를 구현하기 위해서는 각 파빌리온의 위치를 경도, 위도, 고도 값으로 표시해야 합니다.
• 경도(longitude)와 위도(latitude) 값만 알고 고도(altitude) 값을 모르는 경우, altitude.exe 프로그램을 이용하여 여러 장소의 고도 값을 한꺼번에 얻을 수 있습니다.

1. altitude.exe 다운로드

• 최종 버전: v1.0 (2021. 4. 30.)
• 실행 Droplet: altitude.exe
• 

※ http://digerati.aks.ac.kr/DhLab/2021/101/home/vr-tools/altitude.exe 에서 다운로드받으실 수 있습니다. (클릭하세요.)

2 altitude.exe 사용법

1. 위도와 경도 값을 차례대로 기록한 데이터 파일을 작성합니다. (확장자는 반드시 .lst)

• 입력 파일 예시

#AKS
37.392349, 127.054242
37.392732, 127.051544
37.393398, 127.054177
#Home
37.357351, 127.081632

※ #으로 시작하는 행은 주석문입니다. (없어도 무방)

2. 이 파일을 altitude.exe 에 떨어뜨리면 고도 값을 포함하는 새 파일이 *_a.lst라는 이름으로 생성됩니다.

• 출력 파일 예시

#AKS
37.392349, 127.054242, 114.6968688964844
37.392732, 127.051544, 126.3219146728516
37.393398, 127.054177, 125.7135009765625
#Home
37.357351, 127.081632, 98.86018371582031