Skip To Content

URL 매개변수를 사용하여 맵 생성 및 수정

ArcGIS Enterprise portal에 작성된 맵에는 베이스맵, 데이터 레이어, 범위, 범례, 내비게이션 도구(예시: 확대, 이동, 장소 찾기, 북마크)가 포함되어 있습니다. 또한 많은 맵에 베이스맵 갤러리와 같은 대화형 요소를 비롯하여 측정 도구, 팝업, 시간별 데이터를 재생하는 버튼 등이 포함되어 있습니다.

Map Viewer 또는 Map Viewer Classic을 사용해 맵을 생성하는 방법 외에 URL 매개변수를 사용해 맵을 직접 생성하거나 수정할 수 있습니다.

예를 들어 URL 매개변수를 사용해 Maryland 해안의 모래사장을 보여주는 맵을 생성할 수 있습니다.

myportal.domain.com/arcgis/apps/mapviewer/index.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/Ocean_Basemap/MapServer&url=https://services5.arcgis.com/9cBkZtsx7PSOoaCF/arcgis/rest/services/Maryland_Shoals/FeatureServer/0

URL 매개변수를 사용하여 Map Viewer Classic에서 영국의 해풍 풍력발전단지를 보여주는 맵을 작성할 수 있습니다.

https://myportal.domain.com/arcgis/home/webmap/viewer.html?basemapUrl=https%3A%2F%2Fservices.arcgisonline.com%2FArcGIS%2Frest%2Fservices%2FOcean_Basemap%2FMapServer&url=https%3A%2F%2Fservices.arcgis.com%2FWQ9KVmV6xGGMnCiQ%2Farcgis%2Frest%2Fservices%2FOnshore_Windfarms%2FFeatureServer&extent=-24.3161%2C45.2274%2C18.0911%2C63.5381

예를 들어 다음과 같은 경우에 Map Viewer URL을 사용할 수 있습니다.

  • 많은 참조 또는 운영 레이어를 포함할 필요가 없고 맵 콘텐츠에 특정 스타일을 적용할 필요가 없는 경우 URL을 사용해 Map Viewer 중 하나를 엽니다. 예를 들어 웹사이트에서 사용자들이 주소를 찾거나 해당 사이트와 관련된 단일 레이어를 확인할 수 있도록 허용하는 경우 지정된 베이스맵 및 필요한 단일 레이어로 Map Viewer를 여는 링크를 웹사이트에 포함할 수 있습니다.
  • 웹사이트 또는 이메일에서 저장된 웹 맵에 연결해야 합니다. 특정 웹 맵을 여는 URL을 사용할 수 있습니다.

URL에 포함할 사항

Map Viewer Classic에서 URL은 항상 ArcGIS Enterprise portal 홈페이지 URL, /webmap/viewer.html?, 아래 나열된 하나 이상의 쿼리 매개변수로 시작합니다. Map Viewer에서 URL은 항상 정규화된 ArcGIS Enterprise 이름, 웹 어댑터 또는 로드 밸런서 컨텍스트, apps/mapviewer/index.html?, 아래 나열된 쿼리 매개변수 중 하나 이상으로 시작합니다. 매개변수를 둘 이상 포함하려면 앰퍼샌드(&)를 사용하여 매개변수를 구분합니다. 이 페이지 전체에서 다중 매개변수를 사용하는 예시를 확인할 수 있습니다.

아래의 첫 번째 예시에서는 Map Viewer가 열리며 두 번째 예시에서는 Map Viewer Classic이 열립니다.

https://myportal.domain.com/arcgis/home/webmap/viewer.html?center=20,45&level=4

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?center=20,45&level=4
비고:

URL 매개변수의 리소스가 HTTP로 제공된 경우 맵에 대한 URL도 HTTP여야 합니다. 보안을 위해 가능하면 HTTPS URL을 사용하세요.

쿼리문 매개변수 인코딩

모든 쿼리문 매개변수를 인코딩해야 합니다. URL을 인코딩하면 올바른 문자가 포털로 전송됩니다. 인코딩은 잘못된 문자를 %로 대체하여 해당 16진수 값이 뒤에 나타냅니다.

예를 들어 다음은 인코딩되지 않은 URL 매개변수입니다.

basemapUrl=https://myportal.domain.com:7443/arcgis/rest/services/Ocean_Basemap/MapServer

다음은 인코딩된 동일한 매개변수입니다.

basemapUrl=https%3A%2F%2Fmyportal.domain.com:7443%2Farcgis%2Frest%2Fservices%2FOcean_Basemap%2FMapServer

매개변수 내의 매개변수도 인코딩해야 합니다. 예:

urls=https%3A%2F%2Fmyportal.domain.com:7443%2Farcgis%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을 생성할 수 있는 무료 사이트 및 도구가 많이 있습니다. 이 항목의 나머지 예제는 인코딩되지 않았습니다.

