打包地图 (数据管理)

描述

对地图以及所有引用的数据源进行打包以创建单个压缩的 .mpkx 文件。

使用方法

  • 此工具遇到不支持的图层类型时将发出警告。不支持的图层将不会被写入到输出中。

  • 输入图层必须具有描述信息,此工具才能执行。要添加描述,请右键单击该图层并单击属性,然后输入描述信息。

  • 选中将数据转换为文件地理数据库时(Python 中的 convert_data = 'CONVERT'),将出现以下情况:

    • 每个唯一数据会具有一个在合并文件夹或包中创建的文件地理数据库。
    • 压缩栅格和矢量格式会转换为一个文件地理数据库,并且原来的数据压缩将会丢失。
    • 不会合并企业级地理数据库数据。要将企业级地理数据库数据转换为文件地理数据库,请选中包括企业级地理数据库数据,而不是仅引用该数据

  • 取消选中将数据转换为文件地理数据库时(Python 中的 convert_data = 'PRESERVE'),将出现以下情况:

    • 将保留输入图层的数据源格式(如果可能)。
    • ADRG、CADRG/ECRG、CIB 和 RPF 栅格格式将始终转换为文件地理数据库栅格。ArcGIS 本身不能写出这些格式。始终将其转换为文件地理数据库栅格以提高效率。
    • 在输出文件夹结构中,文件地理数据库将合并到一个特定于版本的文件夹中,并且所有其他格式都将合并到 commonData 文件夹中。
    • 即使在范围参数中指定了范围,也不会裁剪压缩栅格和矢量格式。

  • 如果选中支持 ArcGIS Runtime(Python 中的 arcgisruntime='RUNTIME'),则版本参数将被覆盖,且该包将包含仅与当前版本兼容的地理数据库和地图。

  • 对于包含连接或参与关系类的图层,所有连接或相关的数据源都将合并到输出文件夹。默认情况下,连接或关联数据源将全部合并,或根据使用范围参数指定的范围,由选择相关行参数决定。

  • 对于要素图层,范围参数用来选择将要合并的要素。对于栅格图层,范围参数用来裁剪栅格数据集。

  • 有些数据集引用其他数据集。例如,您可能拥有一个引用了四个要素类的拓扑数据集。引用其他数据集的数据集示例还包括几何网络、网络和定位器。基于这些数据集类型合并或打包图层时,参与数据集也将被合并或打包。

  • 如果选中仅方案参数(Python 中的 schema_only = 'SCHEMA_ONLY'),则将仅合并或打包输入数据源的方案。方案是由字段和表定义、坐标系属性、符号系统、定义查询等组成的要素类或表的结构或设计。不会合并或打包数据或记录。

  • 不支持仅方案的数据源不能进行合并和打包。如果选中仅方案参数,并且此工具遇到“仅方案”不支持的图层,则会显示一条警告消息,并会跳过该图层。如果指定的唯一图层不支持“仅方案”,则该工具将失败。

语法

arcpy.management.PackageMap(in_map, output_file, {convert_data}, {convert_arcsde_data}, {extent}, {apply_extent_to_arcsde}, {arcgisruntime}, {reference_all_data}, {version}, {additional_files}, {summary}, {tags}, {select_related_rows})
参数说明数据类型
in_map
[in_map,...]

要打包的地图 (.mapx)。在 ArcGIS Pro 中运行此工具时,输入可以是地图、场景或底图。

Map
output_file

输出地图包 (.mpkx)。

File
convert_data
(可选)

指定输入图层是转换为文件地理数据库还是保留原始格式。

  • CONVERT 数据将转换为文件地理数据库。此选项不适用于企业级地理数据库数据源。要转换企业级地理数据库数据,请设置 convert_arcsde_data = 'CONVERT_ARCSDE'
  • PRESERVE保留数据格式(如有可能)。这是默认设置。
Boolean
convert_arcsde_data
(可选)

