标注 | 说明 | 数据类型 |
输入地图 | 用于生成切片并对其进行打包的地图。 | Map |
适用于 ArcGIS Online | Bing Maps | Google Maps 的包 | 指定是从现有的地图服务生成切片方案,还是根据 ArcGIS Online、Bing Maps 和 Google Maps 生成地图切片。
| Boolean |
输出文件 | 输出地图切片包。 | File |
切片格式 | 指定生成切片将使用的格式。
| String |
最高细节层次 | 与用于定义缓存切片方案的比例数相对应的整数表达。 此比例值用于定义在切片包中生成缓存切片的最高级别。 较大的值反映可以显示更多细节的较大比例,但占用的存储空间较多。 较小的值反映可以显示较少细节的较小比例,并且占用的存储空间较少。 可能的值范围为 1 至 23。 默认值为 1。 最大细节层次值必须大于最小细节层次值。 | Long |
服务 (可选) | 将用于切片方案的地图服务或 .xml 文件的名称。 仅当未选中适用于 ArcGIS Online | Bing Maps | Google Maps 的包参数时才需要此参数。 | Map Server; File |
摘要 (可选) | 将摘要信息添加到包的属性中。 | String |
标签 (可选) | 将标签信息添加到包的属性中。 可以添加多个标签,用逗号或分号分隔。 | String |
范围 (可选) | 指定用于选择或裁剪要素的范围。
| Extent |
压缩质量 (可选) | 用于 JPEG 压缩质量的介于 1 和 100 之间的值。 对于 JPEG 切片格式,默认值为 75;对于其他切片格式,默认值为 0。 仅 JPEG 和混合格式支持压缩。 如果选择较高的值,则生成的文件较大,但图像质量较好。 如果选择较低的值,则生成的文件较小,但图像质量较差。 | Long |
包类型 (可选) | 指定将创建的切片包类型。
| String |
最低细节层次 (可选) | 与用于定义缓存切片方案的比例数相对应的整数表达。 此比例值用于定义在切片包中生成的缓存切片开始可用的级别。 可能的值范围为 0 至 23。 默认值为 0。 最小细节层次值必须小于或等于最大细节层次值。 | Long |
感兴趣区域 (可选) | 用于限制创建切片的位置的要素集。 使用感兴趣区域为不规则形状区域或多部件要素创建切片。 不会缓存感兴趣区域要素边界框外的区域。 如果未为此参数提供值,则感兴趣区域将为输入地图的全图范围。 | Feature Set |
摘要
从地图生成切片,并将切片进行打包从而创建单个压缩切片包(.tpkx 文件)。
使用情况
输入地图必须包含要运行工具的描述和标签。 要添加描述和标签,请在内容窗格中右键单击地图名称,选择属性,然后在描述选项卡上提供描述和标签。
切片格式参数被选择为 PNG 时,工具将根据指定的显示级别值自动选择正确格式(PNG8、PNG24 或 PNG32)。
此工具支持并行处理因子环境。 如果环境未设置(默认情况下)或已设置为 100,则将启用完全并行处理,同时该工具尝试将工作分配给计算机上的所有逻辑内核。 将环境设置为 0 将禁用并行处理。 在 1 到 99 之间指定一个因子时,工具将通过应用以下公式确定要使用的逻辑内核的百分比,其结果将向上舍入到最近的整数值:
并行处理因子 / 100 * 逻辑内核数
如果此公式的结果是 0 或 1,则将不启用并行处理。
参数
arcpy.management.CreateMapTilePackage(in_map, service_type, output_file, format_type, level_of_detail, {service_file}, {summary}, {tags}, {extent}, {compression_quality}, {package_type}, {min_level_of_detail}, {area_of_interest})
名称 | 说明 | 数据类型 |
in_map | 用于生成切片并对其进行打包的地图。 | Map |
service_type | 指定是从现有的地图服务生成切片方案,还是根据 ArcGIS Online、Bing Maps 和 Google Maps 生成地图切片。
| Boolean |
output_file | 输出地图切片包。 | File |
format_type | 指定生成切片将使用的格式。
| String |
level_of_detail | 与用于定义缓存切片方案的比例数相对应的整数表达。 此比例值用于定义在切片包中生成缓存切片的最高级别。 较大的值反映可以显示更多细节的较大比例,但占用的存储空间较多。 较小的值反映可以显示较少细节的较小比例,并且占用的存储空间较少。 可能的值范围为 1 至 23。 默认值为 1。 最大细节层次值必须大于最小细节层次值。 | Long |
service_file (可选) | 将用于切片方案的地图服务或 .xml 文件的名称。 仅当 service_type 参数设置为 EXISTING 时才需要此参数。 | Map Server; File |
summary (可选) | 将摘要信息添加到包的属性中。 | String |
tags (可选) | 将标签信息添加到包的属性中。 可以添加多个标签,用逗号或分号分隔。 | String |
extent (可选) | 指定用于选择或裁剪要素的范围。
| Extent |
compression_quality (可选) | 用于 JPEG 压缩质量的介于 1 和 100 之间的值。 对于 JPEG 切片格式,默认值为 75;对于其他切片格式,默认值为 0。 仅 JPEG 和混合格式支持压缩。 如果选择较高的值,则生成的文件较大,但图像质量较好。 如果选择较低的值,则生成的文件较小,但图像质量较差。 | Long |
package_type (可选) | 指定将创建的切片包类型。
| String |
min_level_of_detail (可选) | 与用于定义缓存切片方案的比例数相对应的整数表达。 此比例值用于定义在切片包中生成的缓存切片开始可用的级别。 可能的值范围为 0 至 23。 默认值为 0。 最小细节层次值必须小于或等于最大细节层次值。 | Long |
area_of_interest (可选) | 用于限制创建切片的位置的要素集。 使用感兴趣区域为不规则形状区域或多部件要素创建切片。 不会缓存感兴趣区域要素边界框外的区域。 如果未为此参数提供值,则感兴趣区域将为输入地图的全图范围。 | Feature Set |
代码示例
以下 Python 脚本演示了如何在 Python 窗口中使用 CreateMapTilePackage 函数。
import arcpy
arcpy.env.workspace = "C:/TilePackageExample"
arcpy.management.CreateMapTilePackage("World Soils", "ONLINE", "Example.tpk", "PNG8", "10")
针对工程中的所有地图,查找并创建地图切片包。
# Name: CreateMapTilePackage.py
# Description: Find all the maps in the project and
# create a map tile package for each map
# import system modules
import os
import arcpy
# Set environment settings
arcpy.env.overwriteOutput = True
arcpy.env.workspace = "C:/Tilepackages"
# Loop through the project, find all the maps, and
# create a map tile package for each map,
# using the same name as the map
p = arcpy.mp.ArcGISProject("c:\\temp\\myproject.aprx")
for m in p.listMaps():
print("Packaging " + m.name)
arcpy.management.CreateMapTilePackage(m, "ONLINE", "{}.tpk".format(m.name),
"PNG8", "10")
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是