ArcMap

创建运行时内容

描述

将地图文档中的要素图层、底图、网络数据集和定位器合并到一个文件夹，以便在 ArcGIS Runtime SDK 构建的应用程序中使用。随后可以将此文件夹配置到设备，以便与离线运行的应用程序（可在断开与 ArcGIS Server 或 ArcGIS Online 连接时运行的应用程序）结合使用。

使用方法

  • 如果未指定范围，则地图文档中的图层将按照地图文档中存储的范围进行裁剪。为确保将全部要素复制到 ArcGIS 运行时内容，需要将范围参数指定为 UNION_OF_INPUTS。

  • 运行时内容仅支持简单要素、表、关系类、定位器和网络数据集。如果要素图层引用或参与的关系类中引用了不受支持的数据，则此图层不能包括到运行时内容中。

  • 运行时内容不支持来自多个工作空间的数据图层，因此，地图文档中的所有图层都必须属于同一工作空间。

  • 运行时内容中的所有图层都会被投影到地图文档数据框的空间参考中。如果包括底图图层，则图层将被投影到底图图层切片方案的空间参考中。

  • 如果包括底图图层，则底图图层将用于创建切片缓存，这些缓存可在运行时应用程序中用作底图图层。切片缓存的显示速度通常比其他底图快。包括底图会增加合并运行时内容的时间。

  • 无法使用来自要素服务和地图服务的数据。有关使用 ArcGIS Runtime SDK 中服务的详细信息，请参阅服务模式。

语法

arcpy.management.CreateRuntimeContent(in_map, output_folder, {in_basemap}, {in_locator}, {extent}, {options}, optimize, service_type, format_type, level_of_detail, {service_file})
参数说明数据类型
in_map

将被合并到一个文件夹中的输入地图文档 (.mxd)。

ArcMap Document
output_folder

将包含合并数据的输出文件夹。随后可将此文件夹部署到移动设备，以便在基于 ArcGIS Runtime 的应用程序中使用。

Folder
in_basemap
（可选）

将包括在运行时内容中的输入底图图层。

String
in_locator
（可选）

将包括在运行时内容中的输入定位器 (.loc)。

Address Locator
extent
（可选）

通过在范围参数中按 X-Min Y-Min X-Max Y-Max 格式手动输入坐标来指定范围。要使用特定图层的范围，请指定图层名称。

  • MAXOF —将使用输入的并集。
  • MINOF —将使用输入的交集。
  • DISPLAY —将使用与当前显示相同的范围。
  • <Layer> —将使用与指定图层相同的范围。
Extent
options
[options,...]
（可选）

用于确定将哪些图层包括在运行时内容中的选项。

  • NETWORK_DATA — 此选项用于包括地图文档中存在的所有网络数据。
  • FEATURE_AND_TABULAR_DATA —此选项用于包括地图文档中存在的所有简单要素、表和关系类。

如果地图中含网络数据集或网络分析图层，则可以选择将网络数据集作为交通网包括到运行时内容中。包括网络时，网络所引用的所有要素图层都将成为运行时内容的一部分， 也可能包括不属于地图的图层。例如，如果地图中仅包含一个网络数据集图层，则运行时内容将包括与此网络相关的街道、交汇点和转弯要素类。

对于转变为交通网络的网络数据集，请牢记以下限制：

  • 网络数据集必须为地理数据库的一部分。其中不包括 SDC 或 shapefile 格式的网络。
  • 网络数据集必须来自 ArcGIS 10.0 或更高版本。如果网络来自较早的版本，可以更新地理数据库和网络。
  • 网络数据集中不能包含未知的坐标系。
  • 网络数据集不可以使用任何 VB 或 Python 脚本赋值器。
  • 网络数据集不可以使用任何自定义 COM 赋值器。
  • 使用实时流量的网络数据集将移植到交通网，但实时流量组件因不受支持而被排除在外。

使用 Python 时，可使用 Python 列表输入多个值，例如 ["NETWORK_DATA", "FEATURE_AND_TABULAR_DATA"]。

String
optimize

通过减小运行时内容的大小对其进行优化，以提高到移动设备的可移植性。

  • OPTIMIZE_SIZE —将优化运行时内容的大小。这是默认设置。
  • NON_OPTIMIZE_SIZE —不对运行时内容的大小进行优化。

优化包括删除所有未在渲染器、关联或连接中使用的字段。OBJECTID、SHAPE 和 GlobalID 将始终保留。此外，OPTIMIZE_SIZE 会将空间参考的精度设置为 0.1 米。

Boolean
service_type

