지오추적 및 지오쉐이프 질문을 사용하면 맵에서 폴리라인 또는 폴리곤을 취득할 수 있습니다. 피처 레이어의 결과 피처로 포인트 대신 이 지오메트리를 사용할 수 있습니다.
지오추적 및 지오쉐이프 질문은 위치 질문이 없는 위치 취득이나 지오포인트 질문과 달리 기기 위치를 맵 중앙에 배치하는 데 사용하지만 응답 작성 시 사용하지는 않습니다.
지오추적 또는 지오쉐이프 질문에 답변이 없고 기본 또는 식에서 해당 지오메트리가 생성되지 않은 경우 현장조사 레코드는 피처 레이어에 Null 지오메트리로 제출됩니다.
비고:
현장조사에 여러 지오포인트, 지오추적 또는 지오쉐이프 질문을 추가할 수 있지만 이 중 하나만 현장조사 레코드의 지오메트리로 사용할 수 있습니다. 하나를 제외한 모든 질문에 bind::esri:fieldType이 null로 설정된 경우 여러 맵 질문을 사용할 수 있습니다.
현장조사에서 각 반복은 둘 이상의 지오포인트, 지오추적 또는 지오쉐이프 질문이 있을 수도 있지만 이들 중 하나만 반복 레코드의 지오메트리로 사용할 수 있습니다. 위의 설명과 같은 방법으로 여러 맵 질문을 사용할 수 있습니다.
맵을 사용하여 지오추적 또는 지오쉐이프 질문을 취득할 때 Survey123 현장 앱의 모든 피처가 웹 앱에서 지원되는 것은 아닙니다. 다음 피처는 Survey123 현장 앱에서 지원되지만 웹 앱에서는 지원되지 않습니다.
- 오프라인 베이스맵
- 지오추적 및 지오쉐이프 질문에 제공되는 스타일 옵션
- sum() 함수를 포함한 지오추적 및 지오쉐이프 질문에 대한 계산
- 위치 정확도 임계값 및 위치 품질 식
취득 방법
지오추적 및 지오쉐이프에는 2가지 취득 방법인 스케치와 버텍스가 있습니다. 스케치는 처음부터 작성된 현장조사에 기본 설정으로 사용되며, 버텍스는 기존 피처 레이어에서 작성된 현장조사에 기본 설정으로 사용됩니다. 질문의 body::esri:style 열에 method=sketch 또는 method=vertex를 입력하여 현장조사에 다른 취득 방법을 설정할 수 있습니다.
스케치
스케치 방법은 지오메트리를 단일 모션으로 취득합니다. 이 경우 사용자가 단일 라인 그리기를 중지했을 때 취득이 완료됩니다.
이 방법의 사용법에 대한 자세한 내용은 스케치를 참고하세요.
버텍스
버텍스 방법을 사용하면 서로 연결되는 버텍스를 배치함으로써 라인이나 쉐이프를 기하학적으로 더욱 정확하게 취득할 수 있습니다.
이 방법의 사용법에 대한 자세한 내용은 버텍스를 참고하세요.
버텍스를 취득할 때 동작을 제어하는 매개변수는 다음과 같습니다.
- beep 또는 nobeep - beep가 설정된 경우 버텍스를 취득할 때마다 소리 피드백이 제공됩니다. 이 매개변수가 포함되지 않은 경우 기본값은 nobeep입니다.
- haptic 또는 nohaptic - haptic이 설정된 경우 버텍스를 취득할 때마다 햅틱 피드백이 제공됩니다. 햅틱 피드백을 지원하는 하드웨어에서만 지원됩니다. 이 매개변수가 포함되지 않은 경우 기본값은 nohaptic입니다.
- edit 또는 noedit - noedit이 설정된 경우 사용자는 현재 위치에서 버텍스를 취득하고, 각 버텍스 배치를 실행 취소하고, 전체 라인이나 폴리곤을 교체하는 작업만 수행할 수 있습니다. 사용자는 개별 버텍스를 편집할 수 없습니다. 이 매개변수가 포함되지 않은 경우 기본값은 edit입니다.
- streaming 또는 nostreaming - 이동하며 라인이나 폴리곤 버텍스를 스트리밍할 수 있습니다. 이 매개변수가 포함되지 않은 경우 기본값은 nostreaming입니다.
다음 예시는 취득 방법을 소리 피드백이 있는 버텍스 스트리밍으로 설정합니다.
method=vertex,streaming,beep
현장조사 작성자는 스트리밍되는 인접한 버텍스 사이의 거리를 구성할 수 있습니다. 기본 설정에 따라 버텍스는 10미터마다 취득되지만 distanceThreshold 매개변수를 사용하여 이를 수정할 수 있습니다. 이 매개변수는 body::esri:style 열에서 공백으로 구분됩니다. 라인이나 쉐이프 색상을 정의하는 기타 매개변수도 포함될 수 있습니다.
다음 예시는 25미터마다 버텍스를 취득하고 빨간색 라인을 생성합니다.
method=vertex,streaming,beep distanceThreshold=25 lineColor=red
취득한 버텍스의 위치 정확도가 중요한 경우 지오추적 또는 지오쉐이프 질문의 body::accuracyThreshold 열에 정확도 임계값을 입력하면 해당 임계값 조건이 충족되지 않은 경우 버텍스가 취득되지 않습니다.
기본값 및 식
지오추적 또는 지오쉐이프 질문의 기본 지오메트리를 설정하거나 식을 통해 다른 질문의 결과를 사용하여 지오메트리를 생성할 수 있습니다. 지오추적이나 지오쉐이프 질문의 답변을 구성하는 개별 버텍스는 공백으로 구분된 경도 및 위도 값(십진도수 단위, 세미콜론으로 구분됨) 집합입니다. 지오추적 또는 지오쉐이프 질문의 답변을 채우려면 이러한 구조에 따라 유효한 답변을 생성해야 합니다. 정확한 위치를 취득하려면 큰 값이어야 할 수 있습니다. 예를 들어 지오쉐이프 질문의 기본 열에 입력된 다음 값은 호주 멜버른에 있는 공원 주변에 쉐이프를 그립니다.
-37.842156723211474 144.95942945338243; -37.83554486071995 144.9726235713864; -37.85681405373047 144.98240735651922; -37.85954045531896 144.97715349053766
팁:
남반구에 있는 위치 기본값은 빼기 기호(-)로 시작하므로 값을 공식으로 읽기 때문에 Microsoft Excel에서 오류가 발생합니다. 이러한 경우 첫 번째 값 앞에 작은따옴표를 입력하면 Excel에서 제대로 값을 읽습니다. 작은따옴표 추가로 Survey123의 동작이 바뀌지 않습니다.
단답형 질문을 사용하여 채우는 경우 해당 값을 직접적으로 삽입할 수 없으므로 계산 열에 substr() 함수를 이용해 유효한 답변을 구성하도록 권장합니다. 예를 들어 단답형(select_one) 질문의 답변 이름은 다음과 같을 수 있습니다.
+059.38330_+018.66300
답변은 위도와 경도에 대해 고정 문자 수를 사용하며 이름 열은 공백이 허용되지 않으므로 위도 값과 경도 값에 0이 포함되며, 이러한 0은 일반적으로 잘리며 두 값 사이에 밑줄이 배치됩니다. 이 값은 substr() 함수로 해체되어 두 버텍스로 다음과 같은 지오추적 질문 예시를 채울 수 있는 값으로 생성됩니다.
substr(${previous_question1}, 0, 10) + " " + substr(${previous_question1}, -10) + "; " + substr(${previous_question2}, 0, 10) + " " + substr(${previous_question2}, -10)
다음 예시에서는 서로 다른 두 값의 처음 10자(위도)와 마지막 10자(경도)를 가져와 위도와 경도를 구분하는 공백과 유효한 위치를 구분하는 세미콜론을 추가하여 유효한 지오추적 결과를 생성합니다.
또한 sum() 집계 함수를 사용하여 반복 내의 여러 지오포인트 값을 수집한 다음 결과 지오추적 또는 지오쉐이프의 버텍스로 사용할 수 있습니다. 이 경우 사용자는 지오메트리의 각 버텍스에 대한 위치 메타데이터를 취득할 수 있습니다. 자세한 내용은 집계 함수를 참고하세요.
지오추적 또는 지오쉐이프 질문에서 위치가 바로 취득되지는 않지만 현장조사를 불러오는 동안 기기 위치를 맵 중앙에 배치하는 데 사용합니다. 이를 방지하려면 기본값을 null로 설정합니다. 그러면 위치 취득 활성화, 맵 페이지 불러오기(위치를 수동으로 설정한 경우), 계산 새로 고침(질문에 적용된 계산이 있는 경우) 옵션이 표시됩니다.
지오서치
지오추적 및 지오쉐이프 질문에 지오서치 기능이 포함되어 있어, 사용자가 주소 또는 관심 지점을 검색하고 해당 위치에서 맵을 확대하여 버텍스를 배치할 수 있습니다.
기본 설정에 따라, 지오서치 기능은 ArcGIS Geocoding service를 사용해 주소를 검색하여 전 세계에서 결과를 반환합니다.
결과를 반환할 특정 로케이터를 설정하려면 bind::esri:parameters 열에 로케이터의 항목 ID를 입력합니다(예시: geocode=36ff9e8c13e042a58cfce4ad87f55d19). ArcGIS Online 현장조사에 사용되는 로케이터는 ArcGIS Online의 항목이어야 합니다. ArcGIS Enterprise 현장조사에 사용되는 로케이터는 현장조사와 동일한 포털의 항목이어야 합니다.
지오메트리 속성
지오추적 및 지오쉐이프 질문을 계산에 사용하여 길이(지오추적)와 둘레 및 면적(지오쉐이프) 등 지오메트리 속성을 표시하고 기록할 수 있습니다. distance() 및 area() 함수를 사용하여 지오추적 또는 지오쉐이프 질문에 대한 식을 만들 수 있습니다. distance() 함수는 미터 단위의 결과를 반환하며 area() 함수는 제곱미터 단위의 결과를 반환합니다. 결과를 다른 단위로 변환하려면 Survey123 Connect의 지오추적 및 지오쉐이프 샘플을 참고하세요.
지오메트리 심볼
현장조사에 표시할 지오추적 및 지오쉐이프 질문의 스타일을 추가할 수 있습니다. 지오추적 및 지오쉐이프 질문의 body::esri:style 열에 다음 매개변수를 사용하여 이 스타일을 설정할 수 있습니다.
- lineColor
- lineWidth
- fillColor
색상은 표준 HTML 색상 이름 또는 16진수 색상 코드로 지정할 수 있습니다. 8자의 16진수 색상 코드를 사용하여 불투명도를 설정할 수 있습니다. 여러 매개변수는 공백으로 구분됩니다(예시: lineColor=Black fillColor=#800000FF lineWidth=3).
비고:
lineColor 및 lineWidth 매개변수는 지오추적과 지오쉐이프 질문 모두에서 지원됩니다. fillColor 매개변수는 지오쉐이프 질문에서만 지원됩니다.
이러한 스타일 옵션은 Survey123 Connect 및 Survey123 현장 앱에만 표시됩니다.
반복 내 첫 번째 지오포인트 질문의 포인트 위치는 현장조사의 모든 맵에 표시될 수 있습니다. 자세한 내용은 맵의 포인트 중첩을 참고하세요.
질문 스타일
맵 질문에 대해 베이스맵, 맵 도구, 질문 높이를 구성할 수 있습니다.
body::esri:style 열에 map 매개변수를 사용하여 개별 맵 질문에 대한 기본 베이스맵을 설정할 수 있습니다. 예를 들어 map="World Topography"의 경우 맵 질문에 World Topography 베이스맵을 사용하도록 설정됩니다. 또한 맵의 항목 ID를 사용하여 map 매개변수를 설정할 수 있습니다(예시: map=de26a3cf4cc9451298ea173c4b324736). 이 매개변수는 자체 웹 맵을 포함하여 온라인 및 오프라인 맵을 지원합니다. 자세한 내용은 현장조사에 맵 포함을 참고하세요.
body::esri:style 열에 mapTools 매개변수를 사용하면 맵 질문에 사용 가능한 맵 도구를 제어할 수 있습니다. 맵 도구 매개변수가 설정되지 않은 경우, 모든 도구가 표시됩니다. 다음 값이 허용됩니다.
- mapTools=search
- mapTools=mapSwitcher
- mapTools=zoom
- mapTools=home
- mapTools=locate
각 값을 쉼표로 구분하여 여러 도구를 설정할 수 있습니다(예시: mapTools=search,locate).
맵 질문의 경우 body::esri:style 열에 height 매개변수를 사용할 수 있습니다.
height 매개변수에 숫자와 단위(선택)를 입력하여 질문 높이를 설정할 수 있습니다. 기본 단위는 현재 입력 텍스트 글꼴의 높이를 참조하는 lines입니다. 예를 들어 height=5의 경우 해당 질문이 5줄로 표시됩니다.
또는 화면 높이의 백분율이나 픽셀 수를 값에 공백 없이 접미사로 추가하여 단위를 설정할 수 있습니다. 예를 들어 다음 값이 모두 허용됩니다.
- height=5
- height=5lines
- height=25%
- height=250pixels
높이 및 맵 도구는 사이에 공백을 두고 설정할 수 있습니다(예시: height=25% mapTools=search,zoom).