Map Viewer 模板用于创建允许用户搜索以及查看单个地图或地图库的应用程序。 要了解详细信息并查看 Map Viewer 应用程序示例，请参阅此故事。
通过此模板创建应用程序时，必须提供标题以创建应用程序。使用设置工具可自定义 Map Viewer 应用程序。
要求
以下是适用于 Map Viewer 模板的要求：
- Web 地图可以为公共地图或安全地图。 要通过 OAuth2 访问组织中或 ArcGIS Enterprise 门户中的安全 Web 地图，请注册应用程序并提供一个客户端 ID。 有关详细信息，请参阅注册应用程序。默认情况下，只有公共 Web 地图将出现在 Map Viewer 库中；要访问安全地图，请在应用程序设置中启用支持安全地图属性。
- 除 Web 地图外，Map Viewer 查询字符串还支持移动地图包 (MMPK)。 由于默认模板中的许可限制，除非 MMPK 是使用 ArcGIS Pro Publisher 扩展模块在启用匿名使用的情况下创建的，否则您必须登录到门户或组织帐户才能访问和查看这些 MMPK。 有关创建 MMPK 的详细信息，请参阅关于移动地图包的 ArcGIS Pro 文档，或使用 ArcGIS Pro 制作离线地图 - Part 1 博客文章。
- Web 地图版本必须为 2.0 或更高版本；否则地图将无法加载。
- 可选 - 要使用应用程序中的要素搜索，必须至少有一个 web 地图图层在其 web 地图中配置了搜索功能。
- 可选 - 在 web 地图的图层中启用弹出窗口以使用 web 地图标识要素。
- 可选 - 在 Web 地图中配置书签以使用书签要素。
- 可选 - 要显示图例，必须至少有一个 web 地图图层在地图服务中定义了图例。
显示地图服务时，Map Viewer 模板性能最佳。 可以显示要素服务，但通常绘制速度缓慢。
自定义应用程序
创建应用程序后，可以通过更改应用程序设置对其进行自定义。
启动 AppStudio，然后在侧面板中，单击设置 > 属性。 下表列出了 Map Viewer 属性选项卡中各个选项卡的内容，并按照它们在选项卡中的显示位置及其用途进行排序。 还可以在应用程序的 appinfo.json 文件中直接修改这些选项卡的内容。 如果对上述属性做出了任何更改，再次启动应用程序之前请单击应用对其进行保存。
“启动画面”选项卡内容
| 属性 | JSON 名称 | 类型 | 描述 |
|---|---|---|---|
背景图像 | startBackground | 字符串（图像 URL） | 用于“启动”页面背景的图像。 |
标识颜色 | startForegroundColor | 字符串（颜色值） | 用作原色的颜色。 |
基本字号 | baseFontSize | 数值 | 设置应用程序中使用的基本字号。 |
标题字体文件 | regularFontTTF | 字符串（字体文件 URL） | 设置在整个应用程序中使用的自定义标题字体。该字体将用于标题、页面标题等。 |
文本字体文件 | mediumFontTTF | 字符串（字体文件 URL） | 设置在整个应用程序中使用的自定义标题字体。该字体将用于照片、文本等的描述。 |
反馈电子邮件 | feedbackEmail | 字符串（电子邮件 ID） | 发送用户反馈的电子邮件地址。 |
显示免责声明 | showDisclaimer | 布尔值 (true|false) | 将免责声明文本显示为应用程序中的弹出窗口。此文本内容节选自详细信息选项卡的访问和使用约束部分。 |
“库”选项卡内容
| 属性 | JSON 名称 | 类型 | 描述 |
|---|---|---|---|
地图查询 | galleryMapsQuery | 字符串 | 输入 ArcGIS 查询，从门户中选择要显示在库中的 Web 地图或 MMPK。 输入值可以为任何有效的字符串（例如 USA），或有效的项目 ID（例如 id:d5e02a0c1f2b4ec399823fdd3c2fdebd）。 |
将显示在库中的结果总数 | maxNumberOfQueryResults | 数值 | 输入应从查询门户返回的 web 地图的最大数目。 |
门户 url | portalUrl | 字符串 | 用于查询 web 地图的 ArcGIS 门户的 URL。 |
底图组 ID | baseMapsGroupId | 字符串 | 列出提供的组中的底图。 |
支持安全地图 | supportSecuredMaps | 布尔值 (true|false) | 提供根据查询参数登录组织以访问安全 Web 地图和 MMPK 的功能。 |
跳过登录 | enableAnonymousAccess | 布尔值 (true|false) | 提供绕过登录并且只显示公开 Web 地图和 MMPK（该 MMPK 是使用 ArcGIS Pro Publisher 扩展模块在启用匿名使用的情况下创建的）的功能。 默认值为 true。 |
支持编辑 | supportEditAttributes | 布尔值 (true|false) | 如果要素图层可编辑且用户有权编辑要素，则可通过将此选项设置为 true 来编辑要素属性和附件。 |
要在库中显示的地图 | mapTypes | 选项（组合框） | 指定 Map Viewer 库中显示的地图类型。 可能有以下三种值：showWebMapsOnly 将仅显示在线 web 地图，showOfflineMapsOnly 将仅显示移动地图包，而 showBoth 将显示 web 地图和 MMPK。 |
门户排序字段 | portalSortField | 字符串 | 指定用于对库中显示的 Web 地图进行排序的字段的名称。 可能的值包括：title、created、type、owner、modified、avgRating、numRatings、numComments 和 numViews。 默认值已修改。 |
门户排序顺序 | portalSortOrder (asc|desc) | 字符串 | 指定库中显示的 web 地图是按升序还是降序排列，具体取决于指定的 portalSortField。 默认值为“desc”。 |