Skip To Content

맵 수정을 위한 URL 매개변수

맵 뷰어를 사용하여 작성된 맵에는 베이스맵, 데이터 레이어, 범위, 범례 및 내비게이션 도구(예: 확대, 이동, 장소 찾기, 책갈피)가 포함되어 있습니다. 또한 많은 맵에 이미지와 도로처럼 맵 간에 전환할 수 있는 베이스맵 갤러리와 같은 대화형 요소를 비롯하여 측정 도구, 특정 피처에 대한 속성을 표시하는 팝업, 시간별 데이터를 재생하는 버튼 등이 포함되어 있습니다.

맵 뷰어를 사용하여 맵을 생성하는 방법 외에 URL 매개변수를 사용하여 맵을 직접 생성하거나 수정할 수 있습니다.

예를 들어 다음은 URL 매개변수를 사용하여 영국의 해풍 풍력발전단지를 보여 주는 맵을 작성하는 방법입니다.

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

URL에 포함할 사항

URL은 항상 Portal for ArcGIS 홈페이지로 시작하고 /webmap/viewer.html? 및 아래에 나열된 쿼리 매개변수를 하나 이상 포함합니다. 매개변수를 둘 이상 포함하려면 앰퍼샌드(&)를 사용하여 매개변수를 구분합니다.

예:

https://myportal.domain.com/arcgis/home/webmap/viewer.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=http%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%2Chttp%3A%2F%2Fmaps.ngdc.noaa.gov%2Frest%2Fservices%2Fweb_mercator%2Fhazards%2FMapServer%3Flayers%3Dshow%3A5%2C6

웹에는 인코딩된 URL을 생성할 수 있는 무료 사이트 및 도구가 많이 있습니다. 이 항목의 나머지 예제는 인코딩되지 않았습니다.

저장된 맵 열기

맵 뷰어로 생성해 저장한 맵을 열려면 webmap= 및 맵의 Unique ID를 사용합니다.

예:

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

베이스맵 정의

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

예:

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

참조 레이어 포함

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

예:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?
basemapUrl=https://services.myportal.domain.com:7443/arcgis/rest/services/World_Imagery/MapServer
&basemapReferenceUrl=http://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>)을 사용합니다.

예:

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= 매개변수를 포함합니다.

예:

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 작업을 수행할 수 있습니다.

예를 들면 다음과 같습니다.

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

맵 가운데 정렬

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

지리 좌표의 예

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

투영된 좌표의 예

https://myportal.domain.com/arcgis/home/webmap/viewer.html?center=500000,5500000,102100

축척 레벨 정의

맵 뷰어의 축척 레벨을 정의하려면 centerlevel= 매개변수를 사용합니다. level 매개변수는 REST 서비스 엔드포인트에 나열된 것과 같이 캐시 축척의 레벨 ID를 허용합니다. 맵 서비스의 REST 엔드포인트에 있는 정보를 사용하여 캐시 축척 레벨을 결정할 수 있습니다. 해상도는 축척과 반비례합니다.

축척은 webmap 또는 find 매개변수를 사용할 때 자동으로 설정되며, level은(는) 무시됩니다. webmap 매개변수를 사용할 경우 맵은 해당 맵의 전체 범위로 자동으로 확대됩니다. find 매개변수를 사용할 경우 맵은 찾은 위치의 최적 범위로 자동으로 확대됩니다.

지리 좌표의 예

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

투영된 좌표의 예

https://myportal.domain.com/arcgis/home/webmap/viewer.html?center=500000,5500000,102100&level=4

범위 정의

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

지리 좌표의 예

https://myportal.domain.com/arcgis/home/webmap/viewer.html?extent=-117.20,34.055,-117.19,34.06

투영된 좌표의 예

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

레이어 가시성 설정

맵에 있는 레이어의 가시성을 설정하려면 layers=show:을(를) 사용합니다.

예:

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 매개변수에는 한 줄 주소, 부분 주소(예: 도시 또는 국가만), 장소 이름 및 위도-경도 좌표를 사용할 수 있습니다.

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

https://myportal.domain.com/arcgis/home/webmap/viewer.html?find=380 new york st,redlands,ca

포인트 추가

맵에 포인트를 추가하려면 marker=<x>,<y>을(를) 사용합니다. 지정된 x, y 위치에서 새 맵 노트 레이어에 포인트가 추가됩니다. 또한 다음과 같은 등록정보(옵션)를 포함할 수 있습니다.

  • <wkid> - 맵에 추가되는 x, y 좌표의 공간 참조입니다. WKID를 포함하지 않으면 GCS 좌표가 사용됩니다.
  • <encoded title> - 포인트 팝업의 제목입니다. 제목을 포함하지 않으면 팝업이 빈 상태가 됩니다.
  • <encoded icon URL> - 포인트에 대한 심볼입니다. 심볼을 포함하지 않으면 파란색 표시 심볼이 사용됩니다.
  • <encoded label> - 포인트 심볼 옆에 있는 레이블입니다.

고려 사항

  • <x>,<y>이(가) 필요합니다.
  • title, icon, label 매개변수를 인코딩해야 합니다.
  • 이 순서에 따라 등록정보를 추가해야 합니다.marker=<x>,<y>,<wkid>,<encoded title>,<encoded icon URL>,<encoded label>
  • 구분 기호로 쉼표 또는 세미콜론을 사용합니다. 숫자의 소수점으로 콜론을 사용하는 경우에는 세미콜론을 사용합니다.
  • 빈 값을 사용합니다. 공백은 사용하면 안 됩니다. 예를 들어 레이블을 지정하려고 할 때 다른 등록정보(옵션)가 없으면 다른 항목(x;y;;;;label)에 대해 빈 값을 사용한 여섯 번째 매개변수로 레이블을 추가합니다.
  • 특정 포인트를 가운데에 두고 맵을 확대하려면 level= 매개변수를 포함합니다.
  • 맵 또는 항목으로 맵 노트 레이어를 편집하고 저장할 수 있습니다.
  • 기관 계정은 포인트를 길찾기 표시분석 수행에 사용할 수 있습니다.

다음 예에서는 세미콜론 구분 기호를 사용합니다.

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

세부정보 창 숨기기

맵 뷰어의 세부정보 창을 숨기려면 mapOnly=true을(를) 사용합니다.

예:

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