URL 参数
可以向 ArcGIS StoryMaps 项目的 URL 添加参数，以修改其行为或激活特定功能。 必须按照以下约定将这些参数添加至 ArcGIS StoryMaps URL：
[baseURL] + ? + [parameter1] + & + [parameter2] + & + [parameter3] + ...
基础 URL
基础 URL 是 ArcGIS StoryMaps 用来访问资源和功能的服务器端点。 支持参数的三个基础 URL 如下所示。
| 操作 | 基础 URL |
|---|---|
| 创建新项目 | https://storymaps.arcgis.com/[item-type]/new |
| 编辑项目（构建器） | https://storymaps.arcgis.com/[item-type]/[item-ID]/edit |
| 查看项目（查看器） | https://storymaps.arcgis.com/[item-type]/[item-ID] |
注:
[item-type]可以是stories、briefings、frames、collections、templates或themes。[item-ID]是类型为StoryMap或StoryMap theme的 ArcGIS 项目的 ID。目前没有办法查看主题。
重要信息：
在 ArcGIS Enterprise 中，将 storymaps.arcgis.com 替换为 [your-portal-domain]/[web-adaptor-name]。 例如，https://www.myorg.gov/my-portal/[item-type]/new。
显示参数
显示参数与查看器的基础 URL 一起使用：
https://storymaps.arcgis.com/[item-type]
| 参数 | 行为 | 值 | 故事 | 简报 | 框 | 集合 |
|---|---|---|---|---|---|---|
play |
激活自动播放 | true （默认） false |
✅ | ✅ | ✅ | |
speed |
控制自动播放速度（需要 play=true） |
slow medium （默认） fast |
✅ | ✅ | ✅ | |
header |
查看项目时显示/隐藏页眉 | true （默认） false |
✅ | ✅ | ✅ | |
cover |
展示/隐藏封面 | true （默认） false |
✅ | ✅ | ✅ | ✅ |
navigation |
显示/隐藏导航控件 | true （默认） false |
✅ | |||
item |
按数字位置显示集合项目 | 1、2、3... |
✅ |
注:
如果未指定参数值，将使用默认值。 例如，
play与play=true相同。header和coverURL 参数会覆盖当前配置的项目行为。 例如，如果故事中已激活隐藏封面，cover=true可用于显示封面。 有关详细信息，请参阅配置故事设置。当故事嵌入在
<iframe>中时，将隐藏页眉，但header参数可用于强制显示该页眉。 嵌入简报或集合的页眉默认不会隐藏，因为它包含导航元素。 有关详细信息，请参阅标准嵌入。隐藏简报的页眉会导致其导航工具栏不可用。 读者仍可使用键盘或幻灯片远程附件进行导航。 无法隐藏集合的页眉。
创建项目参数
这些参数与基础 URL 一起用于创建新 ArcGIS StoryMaps 项目：
https://storymaps.arcgis.com/[item-type]/new
| 参数 | 行为 | 值 | 故事 | 简报 | 框 | 集合 |
|---|---|---|---|---|---|---|
theme |
创建新 ArcGIS StoryMaps 项目，并应用主题 | [theme-item-ID] |
✅ | ✅ | ✅ | |
webmap |
创建新 ArcGIS StoryMaps 项目，并将 Web 地图添加为第一个块 | [webmap-item-ID] |
✅ | ✅ | ||
webscene |
创建新 ArcGIS StoryMaps 项目，并将 Web 场景添加为第一个块 | [webscene-item-ID] |
✅ | ✅ | ||
template |
基于模板创建新 ArcGIS StoryMaps 项目 | [template-item-ID] |
✅ |
其他参数
这些参数适用于所有项目类型。
| 参数 | 行为 | 值 |
|---|---|---|
urlKey |
引导用户访问特定组织的登录页面 - 例如，如果组织使用企业登录。 | 您的 ArcGIS 组织简称，即组织 URL 的第一部分。 请参阅以下示例。 |
提示：
有关使用 urlKey 参数的详细信息，请参阅通过特定组织链接共享故事地图。
示例
以下示例结合了基础 URL 和参数，展示了如何为几个典型用例构建有效 URL。
| 操作 | URL |
|---|---|
为简报启用慢速自动播放，ID 为 abcdef123456 |
.../briefings/abcdef123456?play&speed=slow |
| 隐藏简报页眉 | .../briefings/[item-ID]?header=false |
| 隐藏故事的页眉和封面 | .../stories/[item-ID]?header=false&cover=false |
| 隐藏页眉，但显示故事封面 | .../stories/[item-ID]?header=false&cover=true |
| 显示集合中的第五个项目 | .../collections/[item-ID]?item=5 |
创建新故事并将 ID 为 abcdef123456 的 Web 地图添加为第一个块 |
.../stories/new?webmap=[abcdef123456] |
引导读者登录 https://myorg.maps.arcgis.com |
.../briefings/[item-ID]?urlKey=myorg |