返回顶部

可使用 URL 参数修改嵌入地图

在本主题中

  1. 布局
  2. 制图
  3. 要素和位置搜索（地理搜索）

注：

目前，此功能仅在 Map Viewer 经典版 中受支持。 该功能将在 Map Viewer 的未来版本中提供。

Map Viewer 经典版 提供即用型 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 修改嵌入地图的行为，而其他 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。 如果用作 active_panel 参数的值，legend 或 details 参数必须被设置为 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 - 外部网站或 web 资源 URL 单击用 logoimage 参数设置的缩略图图像会重定向到在 logolink 中设置的 URL。

嵌入地图示例：深色主题、图例、显示面板加载、右上的缩放按钮以及链接到 web 页面的徽标图片

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 - 在嵌入地图查看器内部显示的 web 地图的 ID，例如 webmap=432a8d7ca22d4b5b859e0bdaa30ae118。 webmap 参数为必选项。
  • extent - 指定地图加载时的使用范围。 这会覆盖地图的默认范围。 只有地理坐标系的值有效。
  • center - 使用地理坐标系 (x,y) 居中地图。
  • level - 在底图的 REST 端点中列出的缓存比例的级别 ID。 这确定了地图加载时的默认缩放级别，例如 level=9。
  • zoom - 设置为 true 时，显示放大和缩小按钮。 它们在地图中的位置可由 zoom_position 参数控制。
  • home - 设置为 true 时，显示主页按钮。 主页按钮用于导航回地图的默认范围。 如果设置了 extent，则主页按钮会使用该范围，而不使用地图的默认范围。 仅当 zoom 也设置为 true 时，home 参数才有效。
  • 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 编码会与美国邮政编码混淆，以至于返回多个不需要的结果。 考虑使用 feature 进行要素搜索，而不在如以上示例的情况下或者结果需要更多精细控制的情况下使用 find。
  • feature - 允许在可搜索要素图层搜索特定的要素。 需要对可搜索字段在地图上设置按图层查找位置。 语法为 feature=layerID;searchfield;searchvalue，例如：feature=CentralIndianaCities_634;PLACEFIPS;05860。

    下列 URL 引用上述的印第安纳州中部城市示例并且可用于在您的地图中找出所需图层的图层 ID。 请注意 operationalLayers 下方的 id:CentralIndianaCities_634。 用您的 web 地图的 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

有关此主题的反馈?

在本主题中
  1. 布局
  2. 制图
  3. 要素和位置搜索（地理搜索）