ArcGIS Survey123은 Survey123 웹 앱 또는 현장 앱, Survey123 Connect 또는 다른 앱을 열 수 있는 링크를 사용하여 다른 앱과 통합할 수 있습니다. 예를 들어 다른 Survey123 앱, 웹 맵 팝업 또는 이메일이나 웹사이트의 단순 하이퍼링크에서 Esri 현장 앱을 실행하고 열 수 있는 앱 링크를 생성할 수 있습니다. URL을 사용하여 현장조사를 자동으로 다운로드하고 열어서 Survey123 Connect에서 편집할 수 있습니다. 또한 ArcGIS QuickCapture 및 ArcGIS Field Maps 등 Survey123의 다른 앱에 연결할 수 있습니다.
테이블의 URL 패턴을 사용하여 웹 브라우저 또는 다른 앱에서 접근할 수 있는 링크를 생성합니다.
| 실행할 항목 | 링크할 위치 | 사용할 URL 패턴 |
|---|---|---|
웹 앱 | 웹 브라우저 | ID별 현장조사 양식: |
현장 앱 | Android 및 iOS | Survey123 앱 링크: |
Windows, Android, iOS용 특정 앱 그룹 | 사용자 설정 URL 스키마: | |
Survey123 Connect | Windows | 사용자 설정 URL 스키마: |
다른 앱 | 현장조사 양식 | Survey123의 링크: 앱별로 다름 |
다음 예시에서는 해당 URL 패턴을 사용하여 특정 현장조사를 여는 방법을 보여줍니다.
- https://survey123.arcgis.com/share/36ff9e8c13e042a58cfce4ad87f55d19
- https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19
- arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19
- arcgis-survey123connect://?portalUrl=https://www.arcgis.com&itemID=36ff9e8c13e042a58cfce4ad87f55d19
Survey123 앱 링크는 App Store 및 Google Play에서 설정한 요구 사항을 준수하므로 더 많은 앱에 연결할 수 있으며 공유하기 쉬운 단축 링크를 지원합니다.
사용자 설정 URL 스키마 링크는 단축할 수 없으며 Android에서 열기 어려울 수 있습니다. 다음과 유사한 하이퍼링크 형태로 사용자 설정 URL 스키마 링크를 제공하는 것을 고려합니다.
<a href="arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19">Open survey</a>URL 매개변수
링크 끝에 URL 매개변수를 추가하여 앱을 여는 방법을 추가로 사용자 정의할 수 있습니다. 예를 들어 지오포인트 질문의 기본 위치를 설정하거나 텍스트 질문을 채울 수 있습니다.
URL 매개변수는 ? 문자로 시작되며 & 문자로 구분됩니다. 다음 예시에서는 첫 번째 매개변수(itemID)가 ? 문자로 시작되고 각 후속 필드 매개변수(color_1 및 color_2)가 & 문자로 구분되는 사용자 설정 URL 스키마를 보여줍니다.
arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:color_1=red&field:color_2=blue더 많은 예시 URL 및 지원되는 URL 매개변수는 웹 앱 실행, 현장 앱 실행, Survey123 Connect 실행, Survey123에서 다른 앱 실행을 참조하세요.
비고:
현장 앱에서 현장조사를 시작하기 위해 매개변수가 포함된 링크를 사용하기 전에 해당 앱을 기기에 설치할 것을 권장합니다. 자세한 내용은 Survey123 현장 앱 설치를 참고하세요.
URL 인코딩
일부 환경에서는 인코딩되지 않은 URL 매개변수가 작동하지만 URL 매개변수를 인코딩하는 것을 권장합니다. 인코딩은 잘못된 문자를 퍼센트 기호(%)로 대체하여 해당 16진수 값이 뒤에 나타납니다.
다음 예시는 인코딩되지 않은 매개변수로 Survey123의 특정 프로젝트로 돌아가는 호출이 사용된 QuickCapture 링크입니다.
https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https://quickcapture.arcgis.app?itemID=867895a71a1840399476fc717e76bb43다음은 인코딩된 매개변수가 사용된 동일한 URL입니다.
https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https%3A%2F%2Fquickcapture.arcgis.app%3FitemID=867895a71a1840399476fc717e76bb43키와 해당 값 사이의 구분을 지정하는 등호는 인코딩해서는 안 됩니다.
팁:
인코딩된 매개변수를 생성하는 한 가지 방법은 ArcGIS Arcade를 사용하는 것입니다. UrlEncode 함수를 사용하면 각 매개변수를 나타내는 키 값 쌍 컬렉션을 정의하고 적절한 인코딩으로 URL을 생성할 수 있습니다.
현장조사 작성자는 기밀 데이터가 URL에 보이지 않도록 URL 매개변수를 가릴 수도 있습니다. 이 경우에는 웹 앱에 사용할 URL을 생성할 때 encodeUrlParams=true를 포함해야 합니다. 자세한 내용은 웹 앱을 열기 위한 URL 매개변수를 참고하세요.