지오포인트—ArcGIS Survey123

지오포인트 질문을 사용하면 현장조사에서 특정 위치를 취득할 수 있습니다. 지오포인트 질문이 현장조사에 포함되지 않더라도 Survey123의 현장조사 응답이 항상 기기 위치를 취득하려고 하지만 양식에서 가시적 지오포인트 질문을 사용하면 위치 정보를 더 정확하게 취득할 수 있습니다.

지오포인트를 사용할 때는 다음 사항을 고려합니다.

현장조사에 여러 지오포인트, 지오추적 또는 지오쉐이프 질문을 추가할 수 있지만 이 중 하나만 현장조사 레코드의 지오메트리로 사용할 수 있습니다. 하나를 제외한 모든 질문에 bind::esri:fieldType이 null로 설정된 경우 여러 맵 질문을 사용할 수 있습니다.
현장조사에서 각 반복은 둘 이상의 지오포인트, 지오추적 또는 지오쉐이프 질문이 있을 수도 있지만 이들 중 하나만 반복 레코드의 지오메트리로 사용할 수 있습니다. 위의 설명과 같은 방법으로 여러 맵 질문을 사용할 수 있습니다.
기본 설정에 따라 Survey123은 WGS84 위도 및 경도 값을 도-분-초(DMS) 형식으로 표시합니다. 현장조사에서 해당 디스플레이를 변경하려면 맵 탭을 선택한 다음 다른 좌표 형식 값을 선택합니다.
기본 설정에 따라 지오포인트 질문에는 온라인 베이스맵이 사용됩니다. 현장조사를 오프라인에서 사용할 경우 오프라인 베이스맵 사용을 참고하세요.
반복 내 첫 번째 지오포인트 질문의 포인트 위치는 현장조사의 모든 맵에 표시될 수 있습니다. 자세한 내용은 맵의 포인트 중첩을 참고하세요.
현장조사에 지오포인트, 지오추적, 지오쉐이프 질문을 포함하지 않을 경우 현장조사에 대한 기본 피처 레이어의 지오메트리 유형은 esriGeometryPoint입니다. 포인트 위치는 현장조사를 열 때 기기에서 이용 가능한 위치 정보로 채워집니다. 이 동작은 현장조사의 반복에 맵 질문이 포함되어 있지만 반복 외부에는 맵 질문이 포함되어 있지 않는 경우에도 적용됩니다.
지오포인트 질문의 모양 열을 press-to-locate로 설정한 경우 Survey123은 사용자가 질문과 상호작용할 때만 포인트를 취득합니다.
맵을 사용하여 응답을 취득할 때 Survey123 현장 앱의 모든 기능이 웹 앱에서 지원되는 것은 아닙니다. 다음 피처는 Survey123 현장 앱에서 지원되지만 웹 앱에서는 지원되지 않습니다.
- 오프라인 베이스맵.
- 지오포인트 질문에 대한 위치 평균화.
- 지오포인트 심볼.
- 위치 정확도 임계값 및 위치 품질 식.
- 모든 pulldata("@geopoint") 등록정보. 웹 앱에서는 x, y, z, horizontalAccuracy, verticalAccuracy, speed, direction 등록정보만 지원합니다.

위치 정확도 임계값

기본 설정에 따라 Survey123에서는 수집된 위치 값의 정확도를 확인하지 않습니다. 현장조사 결과에 위치 정확도가 중요한 경우 위치 평균화가 사용된 정확도 임계값을 정의할 수 있습니다. 지오포인트 질문의 body::accuracyThreshold 열에 숫자 값을 입력하여 정의합니다. 위치가 평균화될 때 이 정확도의 임계값이 넘는 위치에 대해서는 정보가 취득되지 않습니다.

평균화 중이 아닐 경우 위치 정확도가 정의된 임계값보다 크지만 사용자의 위치 취득을 제한하지 않는 경우 Survey123 현장 앱의 맵 패널에 경고가 나타납니다. 임계값을 충족하는 위치를 취득하려면 경고가 없어질 때까지 기다린 후 위치 버튼을 선택합니다. 정확도 임계값을 충족하지 않는 위치는 평균화 중에 자동으로 무시됩니다.

위치 품질 식

위치 정확도 임계값은 실수이며 지정된 위치에 대한 수평 정확도의 최소 값입니다. 사용자의 위치가 다른 복잡한 품질 요구 사항을 충족시키지 못하는 것을 경고하거나 해당 위치를 제출하지 못하도록 하기 위해 식을 사용할 수 있습니다. 다음은 이러한 식을 입력할 수 있는 열(연관된 메시지 열 포함)입니다.

