URL 매개변수를 사용하여 임베드된 맵 수정

비고:

현재 이 기능은 Map Viewer Classic에서만 지원됩니다. Map Viewer 후속 릴리즈에서 제공됩니다.

Map Viewer Classic 에서 제공하는 즉시 사용 가능한 HTML 코드를 사용하여 맵을 웹 사이트에 임베드할 수 있습니다. 맵에 포함할 홈 버튼, 확대/축소 컨트롤 및 범례 등의 옵션을 선택할 수 있습니다. 이러한 옵션은 코드에 추가되며 이 코드를 복사하여 웹 사이트에 붙여넣을 수 있습니다. 이러한 옵션을 추가하는 또 다른 방법은 URL 매개변수를 사용하는 것입니다.

임베드되는 맵의 URL은 항상 기관의 URL 또는 공개 사이트(https://www.arcgis.com) 및 /apps/Embed/index.html?webmap=<your web map ID>로 시작합니다. 예를 들면 다음과 같습니다.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118

또한 URL에는 아래에 나열된 매개변수가 하나 이상 포함될 수 있습니다. URL 매개변수 중 일부는 임베드되는 맵의 동작을 수정하며 다른 매개변수는 임베드되는 맵에서 사용 가능한 기능을 수정합니다. 매개변수를 둘 이상 포함하려면 앰퍼샌드(&)를 사용하여 매개변수를 구분합니다. 예를 들면 다음과 같습니다.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118&legend=true&details=true

비고:

URL 매개변수의 리소스가 HTTP로 제공된 경우 URL에서 HTTP를 HTTPS로 바꾸고 모든 리소스를 HTTPS로만 접근 가능하도록 설정해야 합니다.

레이아웃

다음의 매개변수는 맵의 모양과 느낌에 대한 컨트롤을 제공합니다.

• theme - 측면 패널과 버튼에 적용되는 색상 테마를 결정합니다. 유효한 옵션은 light 또는 dark입니다.
• legend - true로 설정되면 측면 패널에 맵의 레이어가 표시되는 범례가 나타납니다.
• details - true로 설정되면 맵의 설명 텍스트가 측면 패널에 나타납니다.
• active_panel - 맵이 로드될 때 사이드 패널에서 활성화될 탭을 설정합니다. 유효한 옵션은 legend 또는 details입니다. legend 또는 details 매개변수는 active_panel 매개변수의 값으로 사용될 경우 true로 설정되어야 합니다.
• show_panel - true로 설정되면 맵이 로드될 때 측면 패널이 나타납니다. 기본값은 false입니다.
• popup_sidepanel - true로 설정되면 팝업 정보가 맵에 나타나지 않고 측면 패널의 정보 탭에 나타납니다.
• zoom_position - 확대/축소 컨트롤 버튼의 위치를 결정합니다. 유효한 옵션은 top-left(기본값), bottom-left, top-right, bottom-right입니다. home 매개변수가 true로 설정되면 zoom_position 매개변수의 값에 따라 홈 버튼도 이동됩니다.
• logoimage - 맵 레이아웃 내의 클릭 가능한 썸네일로 사용되는 이미지의 URL입니다. 썸네일을 클릭하면 logolink 매개변수로 설정된 URL로 이동합니다.
• logolink - 외부 웹사이트 또는 웹 리소스의 URL입니다. logoimage 매개변수로 설정된 썸네일 이미지를 클릭하면 logolink에서 설정된 URL로 이동합니다.

어두운 테마, 범례, 불러오기 시 패널 보기, 오른쪽 상단의 확대/축소 버튼, 웹 페이지로 연결되는 로고 이미지가 포함되어 있는 임베드되는 맵의 예입니다.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&theme=dark&legend=true&show_panel=true&zoom_position=top-right
&logoimage=https://cdn-png.si.com/sites/default/files/teams/basketball/cbk/logos/ind_200.png
&logolink= https://en.wikipedia.org/wiki/Indiana_University

범례, 세부정보, 사이드 패널의 활성 탭, 사이드 패널의 정보 탭에 표시된 팝업이 포함되어 있는 임베드되는 맵의 예입니다.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&legend=true&details=true&active_panel=details&popup_sidepanel=true

매핑

다음 매개변수는 맵 탐색 및 매핑 요소의 가시성을 제어합니다.

• webmap - 임베드된 맵 뷰어 내부에 나타날 웹맵의 ID입니다(예시: webmap=432a8d7ca22d4b5b859e0bdaa30ae118). webmap 매개 변수는 필수입니다.
• extent - 맵이 로드될 때 사용되는 범위를 지정합니다. 이 값은 맵의 기본 범위를 오버라이드합니다. 지리 좌표체계 값만 유효합니다.
• center - 지리 좌표(x,y)를 사용하여 맵의 중심점을 설정합니다.
• level - 베이스맵의 REST 엔드포인트에 나열된 것과 같은 캐시 축척의 레벨 ID입니다. 이 값은 맵이 로드될 때의 기본 확대/축소 레벨을 결정합니다(예시: level=9).
• zoom - true로 설정되면 확대 및 축소 버튼이 나타납니다. 이러한 버튼의 맵 내 위치는 zoom_position 매개변수로 제어할 수 있습니다.
• home - true로 설정되면 홈 버튼이 나타납니다. 홈 버튼은 맵의 기본 범위로 돌아가는 데 사용됩니다. extent 매개변수가 설정된 경우 홈 버튼에는 맵의 기본 범위 대신 이 매개변수의 범위가 사용됩니다. home 매개변수는 zoom 매개변수도 true로 설정된 경우에만 유효합니다.
• scale - true로 설정되면 스케일바가 나타납니다. 스케일바는 맵의 왼쪽 하단에 나타납니다.
• disable_scroll - true로 설정되면 확대/축소를 위한 마우스 스크롤링이 비활성화됩니다. 기본값은 true입니다.
• marker - 원하는 이미지를 팝업 기능이 있는 표식 심볼로 사용하여 맵 내의 선택 위치에 배치합니다. 구문은 marker=longitude;latitude;wkid;description;URL;title입니다. 위도와 경도는 필수적이며 다른 값은 선택적입니다. 설명 및 제목 값은 URL에 인코딩 되어야 합니다. 이 값을 포함하지 않으려면 비워둡니다. 예를 들면 다음과 같습니다.

  marker=-86.52;39.18;;Assembly%20Hall;https://cdn-png.si.com/sites/default/files/teams/basketball/cbk/logos/ind_200.png

• basemap_toggle - 베이스맵 전환 버튼이 나타납니다. alt_basemap을 사용하려면 true로 설정해야 합니다.
• alt_basemap - 베이스맵 전환 시 사용될 다른 베이스맵을 제어합니다. alt_basemap을 사용하려면 basemap_toggle 매개변수를 true로 설정해야 합니다. 대체 베이스맵이 지정되지 않으면 위성 베이스맵이 사용됩니다. 유효한 값은 streets, satellite, hybrid, topo, gray, oceans, national-geographic, osm, terrain, dark-gray입니다.

사용자 정의 범위가 있고, 확대/축소 버튼이 비활성화되고, 스케일바가 있고, 마우스 확대/축소 스크롤링이 활성화되고, 베이스맵 갤러리가 있는 임베드되는 맵의 예입니다.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&extent=-86.179,39.923,-85.932,40.075
&zoom=false&scale=true&disable_scroll=false&basemap_gallery=true

중심에 배치되고, 확대/축소 축척 레벨과 홈 버튼이 있으며, 베이스맵이 대체 베이스맵으로 전환되는 임베드되는 맵의 예입니다.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&center=-86.39,39.84&level=16&home=true&basemap_toggle=true&alt_basemap=hybrid

피처 및 위치 검색(지오서치)

다음 매개변수는 맵에서 데이터를 검색하고 찾습니다.

• search - true로 설정되면 검색 위젯이 나타납니다. 이 검색 위젯은 지오코딩을 통한 검색 및 검색 가능한 레이어를 지원합니다. 맵의 검색 가능한 레이어에 대해 find을(를) 사용하려면 search 매개변수를 true로 설정해야 합니다.
• searchextent - true로 설정되면 검색 위젯을 통한 지오서치에서 맵 기본 범위 내의 결과가 반환됩니다.
• find - 특정 위치에서 맵을 엽니다. find 매개변수를 사용하면 주소나 장소(지오코딩)로 검색하거나 검색 가능한 레이어의 속성 필드 값을 검색할 수 있습니다. 이 매개변수는 맵에서 접근할 수 있는 모든 검색 리소스의 결과를 반환합니다. 검색 가능한 레이어 값이 지오코딩 값과 유사한 경우 잘못된 결과가 생성될 수 있습니다. 예를 들어 검색 가능한 레이어 필드의 다섯 자리 FIPS 코드를 검색하면 미국 우편 번호와 혼동하여 원치 않는 여러 결과가 반환될 수 있습니다. 따라서 이러한 시나리오에서, 또는 결과에 대한 세밀한 제어가 필요한 경우에는 find 대신에 피처 검색을 위한 feature를 사용하는 것이 좋습니다.
• feature - 검색 가능한 피처 레이어에서 특정 피처를 검색할 수 있습니다. 검색 가능한 필드에 대해 레이어로 위치 찾기가 맵에 설정되어 있어야 합니다. 구문은 feature=layerID;searchfield;searchvalue입니다(예시: feature=CentralIndianaCities_634;PLACEFIPS;05860).

  다음 URL은 위 예의 중부 인디애나 도시를 참조하며 맵 내 원하는 레이어의 레이어 ID를 검색하는 데 사용할 수 있습니다. operationalLayers의 id:CentralIndianaCities_634를 확인하세요. webmap ID를 본인의 웹 맵의 ID로 바꿔 레이어 ID를 찾습니다.

  https://www.arcgis.com/sharing/rest/content/items/432a8d7ca22d4b5b859e0bdaa30ae118/data?f=json

검색, 검색 범위를 포함하며 특정 위치에서 열리는 임베드되는 맵의 예입니다.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&search=true&searchextent=true
&find=500%20S%20Capitol%20Ave,%20Indianapolis,%20IN%2046225

특정 피처에서 열리는 임베드되는 맵의 예입니다.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&feature=CentralIndianaCities_634;PLACEFIPS;05860