GeoTrace 앱 아이콘

GeoTrace 사용 설명서

현장에서 기록하고, QGIS로 가져오는 태블릿 현장조사 앱

개발자 : 박민규(pmkpmk@kakao.com)

1. GeoTrace 개발 배경

2. 앱 기반

3. 기초 배경지도

3.1. 배경지도 추가 절차

  1. 아래 코드 형식의 .xml 파일을 만든다.
  2. 파일을 기기에 옮긴다(Download 폴더 등).
  3. 앱에서 배경지도 전환 메뉴 → XML 파일에서 불러오기를 누르고 파일을 고른다.
  4. 불러온 지도는 저장되어 다음 실행에도 목록에 남는다.

XML 예시

<?xml version="1.0" encoding="UTF-8"?>
<mapSources>
    <source
      name="MAP NAME"
      url="https://example.com/tiles/{z}/{x}/{y}.png"
      minZoom="0"
      maxZoom="19"
      servers="" />
</mapSources>
속성 기본값 설명
name 필수 메뉴에 표시될 이름
url 필수 {z}/{x}/{y} 타일 주소
minZoom/maxZoom 0/19 표시 축척 범위
servers 없음 {s} 자리에 넣을 서버 목록(예: a,b,c)
type xyz xyz 또는 wms
role base base(배경지도) 또는 overlay(중첩 레이어)

3.2. 배경지도 추가 주의사항

메인 메뉴 8개 버튼 설명
그림 1. 메인 메뉴 — 메모 및 스케치 모드, 위치 포인트 생성, GPS ON/OFF, 현재 위치 이동, 경로 저장, 배경지도 선택 및 설정, 프로젝트 설정, 앱 기초 설정, 메뉴바 숨김/펼침

5. 스케치 모드(필기 및 그리기)

필기 도구 버튼 설명
그림 2. 필기 도구 — 일반펜, 형광펜, 지우개, 펜이 없을 때 손가락 모드, 스케치 뒤로/앞으로, 펜 색상 설정, 펜 두께 설정
위성영상 위에 조사 구역을 스케치한 예
그림 3. 스케치 사용 예 — 형광펜 표시, 구역 경계와 수종 메모, 지도 확대·축소 시 스케치 위치 확인용 표식

6. 조사지점 추가(포인트 생성)

조사지점 추가 절차
그림 4. 조사지점 추가 — 현재 위치 또는 지도에서 선택, 이름·설명 입력, 라벨 표시, 속성 보기와 편집

7. 경로 저장 및 GPS 패널

경로 기록과 GPS 패널
그림 5. 경로 기록과 GPS 패널 — 이동 경로 표시, 좌표 형식 전환(십진도 ↔ 도분초), 길게 눌러 좌표 복사

8. 배경지도 설정 및 오버레이 지도

배경지도 전환과 오버레이 지도 선택
그림 6. 배경지도 전환과 오버레이 — 배경지도 목록에서 선택하고, 오버레이 지도 선택으로 위성영상 위에 하이브리드 레이어를 겹침

9. 오프라인 지도 저장

오프라인 지도 다운로드
그림 7. 오프라인 지도 다운로드 — 영역을 지정하고 줌 레벨 범위를 정하면 타일 수와 예상 용량이 표시됨
💡 지도 제공처의 이용약관을 준수하세요. 대량 다운로드가 제한되는 소스(예: Google)가 있으며, 약관 준수 책임은 사용자에게 있습니다.

10. 프로젝트 관리

10.1. GIS 파일 불러오기

GIS 파일 불러오기 절차
그림 8. GIS 파일 불러오기 — 프로젝트 메뉴에서 파일을 고르면 기본 심볼로 지도에 표시됨

10.2. 레이어 관리

레이어 심볼 편집
그림 9. 레이어 관리 — 면 채움 색과 투명도, 외곽선 색과 굵기, 라벨 필드와 글자 크기를 설정

10.3. 결과 ZIP/GPKG 저장

결과 ZIP/GPKG 저장
그림 10. 결과 저장 — 프로젝트 메뉴에서 결과 ZIP/GPKG 저장을 고르고 파일명을 지정
QGIS에서 결과 레이어를 연 화면
그림 11. QGIS에서 결과 확인 — survey_point, sketch_stroke, route_line 레이어가 위성영상 위에 정렬됨

11. 설정

설정 화면
그림 12. 설정 — 기본(언어·GPS 기록 간격·나침반), 표시(색상·크기·라벨), 트랙(기록 중 경로·저장된 경로)

12. 기타

12.1. 메뉴 숨기기와 가로 모드

메뉴 숨기기와 가로 모드
그림 13. 메뉴 숨기기와 가로 모드 — 세로 모드에서는 위쪽, 가로 모드에서는 오른쪽에 메뉴가 놓이며 핸들로 접고 펼침
좌표 및 주소 검색
그림 14. 좌표 및 주소 검색 — 지도를 길게 누르면 VWorld API 키를 입력받고, 좌표·도로명주소·지번주소를 표시

VWorld API 키는 다음 순서로 발급받습니다.

  1. VWorld 디지털트윈국토 → 오픈API → 인증키발급으로 들어갑니다.
  2. 서비스명·서비스유형·서비스URL을 입력하고, 활용 API에서 지오코더 API를 선택해 발급을 신청합니다.
  3. 인증키관리에서 발급된 키를 확인해 앱에 입력합니다.
VWorld 오픈API 레퍼런스
그림 15. VWorld 오픈API — 인증키발급 메뉴
VWorld 인증키 발급 신청 화면
그림 16. 인증키 발급 신청 — 활용 API에서 지오코더 API를 선택
VWorld 인증키 관리 화면
그림 17. 인증키 관리 — 발급된 키를 확인해 앱에 입력

12.3. GPKG 심볼 편집 및 레이어 패키지 활용

QGIS에서 임상도 심볼 편집
그림 18. QGIS에서 심볼 편집 — 폴리곤 색상과 라벨을 설정
QGIS 레이어 패키지 대화상자
그림 19. 레이어 패키지 — 여러 레이어를 단일 GeoPackage로 묶으며, 레이어 스타일을 GeoPackage에 함께 저장
앱에서 임상도 데이터를 표출한 화면
그림 20. 앱에서 표출 — QGIS에서 설정한 색상과 라벨이 그대로 나타나고, 폴리곤을 선택하면 속성을 확인할 수 있음