constraint 및 constraint_message 열은 위치 품질 식이 충족되지 않았을 때 사용자가 지오포인트 질문에서 위치를 취득하지 못하도록 하는 데 사용할 수 있습니다.
bind::esri:warning 및 bind::esri:warning_message 열은 위치 품질 식이 충족되지 않은 경우 사용자에게 경고를 표시하는 데 사용할 수 있습니다. 위치 품질 식이 충족되지 않으면 지오포인트 질문 상단에 있는 좌표 값이 포함된 표시줄이 노란색으로 바뀝니다. 이러한 경우에도 사용자는 계속 위치를 취득할 수 있습니다.

식은 현장조사의 질문을 사용하여 이러한 열 중 하나에서 생성할 수 있지만 일반적으로 현장조사 위치와 관련된 질문이나 매개변수가 사용됩니다.

사용할 수 있는 위치 매개변수는 아래 지오포인트 값 추출 섹션을 참고하세요.

예를 들어 다음 식은 사용자가 위치를 취득하기 전에 멈춘 상태이고 수평 정확도가 5미터보다 양호하다는 것을 확인하는 데 사용할 수 있습니다.

pulldata("@geopoint", ., "horizontalAccuracy") < 5 and pulldata("@geopoint", ., "speed") < 0.1

팁:

사용자가 멈춰 있고 드물게 기기가 0의 속도 값을 보고할 때 한 지점을 취득하도록 할 수 있습니다. 이러한 이유로 위의 예시는 허용할 수 있는 오차를 도입하기 위해 0.1보다 작은 속도를 검색합니다.

식에 설명된 조건에서 위치를 취득해야 하는 경우 이 식을 제약 조건 열에 입력합니다. 권장 사항인 경우 bind::esri:warning 열에 해당 식을 입력하면 사용자에게 해당되는 경고 메시지가 표시됩니다. 사용자는 계속 지오포인트 질문에서 위치를 취득할 수 있습니다.

해당 열에서 식이 false로 평가되면 제약 조건 및 bind::esri:warning 메시지가 표시됩니다.

매우 크거나 복잡한 식에서 pulldata("@geopoint") 함수를 개별 질문으로 분리한 다음 식에서 해당 질문 이름을 참조하는 것이 권장됩니다. 예를 들어 위 예시와 같이 동일한 함수를 실행하려면 hAccuracy 질문에 다음 계산을 사용할 수 있습니다.

pulldata("@geopoint", ${location}, "horizontalAccuracy")

그런 다음 currentSpeed 질문에 다음 계산을 사용할 수 있습니다.

pulldata("@geopoint", ${location}, "speed")

다음 계산을 지오포인트 질문의 제약 조건 또는 경고 식으로 사용할 수 있습니다.

(${hAaccuracy} < 5) and (${currentSpeed} < 0.1)

95% 신뢰 구간 보고

기관은 특정 신뢰 구간(CI)에서 수집된 데이터를 보고하도록 요구할 수 있습니다. 기본 설정에 따라 반환되는 정확도 유형이 평균제곱근(RMS)인 경우 CI는 68%입니다. 현장조사에서 95% CI를 보고하려면 수평 정확도에 1.7308을 곱하고 수직 정확도에 1.9600을 곱합니다. 이러한 전환 요소에 대한 자세한 내용은 미국 국가 공간 데이터 정확도 표준(National Standard for Spatial Data Accuracy)을 참고하세요.

고정밀도 예시

이 예시에서는 변수의 절대 최소 집합이 충족되어야 하지만 덜 엄격한 변수가 있는 위치를 수집하기 위해 사용자에게 재량이 부여됩니다. 선호하는 요구 사항을 충족하기 위해 사용자가 해당 위치에서 길게 머무르는 것을 방지하는 안전 또는 위험 문제가 있을 수 있습니다. 이 경우 경고가 표시되고 사용자는 위치를 취득하거나 좀 더 기다릴 것인지 결정할 수 있습니다.

현장조사 작성자가 설정한 최소 절대 정확도 요구 사항은 다음과 같습니다.

95% CI의 수평 정확도는 2미터 미만입니다.
95% CI의 수직 정확도는 2미터 미만입니다.
위치 정밀도 저하율(PDOP)은 6.0보다 작거나 동일합니다.
5개 이상의 위성이 사용됩니다.

현장조사 작성자가 설정한 선호하는 정확도 요구 사항은 다음과 같습니다.

95% CI의 수평 정확도는 1미터 미만입니다.
95% CI의 수직 정확도는 1미터 미만입니다.
PDOP는 2.0보다 작거나 동일합니다.
7개 이상의 위성이 사용됩니다.

haccuracy68cep 질문에 다음 계산을 사용합니다.

pulldata("@geopoint", ${location}, "horizontalAccuracy")

haccuracy95ci 질문에 다음 계산을 사용합니다.

${haccuracy68cep} * 1.7308