指定是将输入企业级地理数据库图层转换为文件地理数据库,还是保留其原始格式。

  • CONVERT_ARCSDE 企业级地理数据库数据将转换为文件地理数据库,并将包含在合并的文件夹或包中。这是默认设置。
  • PRESERVE_ARCSDE 将保留企业级地理数据库数据,并将在合并文件夹或包中对其进行引用。
Boolean
extent
(可选)

指定用于选择或裁剪要素的范围。

  • MAXOF - 将使用所有输入的最大范围。
  • MINOF - 将使用所有输入共有的最小区域。
  • DISPLAY - 该范围与可见显示范围相等。
  • 图层名称 - 将使用指定图层的范围。
  • Extent 对象 - 将使用指定对象的范围。
  • 以空格分隔的坐标字符串 - 将使用指定字符串的范围。坐标以 x-min,y-min,x-max,y-max 的顺序表示。
Extent
apply_extent_to_arcsde
(可选)

指定是将指定范围应用到所有图层,还是仅应用到企业级地理数据库图层。

  • ALL 指定范围将应用到所有图层。这是默认设置。
  • ARCSDE_ONLY指定范围将仅应用到企业级地理数据库图层。
Boolean
arcgisruntime
(可选)

指定包是否支持 ArcGIS Runtime。要支持 ArcGIS Runtime,所有数据源均需转换为文件地理数据库,并在输出包中创建 .msd 文件。

  • DESKTOP输出包将不支持 ArcGIS Runtime。除非另外指定,否则数据源不会转换为文件地理数据库,并且不会创建 .msd 文件。
  • RUNTIME 输出包将支持 ArcGIS Runtime。所有数据源均将转换为文件地理数据库,并在输出包中创建 .msd 文件。
Boolean
reference_all_data
(可选)

如果将此选项设置为 REFERENCED,则会创建一个引用所需数据(而非复制数据)的包。在尝试打包位于组织内中心位置的大型数据集时,此选项十分有用。

  • REFERENCED创建一个引用数据(而非复制数据)的包。
  • NOT_REFERENCED 创建一个包含所有所需数据的包。这是默认设置。
Boolean
version
[version,...]
(可选)

指定将在结果包中创建的地理数据库版本。指定版本可实现与之前版本的 ArcGIS 共享包,并可支持向后兼容。

注:

保存为之前版本的包可能会丢失仅适用于较新版本的属性。

  • ALL包中将包含与所有版本(ArcGIS Pro 1.2 和更高版本)均兼容的地理数据库和地图。
  • CURRENT 包中包含与当前版本兼容的地理数据库和地图。
  • 2.x包中将包含与 2.0 和更高版本均兼容的地理数据库和地图。
  • 1.2包中将包含与 1.2 和更高版本均兼容的地理数据库和地图。
String
additional_files
[additional_files,...]
(可选)

将附加文件添加到包中。诸如 .doc.txt.pdf 等附加文件可用于提供有关打包内容和目的的详细信息。

File
summary
(可选)

将摘要信息添加到包的属性中。

String
tags
(可选)

将标签信息添加到包的属性中。可以添加多个标签,标签之间用逗号或分号进行分隔。

String
select_related_rows
(可选)

指定是否将指定的范围应用至相关数据源。

  • KEEP_ONLY_RELATED_ROWS仅合并指定范围内与记录对应的相关数据。
  • KEEP_ALL_RELATED_ROWS相关的数据源将全部合并。这是默认设置。
Boolean

代码示例

PackageMap 示例 1(Python 窗口)

以下 Python 脚本演示了如何在 Python 窗口中使用 PackageMap 工具:

# This code assumes a map named "World1" exists in the current project
import arcpy
outputFile = "c:/outputPackages/world_map.mpkx"
arcpy.PackageMap_management("World1", outputFile, "PRESERVE", "CONVERT_ARCSDE", "#", "ALL")

许可信息

  • Basic: 是
  • Standard: 是
  • Advanced: 是

相关主题