确定是从现有地图服务生成切片方案还是根据 ArcGIS Online、Bing 地图和 Google 地图生成地图切片。

  • EXISTING —使用一个现有地图任务的切片方案。必须在 service_file 参数中指定地图服务。如果您的组织已在服务器上创建现有服务的切片方案并且您想要与其进行匹配，则请选择此选项。相匹配的切片方案可确保切片在 ArcGIS Runtime 应用程序中正确叠加。如果选择此选项，则源地图文档和用于导入切片方案的地图将使用相同的坐标系。
  • ONLINE —使用 ArcGIS Online/Bing 地图/Google 地图的切片方案。这是默认设置。ArcGIS Online/Bing 地图/Google 地图切片方案可用于将您的缓存切片与这些在线地图服务的切片进行叠加。加载切片方案时，ArcGIS Desktop 以内置选项形式包括此切片方案。选择此切片方案时，源地图文档的数据框必须使用 WGS 1984 Web Mercator (Auxiliary Sphere) 投影坐标系。如果要将您的包与 ArcGIS Online、Bing 地图或 Google 地图进行叠加，则需要使用 ArcGIS Online/Bing 地图/Google 地图切片方案。ArcGIS Online/Bing 地图/Google 地图切片方案的优势在于其在 Web 地图领域内的高熟识度，所以您的切片将与其他使用此切片方案的组织的切片相一致。即使您不打算叠加这些广为熟知的地图服务，仍然可以选择此切片方案以便于互操作。ArcGIS Online/Bing 地图/Google 地图切片方案可能包含过度放大以至于无法在地图中使用的比例。在大比例下进行打包相当耗时，且会占用大量磁盘存储空间。例如，切片方案中的最大比例约为 1:1,000。在此比例下缓存整个美国大陆可能将耗费数周时间并需要数百 GB 的存储空间。如果尚未准备好在此比例级别下进行打包，则在创建切片包时移除此比例级别。
Boolean
format_type

指定生成切片的格式。

  • PNG —使用 PNG 根据指定的细节层次自动选择正确的格式（PNG8、PNG24 或 PNG32）。这是默认设置。
  • PNG8 —PNG 8 用于需要具有透明背景的叠加服务，例如道路和边界。PNG 8 可在磁盘上创建非常小的切片且不损失任何信息。如果地图包含的颜色超过 256 种，请勿使用 PNG 8。影像、山体阴影、梯度填充、透明度和抗锯齿可轻易地使地图包含的颜色超过 256 种。即使是符号（如高速公路盾形路牌符号）也可能在其边缘周围进行微小的抗锯齿，从而使地图包含意料之外的更多颜色。
  • PNG24 —可将 PNG 24 用于超过 256 种颜色的叠加服务，例如道路和边界。如果少于 256 种颜色，请使用 PNG 8。
  • PNG32 —PNG 32 用于超过 256 种颜色的叠加服务，例如道路和边界。PNG 32 特别适用于对线或文本启用了抗锯齿的叠加服务。PNG 32 在磁盘上创建的切片比 PNG 24 大，但所有浏览器都完全支持这种切片。
  • JPEG —此格式用于颜色变化较大且不需要透明背景的底图服务；例如，栅格影像和非常详细的矢量底图特别适合使用 JPEG。JPEG 为有损图像格式。在不影响图像显示效果的情况下，它会尝试有选择地删除数据。这会在磁盘上产生很小的切片，但如果地图包含矢量线作业或标注，它可能会在线周围生成过多的噪声或模糊区域。如果发生这种情况，可尝试将压缩值从默认的 75 增加到更大的值。更高的值（如 90）可以生成可接受的线作业质量，同时还可保证 JPEG 格式的小切片优势。您将确定可接受的图像质量。如果愿意接受图像中存在少量噪声，选择 JPEG 可节省大量的磁盘空间。更小的切片也意味着应用程序可更快地下载切片。
  • MIXED —混合包在包的中心使用 JPEG，同时在包的边缘使用 PNG 32。如果要将栅格包完全叠加在其他图层之上，您应使用混合模式。创建混合包时，在检测到透明度的任何位置（也就是数据框背景可见的位置）都会创建 PNG 32 切片。其余切片使用 JPEG 构建。这可降低平均文件大小，同时可在其他包上进行完全叠加。如果在这种情况下不使用混合模式包，将在图像叠加其他包的外围区域看到一个不透明的“凸边”。
String
level_of_detail

指定生成包切片的比例级别。可能的值为 1 至 20。

Long
service_file
（可选）

指定用于切片方案的地图服务或 XML 文件的名称。仅当 service_type 参数为 EXISTING 时才需要此参数。

MapServer; File

代码示例

CreateRuntimeContent 示例 1（Python 窗口）

这是 CreateRuntimeContent 工具的 Python 示例（其中包括底图图层）。

arcpy.CreateRuntimeContent_management("D:/Geoprocessing/OfflineMapping/sandiego_locators_basemap.mxd","D:/Geoprocessing/Results/RRuntimeContent_sandiego", "MyBasemapLayer", "#", "#", "FEATURE_AND_TABULAR_DATA", "NON_OPTIMIZE_SIZE", "ONLINE", "PNG", "1", "#")
CreateRuntimeContent 示例 2（Python 窗口）

这是 CreateRuntimeContent 工具的 Python 示例，该示例将范围设置为输入的并集。

arcpy.CreateRuntimeContent_management("//qalab_server/pydata/v1021/packaging/global/mxds/filegeodatabase_redlands.mxd","D:/Geoprocessing/Results/RT_Redlands", "#", "#", "MAXOF", "NETWORK_DATA;FEATURE_AND_TABULAR_DATA", "OPTIMIZE_SIZE", "ONLINE", "PNG", "1", "#")

环境

许可信息

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

相关主题