Использование 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, необходимо заменить HTTP на HTTPS в URL-адресе и сделать все ресурсы достыпными только по HTTPS.

Компоновка

Следующие параметры дают возможность управления внешним видом и восприятием карты:

  • theme – задает цветовую тему боковой панели и кнопок. Допустимые параметры – это light или dark.
  • legend – при выборе true, на боковой панели отображается легенда со слоями карты.
  • details – при выборе true, на боковой панели отображается текст описания карты.
  • active_panel – задает активную закладку на боковой панели после загрузки карты. Допустимые параметры – это legend или details. Параметр legend или details должен быть задан как true, если он используется как значение параметра active_panel.
  • show_panel – при выборе true, после загрузки карты отображается боковая панель. По умолчанию – false.
  • popup_sidepanel – при выборе true, информация из всплывающих окон отображается на информационной закладке боковой панели, а не на карте.
  • zoom_position – задает положение кнопок управления масштабированием. Допустимые опции - это top-left (по умолчанию), bottom-left, top-right или bottom-right. Если параметр home задан как true, кнопка возврата на главную страницу также перемещается, в соответствии со значением параметра zoom_position.
  • logoimage – URL-адрес изображения, использующегося в компоновке карты как активный эскиз. Щелчок по эскизу приводит к перенаправлению по URL-адресу, заданному параметром logolink.
  • logolink – URL-адрес внешнего сайта или веб-ресурса. Щелчок по изображению эскиза, заданному параметром logoimage, приводит к перенаправлению по URL-адресу, заданному в logolink.

Пример встроенной карты с темной темой, легендой, отображением панели после загрузки, кнопками масштабирования вверху справа и изображением логотипа, связанного с веб-страницей

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 – ID уровня масштаба кэша, указанный в конечной точке REST-сервиса базовой карты. Это определяет уровень масштабирования по умолчанию, использующийся при загрузке карты, например, 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 – отображается кнопка переключения базовых карт. Требуется указать значение true, чтобы использовать alt_basemap.
  • alt_basemap – позволяет выбрать альтернативную базовую карту при их переключении. Параметр basemap_toggle должен быть задан как true, чтобы использовать alt_basemap. Если альтернативная базовая карта не задана, используется спутниковая базовая карта. Допустимые значения - 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, отображается виджет поиска. Этот виджет поддерживает поиск через геокодирование и слои, доступные для поиска. Параметр search должен быть задан как true, чтобы использовать find в слоях, где доступен поиск, на карте.
  • searchextent – когда задано true, поиск по геокодированию через виджет поиска возвращает результаты, находящиеся в пределах экстента карты по умолчанию.
  • find – открывает карту в указанном местоположении. Параметр find может использоваться для поиска по адресам или местам (геокодирование) или для поиска значений атрибутивных полей из слоев, доступных для поиска. Этот параметр возвращает результаты из всех поисковых ресурсов, к которым карта имеет доступ. Если значения со слоев похожи на значения геокодирования, это может привести к ошибочным результатам. Например, при поиске пятизначного кода FIPS в поле слоя, доступного для поиска, его можно спутать с почтовыми кодами (ZIP) США и получить множество нежелательных результатов. Постарайтесь использовать feature для поиска объектов, вместо find в подобных сценариях или когда требуется получить более точные результаты.
  • feature – разрешает поиск определенного объекта в объекты слое, доступном для поиска. Необходимо настроить на карте Поиск местоположений по слоям, чтобы получить поля, доступные для поиска. Используется синтаксис feature=layerID;searchfield;searchvalue, например, feature=CentralIndianaCities_634;PLACEFIPS;05860.

    Следующий URL ссылается на вышеуказанный пример с городами центральной Индианы, и может быть использован для определения ID соответствующего слоя карты. Обратите внимание на id:CentralIndianaCities_634 в operationalLayers. Замените ID webmap на 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