수직 정확도에 대해 유사한 계산이 수행되면 최소 절대 정확도를 나타내기 위해 다음 식이 제약 조건 열에 입력됩니다.

${accuracyType} = 0 and ${haccuracy95ci} < 2 and ${vaccuracy95ci} < 2 and ${pdop} <= 6 and ${satellitesInUse} >= 5

선호하는 정확도를 나타내기 위해 다음 식이 bind::esri:warning 열에 입력됩니다. 여기에 사용된 값은 일반적으로 최소 절대 정확도에 사용되는 값보다 작습니다. 작은 값이 선호되지만 더 큰 최소값도 사용할 수 있습니다.

${accuracyType} = 0 and ${haccuracy95ci} < 1 and ${vaccuracy95ci} < 1 and ${pdop} <= 2 and ${satellitesInUse} >= 7

3D 피처 레이어

기본 설정에 따라 Survey123 지오포인트 질문은 z축(고도) 값을 지원하지 않으며 위도와 경도만 2차원 피처 레이어에 취득합니다. esriFieldTypePointZ를 질문의 bind::esri:fieldType 필드에 입력하여 고도 값이 피처 레이어에 취득되도록 할 수 있습니다. 이 경우 지오포인트 값을 지정하여 고도 필드를 수정할 수도 있습니다.

기본 설정

기본 열에서 공백으로 구분된 위도 및 경도 값 집합(십진도수 단위)을 제공하여 지오포인트 질문의 기본 위치를 설정할 수 있습니다. 예를 들어 -37.814552 144.966071은 지오포인트 질문이 호주 멜버른의 기본 위치로 설정됩니다.

팁:

남반구에 있는 위치 기본값은 빼기 기호(-)로 시작하므로 값을 공식으로 읽기 때문에 Microsoft Excel에서 오류가 발생합니다. 이러한 경우 첫 번째 값 앞에 작은따옴표를 입력하면 Excel에서 제대로 값을 읽습니다. 작은따옴표 추가로 Survey123의 동작이 바뀌지 않습니다.

기본값이 제공되지 않으면 지오포인트 질문이 자동으로 기기의 현재 위치를 업데이트합니다. 이를 방지하려면 기본값을 null로 설정합니다. 그러면 지오포인트 질문에 위치 취득 활성화, 맵 페이지 불러오기(위치를 수동으로 설정한 경우), 계산 새로 고침(적용된 계산이 있는 경우) 옵션이 표시됩니다.

관련 없는 상태에서 관련 있는 상태로 전환되는 지오포인트 질문은 기기의 위치로 자동 업데이트되지 않습니다. 질문이 관련 있는 상태로 전환될 때 기기에서 식별한 현재 위치를 자동으로 가져오려면 기본값을 위치로 설정합니다.

수신함, 임시 저장 또는 임시 보관함에서 실행되는 현장조사에 포함된 지오포인트 질문은 자동으로 기기의 현재 위치로 업데이트되지 않습니다. 현장조사가 폴더에서 열렸을 때 기기에서 식별한 현재 위치를 자동으로 가져오려면 기본값을 위치로 설정합니다.

계산

다른 질문의 결과를 사용하여 지오포인트 질문을 채울 수 있습니다. 지오포인트 질문에 대한 답변은 공백으로 구분된 위도와 경도(십진도수 단위) 값으로 구성되며, 필요에 따라 고도와 정확도(미터 단위)로 시작되는 값이 이어서 올 수 있습니다. 지오포인트 질문의 답변을 채우려면 이러한 구조에 따라 유효한 답변을 생성해야 합니다.

select_one 질문을 사용하여 채우는 경우에는 직접적으로 채울 수 없으므로 substr() 함수를 사용하여 유효한 답변을 구성하는 것을 권장합니다. 예를 들어 다음과 같은 지오포인트 이름이 있습니다.

+059.38330_+018.00000

이 값은 위도와 경도에 대해 고정 문자 수를 사용하는데, 이름 열에는 공백이 허용되지 않으므로 위도 값과 경도 값에 0이 포함되고 이러한 0은 일반적으로 두 값 간의 밑줄로 잘립니다. 이 값은 substr() 함수로 해체되어 다음과 같은 지오포인트 질문 예시를 채울 수 있는 값으로 생성됩니다.

concat(substr(${LocationValue}, 0, 10), " ", substr(${LocationValue}, -10))

이 예시에서 값의 처음 10자(위도 값)와 마지막 10자(경도 값)를 가져와 공백으로 구분하여 유효한 지오포인트 결과로 제공합니다.

pulldata() 함수를 사용하여 첨부된 csv 파일을 통해 지오포인트 질문을 채울 수도 있습니다. 먼저, 현장조사의 미디어 폴더에 .csv 파일을 추가합니다. 그런 다음, 다음과 유사한 항목을 계산 열에 추가합니다.

