分块标注转注记 (制图)

摘要

基于面索引图层将地图中的各图层的标注转换为注记。

该工具将地图划分为多个分块并依次为每一块创建注记。 这非常适合于将大量标注转换为注记。 面索引图层可以使用地图服务器缓存切片方案转换为面或格网索引要素工具生成，也可以是覆盖了要创建注记的区域的任何其他面要素类。

使用情况

• 标注可以转换为单个图层或整个地图的注记。 如果选择了单个图层选项，则必须指定图层，并且该图层必须位于地图中。

• 标注分类比例范围将被考虑。 当该工具生成指定参考比例的注记时，它将仅转换该比例下呈启用状态并且可见的标注分类。

  注：

  在 ArcGIS Pro 中，标注分类比例范围可在图层属性中进行设置。 配置好标注属性后，请先保存工程，再运行该工具。

• 如果在运行该工具之前选择分块，则只会为所选分块创建注记。

• 若只需为面索引图层中的某些分块更新注记，可先选择带有该特定 TileID 值的注记要素并删除它们。 然后选择面要素并重新运行该工具。

• 该工具的输出是一系列图层组。 在每个图层组中，需要创建注记的每个参考比例均将对应一个组中图层。

• 在目录窗格或 模型构建器 中工作时，可使用保存至图层文件工具将输出图层组写入图层文件中。

• 如果指定的图层名称相同并且已明确声明允许覆盖输出，则现有图层组将被覆盖。

• 如果地图中存在重复的要素类名称，则注记中的要素类名之后将添加一个数字（例如，Cities01Anno10000、Cities02Anno10000 等）。

• 如果指定了现有后缀，则不会覆盖注记要素类。 在这种情况下，注记要素类后缀中将添加一个数字（例如 CitiesAnno10000、CitiesAnno10000_1 等）。

• 注记要素类的参考比例可通过以下两种方式之一进行指定：

  • 第一种是，通过面索引图层中的某个字段来确定输出注记要素类的参考比例。 如果要为各个比例级别创建注记，则可以选用这种方式。
  • 第二种就是明确声明一个参考比例值。 所有的注记要素类都将使用这个参考比例。 如果在地图中设置了参考比例，则该参考比例将作为默认值输入到工具中。 如果地图中未设置参考比例，则当前比例将作为默认值。

• 如果使用的是通过地图服务器缓存切片方案转面工具创建的面索引图层，请使用参考比例字段参数的 Tile_Scale 字段。 将会为每个图层-Tile_Scale 组合创建注记要素类。

• 如果正在生成多个参考比例下的注记，请在每种比例下分别设计地图并避免设置参考比例。

• 如果面索引图层中提供坐标系字段，则各分块的注记将投影到该坐标系中，以便进行绘制和放置。

• 如果未选中创建要素关联注记参数，则可使用将所有图层中的标注转换为单个输出要素类参数为整个地图创建单个注记要素类。

  为地图创建单个注记要素类时，可以使用合并类似标注类参数将具有类似属性的标注类合并到一个注记类中。

• 与要素关联的注记与地理数据库中另一个要素类中的特定要素相关联。 如果创建关联要素的注记，则将自动生成关系类。

• 创建关联要素的注记时，输出工作空间必须与所关联要素类的输出工作空间相同。

• 某些标注目前可能未显示在地图上，原因是没有供它们显示的空间。 要转换这些标注，请选中生成未放置的注记复选框。 这样便可将未放置的标注保存到注记要素类中，以便今后在编辑会话中可以找到它们。

• 内存和 in_memory 工作空间不支持要素关联注记。

• 此工具支持注记文本字符串字段长度环境。 设置后，它将覆盖数据库中创建的所有注记要素类中 TextString 字段的默认字段长度。

参数

对话框

