返回顶部

对表格中的位置进行地理编码 (地理编码)

在本主题中

  1. 摘要
  2. 使用情况
  3. 参数
  4. 环境
  5. 许可信息

摘要

此工具使用在 ArcGIS Enterprise 门户上托管的定位器对托管表格进行地理编码，可创建包含地理编码结果的托管要素图层。

此工具用于自动执行对发布到门户的表格进行地理编码并将输出保存到门户的过程。 如果不需要将地理编码结果保存到门户，请使用地理编码表格窗格或地理编码地址工具。

注：

必须在门户网站上具有发布者或管理员权限才能运行此工具。 如果您是具有自定义角色的成员，请确保门户管理员已授予您发布托管 web 图层的权限。

使用情况

  • 您可以对存储在单个字段中或拆分成多个字段的地址进行地理编码，也可以对存储在单个字段和国家/地区字段的地址编码。 单个输入字段可存储完整地址，例如，303 Peachtree St NE, Atlanta, GA 30308。 如果将常规美国地址的输入地址划分为 Address、City、State 和 ZIP 等多个字段，则系统支持多个字段。 存储完整地址的单个输入字段，例如，303 Peachtree St NE, Atlanta, GA 30308，以及存储与地址关联的国家/地区的字段（例如，USA）。

  • 某些定位器支持多个输入地址字段，例如 Address、Address2 和 Address3。 在此情况下，可以将地址组件分为多个字段，然后在进行地理编码时将地址字段连接在一起。 例如，跨三个字段的 100、Main st 和 Apt 140，或者跨两个字段的 100 Main st 和 Apt 140，在进行地理编码时，都将成为 100 Main st Apt 140。

  • 使用该工具需要 ArcGIS Enterprise 10.6 或更高版本。

  • 使用 ArcGIS Enterprise 门户上已配置为使用多个线程的定位器可提高地理编码性能。

  • 输入表必须为托管表格或者已在 ArcGIS Enterprise 门户上发布的表格作为输入表。 托管表格将视为托管要素图层的一部分，并且必须在门户中创建为项目，才能在工具中使用。 有关详细信息，请参阅发布托管要素图层。

  • 输出托管要素图层保存在与地址定位器相同的空间参考中。 可通过在工具的环境设置中设置其他输出坐标系来更改输出要素图层的空间参考。

  • 输出托管要素图层将包含所有相关的地理编码信息，例如每个记录的得分、状态和匹配的地址，以及原始输入表中的值。 可使用重新匹配地址工具或重新匹配地址选项（将打开重新匹配地址窗格）重新匹配地址。 此工具的地理编码结果包含原始输入表的静态快照，因此在原始表中添加或更新值都不会更新输出要素服务中的结果。 重新运行此工具以创建包含这些更改的新输出要素服务。

    了解有关重新匹配地理编码结果的详细信息

  • 当使用使用 z 感知数据构建的输入定位器时，该工具将返回非 z 感知的输出。 该工具仅支持 2D 输出。

  • 并非所有用于地址定位器参数值的定位器都支持以下参数：国家或地区、首选位置类型和类别。

  • 当将定位器视图作为地址定位器参数值使用时，工具不会应用在 ArcGIS Pro 3.2 中创建的定位器视图的配置。

参数

对话框Python

标注说明数据类型
输入表

门户中的表格，其中包含将进行地理编码的地址或地点。

Record Set
地址定位器

将用于对门户的输入表格进行地理编码的门户定位器。

可以从活动门户上的已填充定位器列表中选择一个定位器，或者浏览活动门户以搜索其他可用定位器。 默认情况下，已在活动门户中设置为实用程序服务的定位器将可用。 如果您要使用的门户定位器未包含在填充列表中，可请求您的门户管理员将此定位器添加为门户实用程序服务，并针对批量地理编码配置此定位器。

注：

ArcGIS World Geocoding Service 已针对此工具禁用。 如果想要使用 ArcGIS World Geocoding Service，请使用地理编码地址工具。

Address Locator
地址字段映射

定位器使用的地址字段会映射到输入地址表中的字段。 如果输入表中的完整地址存储在一个字段中，例如 303 Peachtree St NE, Atlanta, GA 30308，则需指定单个字段。 如果将常规美国地址的输入划分为 Address、City、State 和 ZIP 等多个字段，则需指定多个字段。 如果将完整地址和国家/地区拆分为多个字段，例如，303 Peachtree St NE, Atlanta, GA 30308 和 USA 被拆分为 Address 和 Country，则需指定单个字段和国家/地区字段。

某些定位器支持多个输入地址字段，例如 Address、Address2 和 Address3。 在此情况下，可以将地址组件分为多个字段，然后在进行地理编码时将地址字段连接在一起。 例如，跨三个字段的 100、Main St 和 Apt 140，或者跨两个字段的 100 Main St 和 Apt 140，在进行地理编码时，都将成为 100 Main St Apt 140。

