导出 Web 地图 (服务器)

摘要

可根据 Web 应用程序的状态(例如,包含的服务、图层可见性设置和客户端图形)返回指定感兴趣区域的可打印页面布局或基本地图。

使用情况

  • 此工具的输入是 JSON 格式的文本,用于描述 web 地图中的图层、图形和其他设置。 此 JSON 表示必须根据 ExportWebMap 规范构建。

  • ArcGIS Server 中随附此工具,以支持用于打印的 web 服务,其中包括 PrintingTools 预配置服务。 ArcGIS API for JavaScript 使用 PrintingTools 服务生成用于地图打印的图像。

  • 对于高级打印场景(例如以本地矢量数据替换服务图层、创建地图册等),会使用 Python arcpy.mp 模块中的 ConvertWebMapToArcGISProject 函数,而不会用到此工具。 要使 Python 脚本对 web 应用程序可用,可以通过 ArcGIS Server 地理处理服务显示脚本。 有关更多信息,请参阅 ArcGIS Server 帮助中的在 Web 应用程序中打印

  • 导出格式类型 TIFF 生成具有 alpha 通道的启用了地理位置的 32 位 .tiff 文件。

  • 模板文件夹参数中指定的文件夹不能包含两个或多个具有相同名称的文件(.rptt.rptx)。 这是为了避免打印作业期间出现不需要的输出。 布局和报表模板可以共享相同的名称。

  • 如果使用或指定报表模板,则输出必须为 PDF 格式。

参数

标注说明数据类型
作为 JSON 的 Web 地图

要按照 Web 应用程序中显示的情况导出地图状态的 JSON 制图表达。请参阅 ExportWebMap 规范以了解如何设置此文本格式。 通过 ArcGIS API for JavaScript,您可以从地图中获取此 JSON 字符串。

String
输出文件

输出文件名。 文件扩展名取决于格式参数值。

File
格式
(可选)

指定传送打印用地图影像时所使用的格式。

  • 8 位可移植网络图形 (PNG8)。将使用 8 位可移植网络图形 (PNG8)。 这是默认设置。
  • 便携文档格式(PDF)将使用可移植文档格式 (PDF)。
  • 32 位可移植网络图形 (PNG32)将使用 32 位可移植网络图形 (PNG32)。
  • 联合图像专家组 (JPG)将使用联合图像专家组 (JPG)。
  • 图形交换格式 (GIF)将使用图形交换格式 (GIF)。
  • Encapsulated PostScript (EPS)将使用 Encapsulated PostScript (EPS)。
  • 可伸缩矢量图形 (SVG)将使用可伸缩矢量图形 (SVG)。
  • 压缩的可伸缩矢量图形 (SVGZ)将使用压缩的可伸缩矢量图形 (SVGZ)。
  • Adobe Illustrator Exchange (AIX)将使用 Adobe Illustrator Exchange (AIX)。
  • 标记图像文件格式 (TIFF)将使用标记图像文件格式 (TIFF)。
注:

输出文件的背景始终是不透明的。

String
模板文件夹
(可选)

包含要用作模板的布局或报表页面(.pagx.rptx.rptt 文件)的文件夹的完整路径。 默认位置为 <install_directory>\Resources\ArcToolBox\Templates\ExportWebMapTemplates

Folder
布局模板
(可选)

可以是列表中某个模板的名称,也可以是关键字 MAP_ONLY。 使用 MAP_ONLY 或传递空字符串时,输出地图将不包含任何页面布局元素,例如标题、图例和比例尺。

String
布局项目 ID
(可选)

将用于模板的布局项的门户 ID(JSON 格式)。 使用格式 {"id": "<portal-id>"}。 如果提供了值,则此参数的优先级将高于布局模板参数。

String
报表模板
(可选)

报表模板的名称。

如果提供此参数值,则格式参数必须设置为可移植文档格式 (PDF)。 如果未指定此参数,则输出文件将不包含任何报表。

String
报表项目 ID
(可选)

将用于模板的布局项目的门户 ID(JSON 格式)。 使用格式 {"id": "<portal-id>"}。 如果提供了值,则此参数的优先级将高于报表模板参数。

String

arcpy.management.ExportWebMap(Web_Map_as_JSON, Output_File, {Format}, {Layout_Templates_Folder}, {Layout_Template}, {Layout_Item_ID}, {Report_Template}, {Report_Item_ID})
名称说明数据类型
Web_Map_as_JSON

要按照 Web 应用程序中显示的情况导出地图状态的 JSON 制图表达。请参阅 ExportWebMap 规范以了解如何设置此文本格式。 通过 ArcGIS API for JavaScript,您可以从地图中获取此 JSON 字符串。

String
Output_File

输出文件名。 文件扩展名取决于 Format 参数值。

File
Format
(可选)

指定传送打印用地图影像时所使用的格式。

  • PNG8将使用 8 位可移植网络图形 (PNG8)。 这是默认设置。
  • PDF将使用可移植文档格式 (PDF)。
  • PNG32将使用 32 位可移植网络图形 (PNG32)。
  • JPG将使用联合图像专家组 (JPG)。
  • GIF将使用图形交换格式 (GIF)。
  • EPS将使用 Encapsulated PostScript (EPS)。
  • SVG将使用可伸缩矢量图形 (SVG)。
  • SVGZ将使用压缩的可伸缩矢量图形 (SVGZ)。
  • AIX将使用 Adobe Illustrator Exchange (AIX)。
  • TIFF将使用标记图像文件格式 (TIFF)。
注:

输出文件的背景始终是不透明的。

String
Layout_Templates_Folder
(可选)

包含要用作模板的布局或报表页面(.pagx.rptx.rptt 文件)的文件夹的完整路径。 默认位置为 <install_directory>\Resources\ArcToolBox\Templates\ExportWebMapTemplates

Folder
Layout_Template
(可选)

可以是列表中某个模板的名称,也可以是关键字 MAP_ONLY。 使用 MAP_ONLY 或传递空字符串时,输出地图将不包含任何页面布局元素,例如标题、图例和比例尺。

String
Layout_Item_ID
(可选)

将用于模板的布局项的门户 ID(JSON 格式)。 使用格式 {"id": "<portal-id>"}。 如果提供了值,则此参数的优先级将高于 Layout_Template 参数。

String
Report_Template
(可选)

报表模板的名称。

如果提供此参数,则 Format 参数必须设置为 PDF。 如果未指定此参数,则输出文件将不包含任何报表。

String
Report_Item_ID
(可选)

将用于模板的布局项目的门户 ID(JSON 格式)。 使用格式 {"id": "<portal-id>"}。 如果提供了值,则此参数的优先级将高于 Report_Template 参数。

String

环境

此工具不使用任何地理处理环境。