标注	说明	数据类型
输入地图	包含要转换为注记的标注的地图。	Map
面索引图层	包含分块要素的面图层。	Table View
输出地理数据库	用来保存输出要素类的工作空间。 此工作空间可以是现有地理数据库或现有要素数据集。	Workspace; Feature Dataset
输出图层	包含所生成注记的图层组。 可使用保存至图层文件工具将输出图层组写入图层文件中。	Group Layer
注记后缀	为每个新注记要素类添加的后缀。 该后缀将追加到各新注记要素类的源要素类名称之后。 注记的参考比例遵照该后缀。	String
参考比例值 (可选)	将用作注记参考的比例值。 注记中的所有符号及文本的大小都会参照此比例。	Double
参考比例字段 (可选)	面索引图层中用于确定注记参考比例的字段。 注记中的所有符号及文本的大小都会参照此比例。	Field
分块 ID 字段 (可选)	面索引图层中用于唯一标识分块区域的字段。 这些值将填充到注记要素类属性表中的 TileID 字段。	Field
坐标系字段 (可选)	面索引图层中包含各分块坐标系信息的字段。 考虑到存储坐标系信息时所需的字段长度，包含坐标系字段的面索引图层必须为地理数据库要素类。	Field
地图旋转字段 (可选)	面索引图层中包含地图将旋转角度值的字段。	Field
创建关联要素注记 (可选)	许可： 仅当具有 ArcGIS Desktop Standard 和 ArcGIS Desktop Advanced 许可时，此参数才可用。 用于指定是否将输出注记要素类关联到其他要素类中的要素。 未选中 - 输出注记要素类将不会关联到其他要素类中的要素。 这是默认设置。 选中 - 输出注记要素类将关联到其他要素类中的要素。	Boolean
将未放置的标注转换为未放置的注记 (可选)	指定是否将基于未放置标注创建未放置注记。 取消选中 - 仅为当前已标注的要素创建注记。 这是默认设置。 选中 - 未放置的注记将存储到注记要素类中。 这些注记的状态字段将设置为“未放置”。	Boolean
转换 (可选)	指定是为地图中的所有图层还是为单个图层创建注记。 必须指定单个图层。 地图中的所有图层—标注将转换为整个地图的注记。 这是默认设置。 单个图层—标注将转换为单个图层的注记。 必须指定图层。	String
要素图层 (可选)	当转换参数设置为单个图层时将转换的图层。 该图层必须位于地图中。	Feature Layer
需要从符号表中选择符号 (可选)	指定是否可以编辑所有文本符号属性。 未选中 - 可以编辑所有文本符号属性。 这是默认设置。 已选中 - 只能编辑启用注记要素以保持集合中对其关联文本符号的引用的符号属性。	Boolean
添加新要素时创建注记 (可选)	如果已选中创建要素关联注记参数，用于指定在向链接要素类添加新要素时是否创建注记。 选中 - 向关联要素类添加新要素时，将创建关联要素注记。 这是默认设置。 未选中 - 向关联要素类添加新要素时，不会创建关联要素注记。	Boolean
修改要素形状时更新注记 (可选)	如果已选中创建要素关联注记参数，用于指定在更新链接要素的形状时是否更新注记的位置。 已选中 - 修改链接要素的形状时，将更新注记的位置。 这是默认设置。 未选中 - 修改链接要素的形状时，不会更新注记的位置。	Boolean
将所有图层中的标注转换为单个输出要素类 (可选)	指定标注将转换为单独的注记要素类还是单个注记要素类。 如果转换为单个注记要素类，则注记不能与要素关联。 已选中 - 所有图层中的标注将转换为单个注记要素类。 未选中 - 标注将转换为与其图层对应的单独注记要素类。 这是默认设置。	Boolean
合并类似标注类 (可选)	如果已选中将所有图层中的标注转换为单个输出要素类参数，用于指定是否合并类似标注类。 选中 - 创建单个要素类时，将合并具有类似属性的标注类。 未选中 - 将合并具有类似属性的标注类。 这是默认设置。	Boolean

派生输出

标注	说明	数据类型
输出地理数据库	用来保存输出要素类的工作空间。	Workspace; Feature Dataset

Python

arcpy.cartography.TiledLabelsToAnnotation(input_map, polygon_index_layer, out_geodatabase, out_layer, anno_suffix, {reference_scale_value}, {reference_scale_field}, {tile_id_field}, {coordinate_sys_field}, {map_rotation_field}, {feature_linked}, {generate_unplaced_annotation}, {which_layers}, {single_layer}, {require_symbol_id}, {auto_create}, {update_on_shape_change}, {multiple_feature_classes}, {merge_label_classes})