如果不想将定位器所使用的可选输入地址字段映射到输入地址表中的字段，请使用 <None> 来代替字段名，以此指定不存在任何映射。

Field Info
输出要素图层名称

将在门户上创建的输出地理编码要素图层的名称。

String
国家/地区
(可选)

用于将搜索范围限定为特定国家或地区的地理编码地址。 指定一个国家/地区将在大多数情况下提高地理编码的准确性。 如果未指定国家/地区，则使用定位器的所有受支持国家/地区执行地理编码。

当您在地址字段映射参数中同时指定单个字段和国家/地区字段时，此参数将被忽略。

String
首选位置类型
(可选)

用于指定将返回的 PointAddress 匹配的首选输出几何。 如果数据中不存在首选位置，则将返回地址位置的默认位置。 有关 geocodeAddresses 的 locationType 参数的详细信息，请参阅 ArcGIS REST API Web 帮助。

  • 地址位置—将返回地理编码结果的几何，该几何可以表示地址位置，例如屋顶位置、宗地质心或前门。 这是默认设置。
  • 路径位置—将返回表示靠近街道一侧（可用于车辆配送）的位置的地理编码结果的几何。
String
类别
(可选)

限制定位器搜索的地点类型，避免误匹配、不必要的地址级别匹配或坐标搜索的歧义。 此参数有助于加快搜索速度。 如果未使用任何类别，将使用所有支持的类别执行地理编码。 并非所有位置和国家/地区都支持所有类别值。

有关类别过滤的详细信息，请参阅 ArcGIS REST API Web 帮助。

String
输出字段
(可选)

指定将在地理编码结果中返回的定位器输出字段。

如果选择仅位置、最小或最小和用户字段选项，则会保留输入表参数值中的原始字段名称。

  • 全部—在地理编码结果中包含所有可用的定位器输出字段。 这是默认设置。
  • 仅位置—在地理编码结果中存储 Shape 字段。
  • 最小化—添加以下字段，用于描述位置以及其与地理编码结果中定位器中的信息的匹配程度：Shape、Status、Score、Match_type、Match_addr 和 Addr_type。
  • 最小化和用户字段—用户自定义的字段以及 MINIMAL 字段也将被添加到地理编码结果中并返回。
注：

此参数可与使用创建定位器或创建要素定位器工具创建的输入定位器一起使用，这些定位器已发布到 Enterprise 10.9 或更高版本。 包含至少一个使用创建地址定位器工具创建的定位器的复合定位器不支持此参数。

String

派生输出

标注说明数据类型
输出图层

连接到门户中的输出地理编码结果要素图层的超链接。 要素图层的名称派生自输出要素图层名称值。

Feature Set

arcpy.geocoding.GeocodeLocationsFromTable(in_table, in_address_locator, address_fields, output_name, {country}, {location_type}, {category}, {output_fields})
名称说明数据类型
in_table

门户中的表格，其中包含将进行地理编码的地址或地点。

Record Set
in_address_locator

将用于对门户的输入表格进行地理编码的门户定位器。

可以从活动门户上的已填充定位器列表中选择一个定位器，或者浏览活动门户以搜索其他可用定位器。 默认情况下，已在活动门户中设置为实用程序服务的定位器将可用。 如果您要使用的门户定位器未包含在填充列表中，可请求您的门户管理员将此定位器添加为门户实用程序服务，并针对批量地理编码配置此定位器。

注：

ArcGIS World Geocoding Service 已针对此工具禁用。 如果想要使用 ArcGIS World Geocoding Service，请使用地理编码地址工具。

Address Locator
address_fields
[input_locator_field, table_field_name]

此参数中的每个字段映射均采用 input_locator_field, table_field_name 格式，其中 input_locator_field 是定位器指定的输入地址字段名称，table_field_name 是要进行地理编码的地址表中相应字段的名称。

您可以指定一个单个输入字段以存储完整地址，例如，303 Peachtree St NE, Atlanta, GA 30308。如果常规美国地址的输入地址拆分成 Address、City、State 和 ZIP 等多个字段，也可以指定多个字段。 您也可以指定存储完整地址（例如 303 Peachtree St NE, Atlanta, GA 30308）的单个输入字段和存储与地址关联的国家（例如 USA）的字段。

某些定位器支持多个输入地址字段，例如 Address、Address2 和 Address3。 在此情况下，可以将地址组件分为多个字段，然后在进行地理编码时将地址字段连接在一起。 例如，跨三个字段的 100、Main St 和 Apt 140，或者跨两个字段的 100 Main St 和 Apt 140，在进行地理编码时，都将成为 100 Main St Apt 140。

如果不想将定位器所使用的可选输入地址字段映射到输入地址表中的字段，请使用 <None> 来代替字段名，以此指定不存在任何映射。

Field Info
output_name