pulldata('Intersections', 'Lat', 'IntersectionID', ${intersection}) + " " + pulldata('Intersections', 'Long', 'IntersectionID', ${intersection})

substr() 예시와 같이, 이 경우에도 위치의 위도 및 경도 값을 하나의 공백과 합쳐 이전 질문을 기반으로 하여 지오포인트 질문에 대한 유효한 답변을 생성합니다.

Survey123 Connect의 샘플에서 이러한 두 가지 계산에 대한 예시를 참고하세요.

필수 및 읽기 전용

현장조사의 지오포인트 질문은 기기에서 제공된 위치(제공되는 경우)에 자동으로 채워집니다. 기기에서 현장조사 응답에 올바른 위치를 제공하지 않으면 Survey123에서는 아프리카 해안 외곽에 해당되는 0,0 위치를 반환합니다. 지오포인트 질문을 필수로 표시하면 현장조사에 이 Null 값이 제출되지 않고 기기에서 제공된 위치 값 또는 수동으로 제출된 위치 값이 사용됩니다.

지오포인트 질문을 읽기 전용으로 표시하면 답변을 수동으로 입력할 수 없습니다. 이 설정은 수동 응답이 데이터셋에 대한 문제를 발생시켜 자동 응답이 필요한 질문의 경우에 유용합니다. 사용자가 변경할 수 없는 불연속 지오포인트 값을 제공하는 위의 계산 중 하나와 함께 사용하는 것이 권장됩니다.

지오서치 및 지오코드

지오포인트 질문에 지오서치 기능이 포함되어 있어, 사용자가 주소 또는 관심 지점을 검색하고 해당 위치에서 맵을 확대하여 지오포인트 마커를 배치할 수 있습니다.

기본 설정에 따라, 지오서치 기능은 ArcGIS World Geocoding Service를 사용해 주소를 검색하여 전 세계에서 결과를 반환합니다.

기본 설정에 따라, 지오서치는 ArcGIS World Geocoding Service를 사용해 주소를 검색하여 전 세계에서 결과를 반환합니다. 로그인한 사용자는 구성된 지오코딩 서비스의 모든 기관도 볼 수 있습니다.

비고:

ArcGIS World Geocoding Service를 사용한 지오코딩에는 크레딧이 사용됩니다. 자세한 내용은 크레딧 이해하기를 참고하세요.

결과를 반환할 특정 로케이터를 설정하려면 bind::esri:parameters 열에 로케이터의 항목 ID를 입력합니다(예시: geocode=36ff9e8c13e042a58cfce4ad87f55d19). ArcGIS Online 현장조사에 사용되는 로케이터는 ArcGIS Online의 항목이어야 합니다. ArcGIS Enterprise 현장조사에 사용되는 로케이터는 현장조사와 동일한 포털의 항목이어야 합니다.

지오코드 모양이 있는 텍스트 질문을 추가하여 지오코드만 수행하도록 질문을 설정할 수도 있습니다. 자세한 내용은 지오코드 모양을 참고하세요.

역 지오코딩

역 지오코딩은 지오포인트 전체 보기가 열렸을 때 맵 또는 좌표를 길게 눌러 현장 앱에서 수행할 수 있지만 저장되지 않고 현장조사에 제출합니다. 역 지오코딩된 값은 pulldata("@geopoint", ${location}, "reversegeocode")를 사용하여 지오포인트에서 얻을 수 있으며 이 값은 위치를 JSON 객체로 반환합니다. 객체의 개별 속성은 이름을 제공하여 추출할 수 있지만 이러한 속성은 사용된 로케이터에 따라 다릅니다. ArcGIS World Geocoding Service의 경우 다음과 유사한 JSON 객체가 반환됩니다.

{
	"address": {
		"Match_addr": "207-361 Flinders St, Melbourne, Victoria, 3000",
		"LongLabel": "207-361 Flinders St, Melbourne, Victoria, 3000, AUS",
		"ShortLabel": "207-361 Flinders St",
		"Addr_type": "StreetAddress",
		"Type": "",
		"PlaceName": "",
		"AddNum": "283",
		"Address": "283 Flinders St",
		"Block": "",
		"Sector": "",
		"Neighborhood": "Melbourne",
		"District": "Melbourne",
		"City": "Melbourne",
		"MetroArea": "",
		"Subregion": "",
		"Region": "Victoria",
		"RegionAbbr": "VIC",
		"Territory": "",
		"Postal": "3000",
		"PostalExt": "",
		"CntryName": "Australia",
		"CountryCode": "AUS"
	},
	"location": {
		"x": 144.96721048751365,
		"y": -37.81768543612741,
		"spatialReference": {
			"wkid": 4326,
			"latestWkid": 4326
		}
	}
}