名称	说明	数据类型
input_map	包含要转换为注记的标注的地图。	Map
polygon_index_layer	包含分块要素的面图层。	Table View
out_geodatabase	用来保存输出要素类的工作空间。 此工作空间可以是现有地理数据库或现有要素数据集。	Workspace; Feature Dataset
out_layer	包含所生成注记的图层组。 可使用保存至图层文件工具将输出图层组写入图层文件中。	Group Layer
anno_suffix	为每个新注记要素类添加的后缀。 该后缀将追加到各新注记要素类的源要素类名称之后。 注记的参考比例遵照该后缀。	String
reference_scale_value (可选)	将用作注记参考的比例值。 注记中的所有符号及文本的大小都会参照此比例。	Double
reference_scale_field (可选)	面索引图层中用于确定注记参考比例的字段。 注记中的所有符号及文本的大小都会参照此比例。	Field
tile_id_field (可选)	面索引图层中用于唯一标识分块区域的字段。 这些值将填充到注记要素类属性表中的 TileID 字段。	Field
coordinate_sys_field (可选)	面索引图层中包含各分块坐标系信息的字段。 考虑到存储坐标系信息时所需的字段长度，包含坐标系字段的面索引图层必须为地理数据库要素类。	Field
map_rotation_field (可选)	面索引图层中包含地图将旋转角度值的字段。	Field
feature_linked (可选)	许可： 仅当具有 ArcGIS Desktop Standard 和 ArcGIS Desktop Advanced 许可时，此参数才可用。 用于指定是否将输出注记要素类关联到其他要素类中的要素。 STANDARD—输出注记要素类将不会关联到其他要素类中的要素。 这是默认设置。 FEATURE_LINKED—输出注记要素类将关联到其他要素类中的要素。	Boolean
generate_unplaced_annotation (可选)	指定是否将基于未放置标注创建未放置注记。 NOT_GENERATE_UNPLACED_ANNOTATION—仅为当前已标注的要素创建注记。 这是默认设置。 GENERATE_UNPLACED_ANNOTATION—未放置的注记将存储到注记要素类中。 这些注记的状态字段将设置为“未放置”。	Boolean
which_layers (可选)	指定是为地图中的所有图层还是为单个图层创建注记。 必须指定单个图层。 ALL_LAYERS—标注将转换为整个地图的注记。 这是默认设置。 SINGLE_LAYER—标注将转换为单个图层的注记。 必须指定图层。	String
single_layer (可选)	当 which_layers 参数设置为 SINGLE_LAYER 时将转换的图层。 该图层必须位于地图中。	Feature Layer
require_symbol_id (可选)	指定是否可以编辑所有文本符号属性。 NO_REQUIRE_ID—可以编辑所有文本符号属性。 这是默认设置。 REQUIRE_ID—只能编辑启用注记要素以保持集合中对其关联文本符号的引用的符号属性。	Boolean
auto_create (可选)	如果 feature_linked 参数设置为 FEATURE_LINKED，用于指定在向链接要素类添加新要素时是否创建注记。 AUTO_CREATE—向关联要素类添加新要素时，将创建关联要素注记。 这是默认设置。 NO_AUTO_CREATE—向关联要素类添加新要素时，不会创建关联要素注记。	Boolean
update_on_shape_change (可选)	如果 feature_linked 参数设置为 FEATURE_LINKED，用于指定在更新链接要素的形状时是否更新注记的位置。 SHAPE_UPDATE—修改链接要素的形状时，将更新注记的位置。 这是默认设置。 NO_SHAPE_UPDATE—修改链接要素的形状时，不会更新注记的位置。	Boolean
multiple_feature_classes (可选)	指定标注将转换为单独的注记要素类还是单个注记要素类。 如果转换为单个注记要素类，则注记不能与要素关联。 SINGLE_FEATURE_CLASS—所有图层中的标注将转换为单个注记要素类。 FEATURE_CLASS_PER_FEATURE_LAYER—标注将转换为与其图层对应的单独注记要素类。 这是默认设置。	Boolean
merge_label_classes (可选)	用于指定在 multiple_feature_classes 参数设置为 SINGLE_FEATURE_CLASS 的情况下，是否合并类似的标注类。 MERGE_LABEL_CLASS—创建单个要素类时，将合并具有类似属性的标注类。 NO_MERGE_LABEL_CLASS—将合并具有类似属性的标注类。 这是默认设置。	Boolean

