向定位器添加面字段 (地理编码)

摘要

用于将面图层中的自定义输出字段添加至本地存储的现有定位器。

使用情况

  • 此工具最多可将面要素类中的 50 个唯一字段添加至本地存储的 ArcGIS StreetMap Premium 定位器或者使用创建定位器工具或创建要素定位器工具构建的定位器。

  • 要将面图层中的字段添加至 ArcGIS StreetMap Premium 定位器,需要 ArcGIS StreetMap Premium 许可

  • 如果您拥有多个面要素类,其中包含要添加至定位器的字段,请使用联合工具或合并工具根据数据将面要素类合并为单个面要素类,并将其用作添加字段依据的面要素参数值。

  • 面要素参数值有选择时,工具将忽略该选择。

参数

标注说明数据类型
输入定位器

将在其中添加字段的定位器(.loc 文件)。

注:

定位器不能是复合定位器或地理编码服务,包括来自 ArcGIS EnterpriseArcGIS Online 的服务。 在将定位器发布为地理编码服务之前,必须将面字段添加至复合定位器的参与定位器。

Address Locator
面要素

要素类,其中包含将添加至输入定位器参数值的字段(字段将附加到所有地理编码输出)。

Feature Layer
面输出字段

将附加到定位器的面要素类中的字段。

可以从面字段下拉列表中选择字段,面要素中的字段名称将用作默认字段名称。 默认字段名称将自动添加至名称列。 可以覆盖默认字段名称。 为此参数提供的指定字段或名称值可定义将在地理编码结果中返回的面要素参数值中的输出字段的名称。 如果面要素中的字段具有别名,则字段别名将用作名称值。

  • 面字段 - 将添加至定位器的面要素参数值中的字段。
  • 名称 - 将显示在地理编码结果和定位器属性中的自定义输出字段的名称。
Value Table

派生输出

标注说明数据类型
更新的定位器

更新的输入定位器,其中添加了面要素中的输出字段。

Address Locator

arcpy.geocoding.AddPolygonFieldsToLocator(in_locator, polygon_features, polygon_output_fields)
名称说明数据类型
in_locator

将在其中添加字段的定位器(.loc 文件)。

注:

定位器不能是复合定位器或地理编码服务,包括来自 ArcGIS EnterpriseArcGIS Online 的服务。 在将定位器发布为地理编码服务之前,必须将面字段添加至复合定位器的参与定位器。

Address Locator
polygon_features

要素类,其中包含将添加至 in_locator 参数值的字段(字段将附加到所有地理编码输出)。

Feature Layer
polygon_output_fields
[[polygon_output_field, {name}],...]

将附加到定位器的面要素类中的字段。

请提供 polygon_features 参数值中的字段或字段别名,默认字段名称将用作添加至定位器的字段名称。 可以覆盖默认字段名称。 为此参数提供的字段或名称值可定义将在地理编码结果中返回的 polygon_features 参数值中的输出字段的名称。 如果面要素中的字段具有别名,则字段别名将用作 Name 值。

  • 面字段 - 将添加至定位器的 polygon_features 参数值中的字段。
  • 名称 - 将显示在地理编码结果和定位器属性中的自定义输出字段的名称。
Value Table

派生输出

名称说明数据类型
out_locator

更新的输入定位器,其中添加了面要素中的输出字段。

Address Locator

代码示例

AddPolygonFieldsToLocator 示例 1(独立脚本)

将美国人口普查区块组中的面字段添加至美国定位器。

# 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)

环境

此工具不使用任何地理处理环境。