JSON 객체에서 특정 값을 추출하려면 pulldata("@geopoint") 등록정보를 추출하는 다음과 유사한 Match_addr 함수를 사용합니다.

pulldata("@geopoint", ${location}, "reversegeocode.address.Match_addr")

역 지오코딩의 경우 기관에서 기본 지오코드 서비스가 사용됩니다. 다른 지오코드 서비스를 사용하려면 pulldata("@geopoint", ${location}, "reversegeocode", ${locatorURL}) 형식이 있는 함수에 로케이터 URL을 매개변수(선택)로 입력합니다. 서비스가 보안 상태이거나 현장조사가 공용 사용자용인 경우 저장된 접속 자격 증명으로 프록시 항목을 구성해야 합니다.

로케이터 URL이 제공되면 URL로 전달되는 추가 매개변수를 제공할 수 있습니다. JSON 객체에 제공된 등록정보와 마찬가지로 해당 매개변수는 사용된 지오코드 서비스에 따라 달라집니다. 다음 예시는 featureTypes 매개변수를 사용하여 특정 위치 유형으로 반환된 값을 가장 가까운 비즈니스 또는 랜드마크로만 반환하도록 제한합니다.

pulldata("@geopoint", ${location}, "reversegeocode.address.Match_addr", "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer", "featureTypes=POI")

팁:

ArcGIS Enterprise 배포의 기본 지오코드 서비스가 ArcGIS World Geocoding Service이거나 위의 단계와 같이 ArcGIS World Geocoding Service가 엔터프라이즈 현장조사의 로케이터 URL 매개변수로 사용되는 경우, 역 지오코딩 수행 시 토큰 오류가 발생할 수 있습니다. 해당 문제를 방지하려면 지오코딩을 수행할 수 있는 권한을 가진 사용자에 대해 ArcGIS Online 접근 자격 증명이 저장된 프록시 항목을 생성하세요. 그런 다음 해당 항목을 포털의 기본 지오코드 서비스나 역 지오코딩 함수의 로케이터 URL 매개변수 대상으로 설정할 수 있습니다.

URL로 전달할 수 있는 전체 매개변수 목록을 포함하여 역 지오코딩 URL 매개변수에 대한 자세한 내용은 ArcGIS REST API 문서의 reverseGeocode를 참고하세요.

성능 또는 크레딧에 영향을 주지 않고 여러 개의 역 지오코딩 계산을 포함할 수 있습니다. 예를 들어 개별 등록정보에 대한 다음과 같은 세 가지 호출을 포함할 수 있습니다.

pulldata("@geopoint", ${location}, "reversegeocode.address.Match_addr")

pulldata("@geopoint", ${location}, "reversegeocode.address.LongLabel")

pulldata("@geopoint", ${location}, "reversegeocode.address.ShortLabel")

역 지오코딩은 크레딧을 소비하는 첫 번째 계산을 수행합니다. 그런 다음 응답이 캐시되며 나머지 두 계산에 사용됩니다. 지오서비스에 대한 새 호출은 위치 변경으로 다른 요청 매개변수가 사용되거나 기존 접근 토큰이 만료되어 역 지오코딩 요청 URL이 변경된 경우에만 필요합니다.

프록시 로케이터 항목 구성

프록시 로케이터 항목을 구성하려면 다음 단계를 따릅니다.

지오코딩 권한이 있는 계정으로 ArcGIS 기관에 로그인합니다.
콘텐츠 페이지에서 ArcGIS Online의 URL에서 > 항목 추가 또는 ArcGIS Enterprise의 웹에서 > 항목 추가를 찾고 선택한 유형이 ArcGIS Server 웹 서비스인지 확인하세요.
원하는 로케이터의 URL을 사용합니다(예시: ArcGIS World Geocoding Service의 경우 https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer).
이는 보안 서비스로 감지됩니다.
지오코딩 권한이 있는 ArcGIS 계정의 사용자 이름과 비밀번호를 추가합니다.
자격 증명을 서비스 항목과 함께 저장을 선택합니다. 인증 메시지는 나타내지 않습니다.
제목 및 태그를 입력합니다.
항목 추가를 클릭합니다.
이 온라인 로케이터 항목을 공개적으로 공유합니다.

자세한 내용은 ArcGIS Online의 자체 로케이터 구성 요구 사항 또는 ArcGIS Enterprise의 포털에서 유틸리티 서비스 구성을 참고하세요.

지오포인트 값 추출

지오포인트 답변을 해체하려면 pulldata("@geopoint")함수를 사용하여 다른 질문의 값을 채울 값을 추출하면 됩니다. 다음 예시에서 지오포인트 질문에서 수평 정확도 값을 추출합니다.

pulldata("@geopoint", ${location}, "horizontalAccuracy")

지오포인트 등록정보의 가용성은 하드웨어에 따라 결정됩니다. 다음 테이블에는 지오포인트에서 가져올 수 있는 등록정보가 나와 있습니다.