저장된 맵 열기

Map Viewer 또는 Map Viewer Classic으로 생성해 저장한 맵을 열려면 webmap= 및 맵의 고유 ID를 사용합니다.

첫 번째 예시에서 ID가 8505192e747d440098523e9e64419710인 웹 맵은 Map Viewer Classic에서 열립니다. 두 번째 URL은 Map Viewer에서 동일한 맵을 엽니다.

https://myportal.domain.com/arcgis/home/webmap/viewer.html?webmap=8505192e747d440098523e9e64419710

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?webmap=8505192e747d440098523e9e64419710

이 예시에서 ID가 29990ur6423j1180p53f9t30019491인 웹 맵은 범위가 -117.996342,33.841078,-117.993692,33.844375로 설정된 Map Viewer에서 열립니다.

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?webmap=29990ur6423j1180p53f9t30019491&extent=-117.996342,33.841078,-117.993692,33.844375

베이스맵 정의

베이스맵을 정의하려면 레이어에 basemapUrl=을(를) 설정합니다. 베이스맵이 정의되어 있지 않으면 기본 설정에 따라 지형도 베이스맵이 사용됩니다.

첫 번째 예시 URL에서 Map Viewer는 베이스맵으로 사용된 World physical map이 열립니다. 두 번째 예시 URL은 Map Viewer Classic에서 엽니다.

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Physical_Map/MapServer

https://myportal.domain.com/arcgis/home/webmap/viewer.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Physical_Map/MapServer

이 예시에서 Map Viewer는 베이스맵으로 사용된 World physical map이 및 맵에 항목 ID가 d35a5w4bo77593y0358s0x7312jpp04인 운영 레이어로 열립니다.

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Physical_Map/MapServer&layers=d35a5w4bo77593y0358s0x7312jpp04

참조 레이어 포함

베이스맵과 함께 참조 레이어를 포함하려면 레이어에 basemapReferenceUrl=을(를) 설정합니다. basemapUrl 매개변수와 함께 basemapReferenceUrl= 매개변수도 사용해야 합니다.

이 예시에서 Map Viewer Classic는 World Imagery 맵 이미지 레이어가 있고 베이스맵이 경계와 장소 레이어로 설정된 상태로 열립니다.

https://myportal.domain.com/arcgis/home/webmap/viewer.html?
basemapUrl=https://services.myportal.domain.com:7443/arcgis/rest/services/World_Imagery/MapServer
&basemapReferenceUrl=https://services.myportal.domain.com:7443/arcgis/rest/services/Reference/World_Boundaries_and_Places/MapServer

운영 레이어 정의

베이스맵을 중첩하는 운영 레이어를 정의하려면 webmap=, layers=, url= 또는 urls=를 사용합니다. 레이어가 웹사이트에 있는 항목이라면 layers=을(를) 사용하여 모든 레이어 구성을 가져옵니다. 레이어가 웹사이트에 없는 경우에는 url= 또는 urls=을(를) 사용합니다.

layers= 매개변수는 단일 항목 ID 또는 여러 항목 ID를 승인합니다. 레이어가 여러 개인 경우 쉼표로 구분된 ID 목록(&layers=<itemID>,<itemID>,<itemID>)을 사용합니다.

첫 번째 예시는 Map Viewer에서 열립니다. 두 번째 예시는 Map Viewer Classic에서 열립니다.

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?layers=a79a3e4dc55343b08543b1b6133bfb90,a068913914cd4fecb302b9207a532d1a

https://myportal.domain.com/arcgis/home/webmap/viewer.html?layers=a79a3e4dc55343b08543b1b6133bfb90,a068913914cd4fecb302b9207a532d1a

url= 매개변수는 단일 레이어 URL을 허용합니다.

예:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?
     url=https://services.myportal.domain.com:7443/arcgis/rest/services/Demographics/USA_Population_Density/MapServer

여러 레이어를 포함하려면 urls=을(를) 사용합니다. 레이어를 쉼표로 구분합니다. 맵 범위는 목록에 있는 마지막 레이어 또는 가장 느리게 불러오는 레이어를 기준으로 합니다. 특정 범위로 확대하려면 extent= 매개변수를 포함합니다.

첫 번째 URL은 Map Viewer에서 맵을 엽니다. 두 번째 URL은 Map Viewer Classic에서 엽니다.

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?urls=https://services.myportal.domain.com:7443/arcgis/rest/services/web_mercator/trackline_gravity/MapServer,https://maps.ngdc.noaa.gov/rest/services/web_mercator/hazards/MapServer?layers=show:5,6,12&extent=5,45,10,50

https://myportal.domain.com/arcgis/home/webmap/viewer.html?urls=https://services.myportal.domain.com:7443/arcgis/rest/services/web_mercator/trackline_gravity/MapServer,https://maps.ngdc.noaa.gov/rest/services/web_mercator/hazards/MapServer?layers=show:5,6,12&extent=5,45,10,50

