Map Viewer 템플릿에서는 사용자가 단일 맵 또는 맵 갤러리를 검색하고 볼 수 있는 앱을 생성할 수 있습니다. Map Viewer 앱에 대해 자세히 알아보고 예시를 확인하려면 이 스토리를 참고하세요.
이 템플릿으로 앱을 생성하는 경우 앱 제목을 입력해야 합니다. 설정 도구를 사용해 Map Viewer 앱을 사용자 정의하세요.
요구 사항
Map Viewer 템플릿에 대한 요구 사항은 다음과 같습니다.
- 웹 맵은 공개 상태이거나 보안 상태일 수 있습니다. OAuth2를 사용하는 ArcGIS Enterprise 포털이나 기관의 보안 웹 맵에 접근하려면 앱을 등록하고 클라이언트 ID를 입력해야 합니다. 자세한 내용은 앱 서명을 참고하세요. 기본 설정에 따라 Map Viewer 갤러리에는 공개 웹 맵만 보여집니다. 보안 맵에 접근하려면 앱 설정에서 보안 맵 지원 등록정보를 활성화해야 합니다.
- Map Viewer 쿼리 문자열은 웹 맵과 함께 모바일 맵 패키지(MMPK)를 지원합니다. 기본 템플릿의 라이선싱 제한으로 인해 익명 사용이 활성화된 ArcGIS Pro Publisher 익스텐션을 사용하여 생성된 모바일 맵 패키지가 아닌 경우 이러한 모바일 맵 패키지에 접근해서 확인하려면 포털 또는 기관 계정에 로그인해야 합니다. MMPK 생성에 대한 자세한 내용은 모바일 맵 패키지에 대한 ArcGIS Pro 문서 또는 ArcGIS Pro를 사용하여 오프라인 맵 만들기 - 파트 1 블로그 게시물을 참고하세요.
- 웹 맵 버전이 2.0 이상이어야 합니다. 그렇지 않으면 맵 불러오기에 실패합니다.
- 선택 사항 - 앱에서 피처 검색을 사용하려면 검색 기능을 가진 웹 맵 레이어가 웹 맵에 하나 이상 구성되어 있어야 합니다.
- 선택 사항 - 웹 맵 식별 기능을 사용하려면 웹 맵에 레이어에 대한 팝업을 활성화해야 합니다.
- 선택 사항 - 북마크 기능을 사용하려면 웹 맵에 북마크를 구성해야 합니다.
- 선택 사항 - 범례를 표시하려면 맵 서비스에서 범례가 정의되어 있는 웹 맵 레이어가 하나 이상 있어야 합니다.
Map Viewer 템플릿은 맵 서비스를 나타낼 때 가장 원활하게 작동됩니다. 피처 서비스를 보이게 할 수도 있지만 보통 느리게 그려집니다.
앱 사용자 정의
앱을 생성한 후에는 앱 설정을 변경하여 앱을 사용자 정의할 수 있습니다.
AppStudio를 시작한 다음 측면 패널에서 설정 > 등록정보를 클릭합니다. 다음 테이블에는 Map Viewer 등록정보 탭에 있는 탭의 콘텐츠(해당 탭별로 정렬되어 있음)와 용도가 나와 있습니다. 해당 등록정보는 앱의 appinfo.json 파일에서 직접 수정할 수도 있습니다. 이러한 등록정보를 변경한 경우 앱을 다시 시작하기 전에 적용을 클릭하여 등록정보를 저장해야 합니다.
시작 화면 탭 콘텐츠
| 등록정보 | JSON name | 유형 | 설명 |
|---|---|---|---|
배경 이미지 | startBackground | 문자열(이미지 URL) | 시작 페이지 배경에 사용할 이미지입니다. |
브랜드 색상 | startForegroundColor | 문자열(색상 값) | 기본 색상으로 사용되는 색상입니다. |
기본 글꼴 크기 | baseFontSize | 숫자 | 앱 전반에 사용될 기본 글꼴 크기를 설정합니다. |
제목 글꼴 파일 | regularFontTTF | 문자열(글꼴 파일 URL) | 앱 전반에서 사용될 사용자 설정 제목 글꼴을 설정합니다. 이 글꼴은 머리글과 페이지 제목 등에 사용됩니다. |
텍스트 글꼴 파일 | mediumFontTTF | 문자열(글꼴 파일 URL) | 앱 전반에 사용될 사용자 설정 텍스트 글꼴을 설정합니다. 이 글꼴은 사진 설명, 정보 텍스트 등에 사용됩니다. |
피드백 이메일 | feedbackEmail | 문자열(이메일 ID) | 사용자 피드백이 전송될 이메일 주소입니다. |
고지 사항 표시 | showDisclaimer | Boolean(true|false) | 앱에서 고지 사항 텍스트를 팝업으로 보여줍니다. 이 텍스트는 세부정보 탭의 접근 및 사용 제약 조건 섹션 내용입니다. |
갤러리 탭 콘텐츠
| 등록정보 | JSON name | 유형 | 설명 |
|---|---|---|---|
맵 쿼리 | galleryMapsQuery | 문자열 | 갤러리에 표시할 포털의 웹 맵 또는 모바일 맵 패키지를 선택하는 ArcGIS 쿼리를 입력합니다. USA 등의 유효한 문자열 또는 id:d5e02a0c1f2b4ec399823fdd3c2fdebd 등의 유효한 항목 ID를 입력할 수 있습니다. |
갤러리에 표시할 총 결과 | maxNumberOfQueryResults | 숫자 | 포털 쿼리에서 반환되어야 하는 최대 웹맵 수를 입력합니다. |
포털 URL | portalUrl | 문자열 | 웹 맵을 쿼리하는 ArcGIS Portal의 URL입니다. |
베이스맵 그룹 ID | baseMapsGroupId | 문자열 | 제공된 그룹의 베이스맵을 나열합니다. |
보안 맵 지원 | supportSecuredMaps | Boolean(true|false) | 쿼리 매개변수에 따라 보안 웹 맵 및 MMPK에 접근하기 위한 기관 로그인 기능을 제공합니다. |
로그인 건너뛰기 | enableAnonymousAccess | Boolean(true|false) | 로그인을 생략하고 공개적으로 제공된 웹 맵과 익명 사용이 활성화된 ArcGIS Pro Publisher 익스텐션을 사용하여 생성된 모바일 맵 패키지만 표시하는 기능을 제공합니다. 기본값은 true입니다. |
편집 지원 | supportEditAttributes | Boolean(true|false) | 이 옵션을 true로 설정하면 피처 레이어를 편집할 수 있고 사용자에게 피처 편집 권한이 있는 경우 피처 속성 및 첨부 파일을 편집할 수 있습니다. |
갤러리에 표시할 맵 | mapTypes | 옵션(콤보 상자) | Map Viewer 갤러리에 표시할 맵의 유형을 지정합니다. 온라인 웹 맵만 표시하는 showWebMapsOnly, 모바일 맵 패키지만 표시하는 showOfflineMapsOnly 또는 웹 맵과 모바일 맵 패키지를 둘 다 표시하는 showBoth를 지정할 수 있습니다. |
포털 정렬 필드 | portalSortField | 문자열 | 갤러리에 표시된 웹 맵을 정렬하는 데 사용되는 필드의 이름을 지정합니다. title, created, type, owner, modified, avgRating, numRatings, numComments, numViews 값을 지정할 수 있습니다. 기본값은 modified입니다. |
포털 정렬 순서 | portalSortOrder(asc|desc) | 문자열 | 지정된 portalSortField에 따라, 갤러리에 표시되는 웹 맵의 순서를 오름차순이나 내림차순으로 지정합니다. 기본값은 desc입니다. |