등록정보 이름	설명	단위
x	경도, 동반구에서는 양수 값이며 서반구에서는 음수 값	십진도수(DD)
Y	위도, 북반구에서는 양수 값이며 남반구에서는 음수 값	십진도수(DD)
z	고도, 해수면 위의 미터(기본값) 또는 타원체 위의 높이(현장 앱 설정에서 선택한 경우).	미터
horizontalAccuracy	x 및 y 좌표의 수평 정확도	미터
verticalAccuracy	z 좌표의 수직 정확도	미터
속도	대지 속도	초당 미터
verticalSpeed	상승 속도	초당 미터
방향	북쪽에서 시계 방향으로 측정된 이동 방향	십진도수(DD)
positionSourceType	위치 원본의 범주 잠재적인 결과는 알 수 없음(0), 사용자(1), 시스템 위치(2), 외부 기기(3), 네트워크 기기(4), 파일(5)입니다.	N/A
positionSourceInfo.antennaHeight	기기의 안테나고 안테나에서 지표면까지의 거리를 고도에서 뺀 값입니다.	미터
positionSourceInfo.altitudeType	선택한 고도 유형 잠재적 결과는 평균 해수면 위 고도(0) 및 타원체 위의 높이(1)입니다. 해당 등록정보는 모든 위치 공급자 유형에 사용할 수 있습니다.	N/A

다음 테이블에는 고정밀 수신기로 포착한 지오포인트에서 가져올 수 있는 추가 등록정보가 나와 있습니다.


등록정보 이름	설명	단위
magneticVariation	자북과 진북 간의 각도	십진도수(DD)
fixType	좌표의 위치 수정 유형 잠재적인 결과는 수정이 유효하지 않음(0), GPS(1), 차동 GPS(2), 정밀위치결정 서비스(3), RTK 수정됨(4), RTK 고정 해제(5), 예상됨(6), 수동(7), 시뮬레이터(8), SBAS(9)입니다.	N/A
positionSourceInfo	기기 정보를 JSON 객체로 반환 이 등록정보는 디버깅 및 유효성 검사에 유용합니다. 또한 전체 요소 이름을 사용하여 개별 요소를 반환할 수 있습니다. 사용 가능한 모든 요소는 아래의 테이블 행을 참고하세요.	N/A
positionSourceInfo.pluginName	내부 위치 원본의 이름 해당 등록정보는 기기에 통합되어 있는 위치 공급자에만 사용할 수 있습니다.	N/A
positionSourceInfo.deviceAddress	기기 주소 해당 등록정보는 외부 GNSS 수신기에만 사용할 수 있습니다.	N/A
positionSourceInfo.deviceName	기기 이름 해당 등록정보는 외부 GNSS 수신기에만 사용할 수 있습니다.	N/A
positionSourceInfo.deviceType	외부 기기의 유형 잠재적인 결과는 알 수 없음(-1), 블루투스(0), 직렬 포트(1), 블루투스 LE(2)입니다. 해당 등록정보는 외부 GNSS 수신기에만 사용할 수 있습니다.	N/A
positionSourceInfo.networkName	네트워크 위치 원본의 이름 해당 등록정보는 네트워크 위치 공급자에만 사용할 수 있습니다.	N/A
positionSourceInfo.networkAddress	네트워크 위치 원본의 주소 해당 등록정보는 네트워크 위치 공급자에만 사용할 수 있습니다.	N/A
positionSourceInfo.networkPort	네트워크 위치 원본의 포트 해당 등록정보는 네트워크 위치 공급자에만 사용할 수 있습니다.	N/A
positionSourceInfo.geoidSeparationCustom	앱 설정에서 사용자가 정의한 WGS-84 지구 타원체와 평균 해수면 간의 차이입니다.	미터
geoidSeparation	GNSS 수신기가 보고한 WGS-84 지구 타원체와 평균 해수면 간의 차이 경우에 따라 정표고라고 합니다.	미터
accuracyType	horizontalAccuracy 및 verticalAccuracy 등록정보에서 보고된 정확도 유형 잠재적 결과는 RMS(0) 및 DOP(1)입니다. RMS는 평균제곱근 정확도입니다. 이 값은 수신기에서 제공한 GST 문장에 보고된 위도, 경도, 고도 오류에 대한 68% 신뢰 구간을 기반으로 계산됩니다. 수신기가 GST를 지원하지 않으면 DOP가 대신 사용됩니다. DOP는 정밀도 기반 정확도의 저하율입니다. 이 값은 일정한 사용자 등가 거리 오차(UERE) 값을 사용하여 수평 및 수직 정확도를 추정합니다.	N/A
positionAccuracy	평균 방사형 구형 오차 수평 및 수직 오류를 모두 포함합니다.	미터
latitudeError	위도 1시그마 오류 값 이 등록정보는 측위 기기가 NMEA 스트림에서 GST 문장을 지원하는 경우에만 채워집니다.	미터
longitudeError	경도 1시그마 오류 값 이 등록정보는 측위 기기가 NMEA 스트림에서 GST 문장을 지원하는 경우에만 채워집니다.	미터
altitudeError	고도 1시그마 오류 값 이 등록정보는 측위 기기가 NMEA 스트림에서 GST 문장을 지원하는 경우에만 채워집니다.	미터
hdop	위치 데이터의 수평 정도 저하율(HDOP)입니다.	N/A
vdop	위치 데이터의 수직 정밀도 저하율(VDOP)입니다.	N/A
pdop	위치 데이터의 위치 정밀도 저하율(PDOP)입니다. PDOP를 결정하기 위해 사용되는 방정식은 PDOP^2 = HDOP^2 + VDOP^2입니다.	N/A
differentialAge	별도로 위치를 수정하기 위해 GPS 수신기에서 사용되는 차등 신호 및 보정의 기간입니다.	초
referenceStationId	GPS 수신기에서 사용되는 건물의 차등 기준국 ID(DSID)	N/A
satellitesVisible	위치를 취득할 때 보이는 측위 위성의 수	N/A
satellitesInUse	위치 데이터를 반환하는 데 사용되는 측위 위성의 수	N/A