ArcGIS 10.5부터는 피처 서비스에서 ?layers 작업을 수행할 수 있습니다.

예:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?url=https://sampleserver6.arcgisonline.com/arcgis/rest/services/RedlandsEmergencyVehicles/FeatureServer?layers=show:1,2

축척 수준 정의 및 중앙에 맵 배치

webmap 또는 find 매개변수를 사용할 경우 Map Viewer Classic의 맵에 대해 축척이 자동으로 설정됩니다. webmap 매개변수를 사용할 경우 levelcenter 또는 extent 등 다른 URL 매개변수로 웹 맵 축척을 재정의하지 않는 한 맵의 전체 범위로 맵이 자동 확대됩니다. find 매개변수를 사용할 경우 맵은 찾은 위치의 최적 범위로 자동으로 확대됩니다.

특정 축척 수준을 정의하려면 centerlevel 매개변수를 사용합니다. level 매개변수는 타일 베이스맵의 REST 서비스 엔드포인트에 나열된 것과 같이 캐시 축척의 수준 ID를 허용합니다. 해상도는 축척과 반비례합니다. level 매개변수는 타일 베이스맵에만 지원되며 동적 맵 서비스 및 기타 비타일 데이터에서 생성된 베이스맵에는 지원되지 않습니다.

특정 위치에서 맵을 가운데에 두려면 지리 좌표(x, y) 또는 투영 좌표(x, y, WKID)를 사용하여 center를 설정합니다. 구분 기호로 쉼표 또는 세미콜론을 사용합니다. 숫자의 소수점으로 콜론을 사용하는 경우에는 세미콜론을 사용합니다.

비고:

levelcenter 매개변수는 함께 사용해야 합니다. level 매개변수는 단독으로 사용될 경우 무시됩니다.

Map Viewer의 지리 좌표 예시:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?center=20,45&level=4

Map Viewer Classic의 지리 좌표 예시:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?center=20,45&level=4

Map Viewer의 투영 좌표 예시:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?center=500000,5500000,102100&level=4

범위 정의

extent을(를) 사용하여 맵 범위를 정의합니다. extent 매개변수는 지리 좌표(GCS)로 MinX,MinY,MaxX,MaxY 또는 투영 좌표(PCS)로 MinX,MinY,MaxX,MaxY,WKID를 허용합니다. 구분 기호로 쉼표 또는 세미콜론을 사용합니다. 숫자의 소수점으로 콜론을 사용하는 경우에는 세미콜론을 사용합니다.

Map Viewer의 지리 좌표 예시:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?extent=-117.20,34.055,-117.19,34.06

Map Viewer의 투영 좌표 예시:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?extent=-13079253.954115,3959110.38566837,-12918205.318785,4086639.70193162,102113

Map Viewer Classic의 투영 좌표 예시:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?extent=-13079253.954115,3959110.38566837,-12918205.318785,4086639.70193162,102113

레이어 가시성 설정

맵에서 연 레이어에 대한 하위 레이어의 가시성을 설정하려면 layers=show:를 사용합니다.

이 예시에서 Map Viewer Classic에 필지 레이어의 하위 레이어 1 및 2는 표시되지만 다른 하위 레이어는 표시되지 않습니다.

https://myportal.domain.com/arcgis/home/webmap/viewer.html?url=https://otherportal.domain.com:7443/arcgis/rest/services/BloomfieldHillsMichigan/Parcels/MapServer?layers=show:1,2

맵을 열 위치 또는 피처 찾기

맵을 열고 바로 위치 또는 피처를 찾으려면 find를 사용합니다. 가장 일치하는 항목으로 맵이 자동으로 확대되고 설명선 표시가 맵에 추가됩니다. find 매개변수에는 한 줄 주소, 부분 주소(예시: 도시 또는 국가만), 장소 이름, 위도-경도 좌표를 사용할 수 있습니다.

다음 예시에서는 Map Viewer에서 한 줄 주소를 사용합니다.

https://myportal.domain.com/arcgis/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://myportal.domain.com/arcgis/home/webmap/viewer.html?marker=-79.234826;38.147884;;Race start and finish;;Grindstone 100 Ultra Marathon&level=7

고려 사항

맵에 포인트를 추가할 때는 다음 사항에 유의하세요.

  • 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의 향후 릴리즈에서 제공됩니다.

Map Viewer Classic세부정보 창을 숨기려면 mapOnly=true를 사용합니다.

이 예시에서 ID가 b487d81007294fb5a0be9e10a411f2d0인 저장된 웹 맵은 Map Viewer Classic에서 열리지만 세부정보 창은 숨겨집니다.

https://myportal.domain.com/arcgis/home/webmap/viewer.html?webmap=b487d81007294fb5a0be9e10a411f2d0&mapOnly=true