派生输出

名称	说明	数据类型
out_workspace	用来保存输出要素类的工作空间。	Workspace; Feature Dataset

代码示例

TiledLabelsToAnnotation 示例（Python 窗口）

此 TiledLabelsToAnnotation 函数的 Python 示例基于面索引图层将地图中单个图层的标注转换为注记。

import arcpy
arcpy.env.workspace = "C:/data/data.gdb"
arcpy.TiledLabelsToAnnotation_cartography("Map1", "Tiles", "data.gdb", 
                                          "GroupAnno", "Anno", "", "Tile_Scale",  
                                          "OID", "", "", "FEATURE_LINKED", 
                                          "GENERATE_UNPLACED_ANNOTATION", 
                                          "SINGLE_LAYER", "Towns", 
																																										"REQUIRE_ID", "AUTO_CREATE", 
                                          "SHAPE_UPDATE", "", "")

TiledLabelsToAnnotation 示例 2（工作流脚本）

以下脚本演示了使用 MapServerCacheTilingSchemeToPolygons 函数和 TiledLabelsToAnnotation 函数的工作流。

# Name: TiledLabelsToAnnotation_Example2.py
# Description: Create a tile feature class and use those tiles to create annotation.
# Requirements: ArcGIS Desktop Advanced license

# Import system modules
import arcpy
import os

# Set environment settings
arcpy.env.workspace = "C:/data/data.gdb"

# Set local variables
aprx = arcpy.mp.ArcGISProject(r"C:/data/Annotation.aprx")
inMap = aprx.listMaps("Map")[0]
inTilingScheme = os.path.join(
    arcpy.GetInstallInfo()['InstallDir'], 
    'Resources\\TilingSchemes\\ArcGIS_Online_Bing_Maps_Google_Maps.xml')
outFeatureClass = "C:/data/data.gdb/Tiles"
inTileExtent = "USE_MAP_EXTENT"
inClipping = "CLIP_TO_HORIZON"
inAntialiasing = "NONE"
inScales = ""

# Execute MapServerCacheTilingSchemeToPolygons
arcpy.MapServerCacheTilingSchemeToPolygons_cartography(
    inMap, inTilingScheme, outFeatureClass, inTileExtent, inClipping, 
    inAntialiasing, inScales)

# Set local variables
inPolygonIndexLayer = "Tiles"
inOutGeodatabase = "C:/data/data.gdb"
outOutLayer = "GroupAnno"
inAnnoSuffix = "Anno"
inRefScaleValue = ""
inRefScaleField = "Tile_Scale"
inTileIDField = "OID"
inCoordSysField = ""
inMapRotationField = ""
inFeatureLinked = "STANDARD"
inGenerateUnplaced = "GENERATE_UNPLACED_ANNOTATION"
inWhichLayers = "ALL_LAYERS"
inSingleLayer = ""
inRequireSymbolID = ""
inAutoCreate = ""
inUpdateOnShapeChange = ""
inMultipleFeatureClasses = "SINGLE_FEATURE_CLASS"
inMergeFeatureClasses = "MERGE_LABEL_CLASS"
 
# Execute TiledLabelsToAnnotation
arcpy.TiledLabelsToAnnotation_cartography(
    inMap, inPolygonIndexLayer, inOutGeodatabase, outOutLayer, inAnnoSuffix, 
    inRefScaleValue, inRefScaleField, inTileIDField, inCoordSysField, 
    inMapRotationField, inFeatureLinked, inGenerateUnplaced, inWhichLayers, 
    inSingleLayer, inRequireSymbolID, inAutoCreate, inUpdateOnShapeChange, 
    inMultipleFeatureClasses, inMergeFeatureClasses)

环境

参考比例, 注记文本字符串字段长度

许可信息

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