Map Viewer 또는 Map Viewer Classic을 사용하여 작성된 맵에는 베이스맵, 데이터 레이어, 범위, 범례, 내비게이션 도구(예시: 확대, 이동, 장소 찾기, 북마크)가 포함되어 있습니다. 또한 많은 맵에 베이스맵 갤러리와 같은 대화형 요소를 비롯하여 측정 도구, 팝업, 시간별 데이터를 재생하는 버튼 등이 포함되어 있습니다.
Map Viewer 또는 Map Viewer Classic을 사용해 맵을 생성하는 방법 외에 URL 매개변수를 사용해 맵을 직접 생성하거나 수정할 수 있습니다.
예를 들어 URL 매개변수를 사용해 생물군계 및 생태 지역을 보여주는 맵을 생성할 수 있습니다.
https://www.arcgis.com/apps/mapviewer/index.html?basemapUrl=https://basemaps.arcgis.com/arcgis/rest/services/World_Basemap_v2/VectorTileServer&url=https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/Resolve_Ecoregions/FeatureServer예를 들어 다음과 같은 경우에 Map Viewer URL을 사용할 수 있습니다.
- 많은 참조 또는 운영 레이어를 포함할 필요가 없고 맵 콘텐츠에 특정 스타일을 적용할 필요가 없는 경우 URL을 사용해 Map Viewer를 엽니다. 예를 들어 웹사이트에서 사용자들이 주소를 찾거나 해당 사이트와 관련된 단일 레이어를 확인할 수 있도록 허용하는 경우 지정된 베이스맵 및 필요한 단일 레이어로 Map Viewer를 여는 링크를 웹사이트에 포함할 수 있습니다.
- 웹사이트 또는 이메일에서 저장된 웹 맵에 연결해야 합니다. 특정 웹 맵을 여는 URL을 사용할 수 있습니다.
URL에 포함할 사항
URL은 항상 Map Viewer에서 https://www.arcgis.com/apps/mapviewer/index.html?(으)로 시작하고 Map Viewer Classic에서 https://www.arcgis.com/home/webmap/viewer.html?(으)로 시작하며 아래 나열된 하나 이상의 쿼리 매개변수를 포함합니다. 매개변수를 둘 이상 포함하려면 앰퍼샌드(&)를 사용하여 매개변수를 구분합니다. 이 페이지 전체에서 다중 매개변수를 사용하는 예시를 확인할 수 있습니다.
다음 예시를 참고하세요.
https://www.arcgis.com/apps/mapviewer/index.html?center=20,45&level=8비고:
URL 매개변수의 리소스가 HTTP로 제공된 경우 URL에서 HTTP를 HTTPS로 바꾸고 모든 리소스를 HTTPS로만 접근 가능하도록 설정해야 합니다.
쿼리문 매개변수 인코딩
모든 쿼리문 매개변수를 인코딩해야 합니다. URL을 인코딩하면 올바른 문자가 ArcGIS Online으로 전송됩니다. 인코딩은 잘못된 문자를 %로 대체하여 해당 16진수 값이 뒤에 나타냅니다.
예를 들어 다음은 인코딩되지 않은 URL 매개변수입니다.basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/Ocean/World_Ocean_Base/MapServer
다음은 인코딩된 동일한 매개변수입니다.basemapUrl=https%3A%2F%2Fservices.arcgisonline.com%2FArcGIS%2Frest%2Fservices%2FOcean%2FWorld_Ocean_Base%2FMapServer
매개변수 내의 매개변수도 인코딩해야 합니다. 예:urls=https%3A%2F%2Fmaps.ngdc.noaa.gov%2Frest%2Fservices%2Fweb_mercator%2Ftrackline_gravity%2FMapServer%2Chttps%3A%2F%2Fmaps.ngdc.noaa.gov%2Frest%2Fservices%2Fweb_mercator%2Fhazards%2FMapServer%3Flayers%3Dshow%3A5%2C6
인터넷에는 인코딩된 URL을 생성할 수 있는 여러 무료 사이트 및 도구가 있습니다(예시: https://www.urlencoder.io/). 이 항목의 나머지 예제는 인코딩되지 않았습니다. 웹브라우저에서 인코딩된 URL을 보려면 예시 뒤에 있는 Map Viewer에서 해당 예시 보기 링크를 클릭합니다.
저장된 맵 열기
Map Viewer 또는 Map Viewer Classic으로 생성해 저장한 맵을 열려면 webmap= 및 맵의 고유 ID를 사용합니다.
이 예시에서 ID가 75a3ce8990674a5ebd5b9ab66bdab893인 웹 맵은 Map Viewer에서 열립니다.
https://www.arcgis.com/apps/mapviewer/index.html?webmap=75a3ce8990674a5ebd5b9ab66bdab893이 예시에서 ID가 29990ur6423j1180p53f9t30019491인 웹 맵은 범위가 -117.996342,33.841078,-117.993692,33.844375로 설정된 Map Viewer에서 열립니다.
https://www.arcgis.com/apps/mapviewer/index.html?webmap=29990ur6423j1180p53f9t30019491&extent=-117.996342,33.841078,-117.993692,33.844375베이스맵 정의
베이스맵을 정의하려면 레이어에 basemapUrl=을(를) 설정합니다. 베이스맵이 정의되어 있지 않으면 기본 설정에 따라 지형도 베이스맵이 사용됩니다.
이 예시에서 Map Viewer는 OpenStreetMap을 베이스맵으로 사용하여 열립니다.
https://www.arcgis.com/apps/mapviewer/index.html?basemapUrl=https://basemaps.arcgis.com/arcgis/rest/services/OpenStreetMap_v2/VectorTileServer&layers=9e2f2b544c954fda9cd13b7f3e6eebce이 예시에서 Map Viewer는 베이스맵으로 사용된 World Physical Map 및 맵에 항목 ID가 9e2f2b544c954fda9cd13b7f3e6eebce인 운영 레이어로 열립니다.
https://www.arcgis.com/apps/mapviewer/index.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Physical_Map/MapServer&layers=9e2f2b544c954fda9cd13b7f3e6eebce참조 레이어 포함
베이스맵과 함께 참조 레이어를 포함하려면 레이어에 basemapReferenceUrl=을(를) 설정합니다. basemapUrl 매개변수와 함께 basemapReferenceUrl= 매개변수도 사용해야 합니다.
이 예시에서 Map Viewer는 World Imagery 베이스맵 레이어 및 참조 레이어가 경계 및 장소 레이어에 설정되어 열립니다.
https://www.arcgis.com/apps/mapviewer/index.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer&basemapReferenceUrl=https://services.arcgisonline.com/ArcGIS/rest/services/Reference/World_Boundaries_and_Places/MapServer이 예시에서 Map Viewer는 World Imagery 맵 이미지 레이어가 있고 베이스맵이 World Imagery 베이스맵 레이어로 설정된 상태로 열립니다.
https://www.arcgis.com/apps/mapviewer/index.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer&basemapReferenceUrl=https://services.arcgisonline.com/ArcGIS/rest/services/Reference/World_Boundaries_and_Places/MapServer&layers=df610ec7afe74b1995a913ec1fc1284e운영 레이어 정의
베이스맵을 중첩하는 운영 레이어를 정의하려면 webmap=, layers=, layerIds=, url= 또는 urls=를 사용합니다. 레이어가 웹사이트에 있는 항목이라면 layers=을(를) 사용하여 모든 레이어 구성을 가져옵니다. 여러 하위 레이어가 포함된 피처 레이어에서 개별 하위 레이어를 추가하려면 layerIds=를 사용합니다. 레이어가 웹사이트에 없는 경우에는 url= 또는 urls=을(를) 사용합니다.
layers= 매개변수는 단일 항목 ID 또는 여러 항목 ID를 승인합니다. 레이어가 여러 개인 경우 쉼표로 구분된 ID 목록(&layers=<itemID>,<itemID>,<itemID>)을 사용합니다.
다음 예시를 참고하세요.
https://www.arcgis.com/apps/mapviewer/index.html?webmap=8152694dd9594393a1db4d62d2020fe3&layers=9e2f2b544c954fda9cd13b7f3e6eebce,dece90af1a0242dcbf0ca36d30276aa3layerIds= 매개변수는 단일 레이어 ID 또는 여러 레이어 ID를 승인합니다. 피처 레이어에 여러 하위 레이어가 포함되어 있으면 layerIds= 매개변수를 사용하여 개별 하위 레이어를 추가합니다. 레이어가 여러 개인 경우 쉼표로 구분된 ID 목록(&layerIds=0,1,2)을 사용합니다.
다음 예시를 참고하세요.
https://www.arcgis.com/apps/mapviewer/index.html?layers=025063719c32408dbd4fb608faa28d2a&layerIds=0,2url= 매개변수는 단일 레이어 URL을 허용합니다.
다음 예시를 참고하세요.
https://www.arcgis.com/apps/mapviewer/index.html?url=https://services9.arcgis.com/RHVPKKiFTONKtxq3/arcgis/rest/services/USGS_Seismic_Data_v1/FeatureServer여러 레이어를 포함하려면 urls=을(를) 사용합니다. 레이어를 쉼표로 구분합니다. 맵 범위는 목록에 있는 마지막 레이어 또는 가장 느리게 불러오는 레이어를 기준으로 합니다. 특정 범위로 확대하려면 extent= 매개변수를 포함합니다.
다음 예시를 참고하세요.
https://www.arcgis.com/apps/mapviewer/index.html?urls=https://services9.arcgis.com/RHVPKKiFTONKtxq3/arcgis/rest/services/NOAA_METAR_current_wind_speed_direction_v1/FeatureServer,https://services9.arcgis.com/RHVPKKiFTONKtxq3/arcgis/rest/services/NOAA_storm_reports_v1/FeatureServer?layers=show:4&extent=-108,40,-85,31축척 수준 정의 및 중앙에 맵 배치
webmap 또는 find 매개변수를 사용할 경우 Map Viewer Classic의 맵에 대해 축척이 자동으로 설정됩니다. webmap 매개변수를 사용할 경우 level과 center 또는 extent 등 다른 URL 매개변수로 웹 맵 축척을 재정의하지 않는 한 맵의 전체 범위로 맵이 자동 확대됩니다. find 매개변수를 사용할 경우 맵은 찾은 위치의 최적 범위로 자동으로 확대됩니다.
특정 축척 수준을 정의하려면 center 및 level 매개변수를 사용합니다. level 매개변수는 타일 베이스맵의 REST 서비스 엔드포인트에 나열된 것과 같이 캐시 축척의 수준 ID를 허용합니다. 해상도는 축척과 반비례합니다. level 매개변수는 타일 베이스맵에만 지원되며 동적 맵 서비스 및 기타 비타일 데이터에서 생성된 베이스맵에는 지원되지 않습니다.
특정 위치에서 맵을 가운데에 두려면 지리 좌표(x, y) 또는 투영 좌표(x, y, WKID)를 사용하여 center를 설정합니다. 구분 기호로 쉼표 또는 세미콜론을 사용합니다. 숫자의 소수점으로 쉼표를 사용하는 경우에는 세미콜론을 사용합니다.
비고:
level 및 center 매개변수는 함께 사용해야 합니다. level 매개변수는 단독으로 사용될 경우 무시됩니다.
다음 지리 좌표 예시를 확인하세요.
https://www.arcgis.com/apps/mapviewer/index.html?center=20,45&level=4다음 투영 좌표 예시를 확인하세요.
https://www.arcgis.com/apps/mapviewer/index.html?center=500000,5500000,102100&level=4범위 정의
extent을(를) 사용하여 맵 범위를 정의합니다. extent 매개변수는 지리 좌표(GCS)로 MinX,MinY,MaxX,MaxY 또는 투영 좌표(PCS)로 MinX,MinY,MaxX,MaxY,WKID를 허용합니다. 구분 기호로 쉼표 또는 세미콜론을 사용합니다. 숫자의 소수점으로 쉼표를 사용하는 경우에는 세미콜론을 사용합니다.
다음 지리 좌표 예시를 확인하세요.
https://www.arcgis.com/apps/mapviewer/index.html?extent=-117.20,34.055,-117.19,34.06다음 투영 좌표 예시를 확인하세요.
https://www.arcgis.com/apps/mapviewer/index.html?extent=-13079253.954115,3959110.38566837,-12918205.318785,4086639.70193162,102113레이어 가시성 설정
맵에서 연 레이어에 대한 하위 레이어의 가시성을 설정하려면 layers=show:를 사용합니다.
이 예시에서 하위 레이어 3은 표시되지만 다른 하위 레이어는 표시되지 않습니다.
비고:
하위 레이어 번호 매기기는 REST 엔드포인트에 표시된 대로 0부터 시작됩니다.https://www.arcgis.com/apps/mapviewer/index.html?url=https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/BLS_Monthly_Unemployment_Current_14_Months/FeatureServer?layers=show:2&find=Pennsylvania맵을 열 위치 또는 피처 찾기
맵을 열고 바로 위치 또는 피처를 찾으려면 find를 사용합니다. 가장 일치하는 항목으로 맵이 자동으로 확대되고 설명선 표시가 맵에 추가됩니다. find 매개변수에는 한 줄 주소, 부분 주소(예시: 도시 또는 국가만), 장소 이름, 위도-경도 좌표, 검색 가능한 레이어의 피처(예시: 필지 인지 번호(PIN) 1916352001)를 사용할 수 있습니다.
다음 예시에서는 한 줄 주소를 사용합니다.
https://www.arcgis.com/apps/mapviewer/index.html?find=380 new york st,redlands,ca팁:
검색 가능한 레이어에서 위치 또는 피처를 찾으려면 맵의 고유 ID에 webmap= 매개변수를 포함합니다.
포인트 추가
맵에 포인트를 추가하려면 marker=<x>,<y>을(를) 사용합니다. 또한 다음과 같은 등록정보(옵션)를 포함할 수 있습니다.
- <wkid> — 맵에 추가되는 x, y 좌표의 공간 기준 체계입니다. WKID를 포함하지 않으면 GCS 좌표가 사용됩니다.
- <encoded title> — 포인트 팝업의 제목입니다. 제목을 포함하지 않으면 팝업이 비어 있습니다.
- <encoded icon URL> — 포인트에 대한 심볼입니다. 심볼을 포함하지 않으면 파란색 표시 심볼이 사용됩니다.
- <encoded label> — 포인트 심볼 옆에 있는 레이블입니다.
예시
다음 예시에서는 세미콜론 구분 기호를 사용합니다.
https://www.arcgis.com/apps/mapviewer/index.html?marker=-79.234826;38.147884;;Race start and finish;;Grindstone 100 Ultra Marathon검토사항
맵에 포인트를 추가할 때는 다음 사항에 유의하세요.
- Map Viewer Classic의 지정된 x, y 좌표 위치에서 새 맵 노트 레이어에 포인트가 추가됩니다.
- 포인트를 추가하려면 <x>,<y> 좌표가 필요합니다.
- title, icon, label 매개변수를 인코딩해야 합니다.
- 이 순서에 따라 등록정보를 추가해야 합니다. marker=<x>,<y>,<wkid>,<encoded title>,<encoded icon URL>,<encoded label>.
- 구분 기호로 쉼표 또는 세미콜론을 사용합니다. 숫자의 소수점으로 쉼표를 사용하는 경우에는 세미콜론을 사용합니다.
- 빈 값을 사용합니다. 공백은 사용하면 안 됩니다. 예를 들어 레이블을 지정할 때 다른 등록정보(옵션)가 없으면 다른 항목(x;y;;;;label)에 대해 빈 값을 사용한 여섯 번째 매개변수로 레이블을 추가합니다.
- 특정 포인트를 가운데에 두고 맵을 확대하려면 level 매개변수를 포함합니다.
- 맵 또는 항목으로 맵 노트 레이어를 편집하고 저장할 수 있습니다.
- 기관 계정은 포인트를 길찾기 표시 및 분석 수행에 사용할 수 있습니다.
세부정보 창 숨기기
비고:
현재 이 기능은 Map Viewer Classic에서만 지원됩니다. Map Viewer의 후속 릴리즈에서 제공됩니다.
Map Viewer Classic의 세부정보 창을 숨기려면 mapOnly=true를 사용합니다.
이 예시에서 ID가 8505192e747d440098523e9e64419710인 저장된 웹 맵은 Map Viewer Classic에서 열리지만 세부정보 창은 숨겨집니다.
https://www.arcgis.com/home/webmap/viewer.html?webmap=8505192e747d440098523e9e64419710&mapOnly=true