좌표 형식

pulldata("@geopoint") 함수를 사용하여 지오포인트 값을 추출하고 이를 추가 좌표 형식으로 지정할 수도 있습니다.

pulldata("@geopoint", ${location}, "DMS")는 지오포인트를 도, 분, 초로 반환합니다. 이 매개변수는 JSON 객체로 반환됩니다.
```
{
	"latitudeDegrees": 39,
	"latitudeHemisphere": "N",
	"latitudeMinutes": 57,
	"latitudeSeconds": 36.3,
	"latitudeText": "39°57'36.3\"N",
	"longitudeDegrees": 116,
	"longitudeHemisphere": "E",
	"longitudeMinutes": 27,
	"longitudeSeconds": 4,
	"longitudeText": "116°27'04.0\"E",
	"text": "39°57'36\"N 116°27'4\"E"
}
```
이러한 개별 값은 추가 매개변수를 사용하여 추출할 수 있습니다. 예를 들어 pulldata("@geopoint", ${location}, "DMS.latitudeMinutes")는 위도-분만 반환합니다.
pulldata("@geopoint", ${location}, "DDM")는 지오포인트를 도분(DDM)으로 반환하고 pulldata("@geopoint", ${location}, "DD")는 지오포인트를 십진도수(DD)로 반환합니다. 또한 JSON 객체로 반환되며 위의 도, 분, 초 형식과 동일한 방식으로 추가 매개변수로 개별 값을 추출할 수 있습니다.

다음 좌표 형식은 선택적 정밀도 매개변수와 함께 사용하여, 10의 거듭제곱인 10진수 값(예시: 0.01, 0.1, 1, 10 또는 100)을 생성할 수 있습니다.

pulldata("@geopoint", ${location}, "MGRS")는 지오포인트를 1미터 정밀도의 MGRS(Military Grid Reference System) 격자 값으로 반환합니다. 선택적 정밀도 매개변수를 제공하면 정밀도를 변경할 수 있습니다. 예를 들어, pulldata("@geopoint", ${location}, "MGRS", 100)은(는) 100미터 정밀도의 격자 값을 반환합니다.
pulldata("@geopoint", ${location}, "USNG")는 지오포인트를 1미터 정밀도의 USNG(United States National Grid) 격자 값으로 반환합니다.
pulldata("@geopoint", ${location}, "UTM")는 1미터의 정밀도로 UTM(Universal Transverse Mercator) 좌표로 지오포인트를 반환합니다. 이 매개변수는 JSON 객체로 반환됩니다.
```
{
	"band": "S",
	"easting": 452994,
	"northing": 4423429,
	"text": "50S 452994E 4423429N",
	"type": "UTM",
	"zone": 50
}
```
이러한 개별 값은 추가 매개변수를 사용하여 추출할 수 있습니다. 예를 들어 pulldata("@geopoint", ${location}, "UTM.easting", 0.01)는 1센티미터의 정밀도로 동향 값만 반환합니다.

지오포인트 심볼

지오포인트 질문은 현장조사의 body::esri:style 열에 있는 symbol 매개변수를 사용하여 맵의 포인트 마커에 대한 사용자 정의 심볼을 표시할 수 있습니다. 매개변수가 사용자 설정 심볼의 파일 이름을 제공해야 하며, 해당 파일은 현장조사의 미디어 폴더에 있는 .png 파일이어야 합니다. 다음 예시를 참고하세요.

