用于将面图层中的自定义输出字段添加至本地存储的现有定位器。
此工具最多可将面要素类中的 50 个唯一字段添加至本地存储的 ArcGIS StreetMap Premium 定位器或者使用创建定位器工具或创建要素定位器工具构建的定位器。
要将面图层中的字段添加至 ArcGIS StreetMap Premium 定位器，需要 ArcGIS StreetMap Premium 许可。
如果您拥有多个面要素类，其中包含要添加至定位器的字段，请使用合并工具以将面要素类合并为单个面要素类，并将其用作添加字段依据的面要素参数值。
当面要素参数值有选择时，工具将忽略该选择。
| 标注 | 说明 | 数据类型 |
输入定位器 | 将在其中添加字段的定位器（.loc 文件）。 注：定位器不能是复合定位器或地理编码服务，包括来自 ArcGIS Enterprise 或 ArcGIS Online 的服务。 在将定位器发布为地理编码服务之前，必须将面字段添加至复合定位器的参与定位器。 | Address Locator |
面要素 | 要素类，其中包含将添加至输入定位器参数值的字段（字段将附加到所有地理编码输出）。 | Feature Layer |
面输出字段 | 将附加到定位器的面要素类中的字段。 可以从面字段下拉列表中选择字段，面要素中的字段名称将用作默认字段名称。 默认字段名称将自动添加至名称列。 可以覆盖默认字段名称。 为此参数提供的指定字段或名称值可定义将在地理编码结果中返回的面要素参数值中的输出字段的名称。 如果面要素中的字段具有别名，则字段别名将用作名称值。
| Value Table |
| 标注 | 说明 | 数据类型 |
| 更新的定位器 | 更新的输入定位器，其中添加了面要素中的输出字段。 | Address Locator |
arcpy.geocoding.AddPolygonFieldsToLocator(in_locator, polygon_features, polygon_output_fields)
| 名称 | 说明 | 数据类型 |
in_locator | 将在其中添加字段的定位器（.loc 文件）。 注：定位器不能是复合定位器或地理编码服务，包括来自 ArcGIS Enterprise 或 ArcGIS Online 的服务。 在将定位器发布为地理编码服务之前，必须将面字段添加至复合定位器的参与定位器。 | Address Locator |
polygon_features | 要素类，其中包含将添加至 in_locator 参数值的字段（字段将附加到所有地理编码输出）。 | Feature Layer |
polygon_output_fields [[polygon_output_field, {name}],...] | 将附加到定位器的面要素类中的字段。 请提供 polygon_features 参数值中的字段或字段别名，默认字段名称将用作添加至定位器的字段名称。 可以覆盖默认字段名称。 为此参数提供的字段或名称值可定义将在地理编码结果中返回的 polygon_features 参数值中的输出字段的名称。 如果面要素中的字段具有别名，则字段别名将用作 Name 值。
| Value Table |
| 名称 | 说明 | 数据类型 |
| out_locator | 更新的输入定位器，其中添加了面要素中的输出字段。 | Address Locator |
将美国人口普查区块组中的面字段添加至美国定位器。
# Description: Add polygon fields from a USA Census block group feature class in a file geodatabase to a USA locator.
import arcpy
# Set local variables:
usa_locator = r"C:\Data\USA.loc"
polygon_features = r"C:\Data\USCensus.gdb\blkgrp"
polygon_output_fields = [["BLKGRP", "BLOCKGROUP"], ["POPULATION", "POPULATION"],
["VACANT", "VACANT"], ["HSE_UNITS", "HOUSE_UNITS"]]
# Run AddPolygonFieldsToLocator
arcpy.geocoding.AddPolygonFieldsToLocator(usa_locator, polygon_features, polygon_output_fields)