将在门户上创建的输出地理编码要素图层的名称。

String
country
[country,...]
(可选)

用于将搜索范围限定为特定国家或地区的地理编码地址。 指定一个国家/地区将在大多数情况下提高地理编码的准确性。 如果未指定国家/地区，则使用定位器的所有受支持国家/地区执行地理编码。

当 in_table 参数值中的字段已映射到 address_fields 参数中的 Country 字段时，此参数值将被忽略。

在以逗号分隔的列表中，将值指定为 2 个字符或 3 个字符的国家/地区代码。 有关要使用的输入值，请参阅受支持的国家/地区代码列。

String
location_type
(可选)

用于指定将返回的 PointAddress 匹配的首选输出几何。 如果数据中不存在首选位置，则会返回 ADDRESS_LOCATION 的默认位置。 有关 geocodeAddresses 的 locationType 参数的详细信息，请参阅 ArcGIS REST API Web 帮助。

  • ADDRESS_LOCATION—将返回地理编码结果的几何，该几何可以表示地址位置，例如屋顶位置、宗地质心或前门。 这是默认设置。
  • ROUTING_LOCATION—将返回表示靠近街道一侧（可用于车辆配送）的位置的地理编码结果的几何。
String
category
[category,...]
(可选)

限制定位器搜索的地点类型，避免误匹配、不必要的地址级别匹配或坐标搜索的歧义。 此参数有助于加快搜索速度。 如果未使用任何类别，将使用所有支持的类别执行地理编码。 并非所有位置和国家/地区都支持所有类别值。

有关类别过滤的详细信息，请参阅 ArcGIS REST API Web 帮助。

String
output_fields
(可选)

指定将在地理编码结果中返回的定位器输出字段。

如果指定了 LOCATION_ONLY、MINIMAL 或 MINIMAL_AND_USER 选项，则将保留来自 in_table 参数值的原始字段名称。

注：

此参数可与使用创建定位器或创建要素定位器工具创建的输入定位器一起使用，这些定位器已发布到 Enterprise 10.9 或更高版本。 包含至少一个使用创建地址定位器工具创建的定位器的复合定位器不支持此参数。

  • ALL—在地理编码结果中包含所有可用的定位器输出字段。 这是默认设置。
  • LOCATION_ONLY—在地理编码结果中存储 Shape 字段。
  • MINIMAL—添加以下字段，用于描述位置以及其与地理编码结果中定位器中的信息的匹配程度：Shape、Status、Score、Match_type、Match_addr 和 Addr_type。
  • MINIMAL_AND_USER—用户自定义的字段以及 MINIMAL 字段也将被添加到地理编码结果中并返回。
String

派生输出

名称说明数据类型
output_layer

连接到门户中的输出地理编码结果要素图层的超链接。 要素图层的名称派生自输出要素图层名称值。

Feature Set

代码示例

GeocodeLocationsFromTable 示例（独立脚本）

以下独立脚本演示了如何使用 GeocodeLocationsFromTable 函数对托管表格图层进行地理编码。

注：
如果您正在使用您的门户上的定位器，请确保您已登录系统并在 ArcGIS Pro 中将其设置为您的活动门户。 要访问除活动门户之外的门户上的定位器，请使用 SignInToPortal 函数进行身份验证。

import arcpy

# Input is a hosted table
input_table = "https://<machine_name>/server/rest/services/Hosted/<item_name>/FeatureServer/<table_number>"

# This tool works with locators on your portal
in_locator = "https://<machine_name>/server/rest/services/<locator_name>/GeocodeServer/<locator_name>"

# The easiest way to generate a field mapping is to run the tool in ArcGIS 
# Pro and right-click the green success ribbon and click "Copy Python command"
field_mapping =  "'Street or Intersection' address VISIBLE NONE;'City or Placename' <None> VISIBLE NONE;State <None> VISIBLE NONE;'ZIP Code' zip VISIBLE NONE"
output_name = "geocoding_output"

# Optional geocoding parameters. Only some are supported depending on the 
# in_locator that you use.
country = None
location_type = None
category = None

# The output is a hosted feature layer on your portal. To retrieve the
# output, go to your portal and look for a new item with the output_name that 
# you entered.
arcpy.geocoding.GeocodeLocationsFromTable(input_table, in_locator, 
                                          field_mapping, output_name, country, 
                                          location_type, category)

环境

输出坐标系

许可信息

  • Basic: 需要 ArcGIS Enterprise 中的帐户有执行分析的权限
  • Standard: 需要 ArcGIS Enterprise 中的帐户有执行分析的权限
  • Advanced: 需要 ArcGIS Enterprise 中的帐户有执行分析的权限

相关主题

  • 门户工具集概述
  • 查找地理处理工具

有关此主题的反馈?

在本主题中
  1. 摘要
  2. 使用情况
  3. 参数
  4. 环境
  5. 许可信息