symbol=hydrant.png

맵의 심볼 표시를 구성하는 매개변수(선택)를 symbol 매개변수로 사용할 수 있습니다. 이러한 매개변수는 물음표로 파일 이름과 구분하고 앰퍼샌드(&)로 서로 구분합니다. 예를 들어 symbol 매개변수는 다음과 같이 x, y, scale 등록정보를 포함할 수 있습니다.

symbol=hydrant.png?x=0.2&y=0.7&scale=2

x 매개변수는 심볼의 수평 고정점을 지정합니다. 해당 매개변수에는 0(이미지의 왼쪽 가장자리를 나타냄)~1(오른쪽 가장자리를 나타냄) 값이 사용됩니다. 매개변수가 정의되지 않은 경우 기본값은 0.5입니다.
y 매개변수는 심볼의 수직 고정점을 지정합니다. 해당 매개변수에는 0(이미지의 맨 위 가장자리를 나타냄)~1(맨 아래 가장자리를 나타냄) 값이 사용됩니다. 매개변수가 정의되지 않은 경우 기본값은 1입니다.
scale 매개변수는 이미지가 표시되는 축척을 지정합니다. 1 미만의 값은 이미지를 축소하고 1을 초과하는 값은 이미지를 확대합니다.

상수 값 또는 질문에 대한 참조(예시: symbol=${symbol_question})를 값으로 제공할 수 있습니다. 인라인 식은 지원되지 않습니다.

맵의 포인트 중첩

반복 내 첫 번째 지오포인트 질문의 포인트 위치는 지오포인트, 지오추적 또는 지오쉐이프 질문에 대한 body::esri:style 열을 overlay=repeat_name으로 설정하여 현장조사의 모든 맵 질문에 표시할 수 있습니다. 해당 반복에서 첫 번째 지오포인트 질문에 대해 취득한 모든 포인트가 맵에 표시됩니다. 추가 매개변수를 사용하여 중첩 심볼을 사용자 정의할 수 있습니다.

중첩 스타일에서 지원하는 선택적 매개변수는 다음과 같으며 앰퍼샌드로 구분할 수 있습니다(예시: overlay=repeat_name&preview=true).


매개변수	설명	예시
뷰	맵 질문에 중첩 포인트를 표시합니다. 기본값은 true입니다.	view=false
미리 보기	미리 보기 맵에 중첩 포인트를 표시합니다. 기본 값은 false입니다.	preview=true
icon	맵 핀에 사용할 포인트 심볼의 이름입니다. 사용 가능한 심볼은 ArcGIS Developer 문서의 포인트 심볼 라이브러리에서 확인할 수 있습니다.	icon=esri_pin_two
iconColor	맵 핀에 사용되는 아이콘의 색상입니다. 해당 매개변수에는 표준 색상 이름이나 16진수 색상 코드를 입력할 수 있습니다. 기본값은 검은색입니다.	iconColor=Blue
iconOutlineColor	맵 핀에 사용되는 윤곽선의 색상입니다. 해당 매개변수에는 표준 색상 이름이나 16진수 색상 코드를 입력할 수 있습니다. 기본값은 흰색입니다.	iconOutlineColor=#FF4500
iconSize	맵에 표시되는 아이콘의 크기입니다. 기본값은 30입니다.	iconSize=40
레이블	레이블로 사용할 현장조사 질문 이름입니다.	label=question_name
labelColor	포인트에 대한 레이블 색상입니다. 해당 매개변수에는 표준 색상 이름이나 16진수 색상 코드를 입력할 수 있습니다. 기본값은 검은색입니다.	labelColor=#FFD700
labelOutlineColor	레이블에 대한 윤곽선 색상입니다. 해당 매개변수에는 표준 색상 이름이나 16진수 색상 코드를 입력할 수 있습니다. 기본값은 흰색입니다.	labelOutlineColor=Black
fontSize	포인트에 대한 레이블의 글꼴 크기입니다. 기본값은 13입니다.	fontSize=16

질문 스타일

맵 질문에 대해 베이스맵, 맵 도구, 질문 높이를 구성할 수 있습니다.

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).

비고:

질문의 높이 및 맵 도구를 조정하는 기능은 Survey123 웹 앱에서 지원되지 않습니다.

이 항목에 대한 피드백을 제공하시겠습니까?

위치 정확도 임계값

위치 품질 식

팁:

95% 신뢰 구간 보고

고정밀도 예시

3D 피처 레이어

기본 설정

팁:

계산

필수 및 읽기 전용

지오서치 및 지오코드

비고:

역 지오코딩

팁:

프록시 로케이터 항목 구성

지오포인트 값 추출

좌표 형식

지오포인트 심볼

맵의 포인트 중첩

질문 스타일

비고:

본 항목