对文件进行地理编码 (地理编码工具)

汇总

将大型本地地址或地点表转换为要素类中的点或 CSV 或 XLS 表。此工具使用在 ArcGIS Enterprise 门户上托管的定位器。

用法

此工具支持将以下表格式作为输入：
- 逗号分隔值文件 (.csv)
- 文件地理数据库表
- Microsoft Excel 工作表（.xls 和 .xlsx 文件）
对于输入 CSV 表，除了从定位器追加的字段之外，输入文件的第一行用作输出表的字段名称。字段名称不能包含空格或特殊字符，例如 $ 或 *。

了解有关在 ArcGIS Pro 中处理 Microsoft Excel 文件的详细信息

注:

要以最快速方式使用文件地理数据库形式的输入表返回地理编码结果，可限制文件地理数据库的内容，或提供包含单个表的文件地理数据库。
您可以对存储在单个字段中、分为多个字段或存储在单个字段和一个国家/地区字段中的地址进行地理编码。单个输入字段可存储完整地址，例如，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.7 或更高版本门户。
如果有门户定位器未在门户上作为公共设施服务提供，则需要请求门户管理员将此定位器添加为门户公共设施服务，并配置该定位器以进行批量地理编码。
使用 ArcGIS Enterprise 门户上已配置为使用多个线程的定位器可提高地理编码性能。
地理编码结果保存在与定位器相同的空间参考中。可通过在工具的环境设置中设置其他输出坐标系来更改输出空间参考。
地理编码结果将包含所有相关的地理编码信息，例如每个记录的得分、状态和匹配的地址，以及原始输入表中的值。此工具的地理编码结果包含原始输入表的静态快照，因此在原始表中添加或更新值都不会更新输出文件中的结果。重新运行该工具以创建包含这些更改的输出文件。
当地理编码结果作为要素类返回时，可使用重新匹配地址工具或 重新匹配地址选项（将打开 重新匹配地址窗格）重新匹配地址。

注:

该表必须在 ArcGIS Enterprise 10.8 门户中使用具有多个用于批量地理编码的线程的定位器进行地理编码。

了解有关重新匹配地理编码结果的详细信息
当使用使用 z 感知数据构建的输入定位器时，该工具将返回非 z 感知的输出。该工具仅支持 2D 输出。
并非所有用于 定位器参数值的定位器都支持以下参数： 国家或地区、 首选位置类型和类别。
当将定位器视图作为 定位器参数值使用时，工具不会应用在 ArcGIS Pro 3.2 中创建的定位器视图的配置。

标注	说明	数据类型
输入表	包含要以 CSV、XLS 或 XLSX 格式或文件地理数据库表格式进行地理编码的地址或地点的输入表。	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
输出类型	指定将写入地理编码结果的文件类型。 CSV—将返回 `.csv` 文件。要素类—将返回文件地理数据库中的要素类。 XLS—将返回 `.xls` 文件。	String
输出位置	将写入输出地理编码结果的文件夹。如果输出为 `.csv` 或 `.xls` 文件，则输出文件将置于指定的文件夹中。如果输出为要素类，则将创建输出文件地理数据库并将其置于指定的文件夹中，新文件地理数据库将包含已进行地理编码的要素类。输出文件地理数据库和文件地理数据库中的要素类将具有相同的名称。	Workspace
输出名称	输出已地理编码结果的名称。	String
国家/地区（可选）	用于将搜索范围限定为特定国家或地区的地理编码地址。在大多数情况下，指定一个国家/地区会提高地理编码的准确性。当未指定国家/地区时，地理编码将使用定位器支持的所有国家/地区执行。当在地址字段映射参数中同时指定单个字段和国家/地区字段时，此参数值将被覆盖。	String
首选位置类型（可选）	用于指定将返回的 `PointAddress` 匹配的首选输出几何。如果数据中不存在首选位置，则会返回地址位置的默认位置。有关 `geocodeAddresses` 的 `locationType` 参数的详细信息，请参阅 ArcGIS REST API Web 帮助。地址位置—将返回地理编码结果的几何，该几何可以表示地址位置，例如屋顶位置、宗地质心或前门。这是默认设置。路径位置—将返回表示靠近街道一侧（可用于车辆配送）的位置的地理编码结果的几何。	String
类别（可选）	限制定位器搜索的地点类型，避免误匹配、不必要的地址级别匹配或坐标搜索的歧义。此参数有助于加快搜索速度。如果未使用任何类别，将使用所有支持的类别进行地理编码。并非所有位置和国家/地区都支持所有类别值。有关类别过滤的详细信息，请参阅 ArcGIS REST API Web 帮助。	String
输出字段（可选）	指定将在地理编码结果中返回的定位器输出字段。如果选择仅位置、最小化或最小化和用户字段选项，则会保留输入表参数值中的原始字段名称。注: 此参数可与使用创建定位器或创建要素定位器工具创建的输入定位器一起使用，这些定位器已发布到 Enterprise 10.9 或更高版本。包含至少一个使用创建地址定位器工具创建的定位器的复合定位器不支持此参数。所有—在地理编码结果中包含所有可用的定位器输出字段。这是默认设置。仅位置—如果地理编码结果是要素类，将存储 `Shape` 字段。如果结果是 `.csv` 或 `.xls` 文件，则将存储 `Shape X` 和 `Shape Y` 字段。最小化—添加以下字段，用于描述位置以及其与地理编码结果中定位器中的信息的匹配程度：`Shape`、`Status`、`Score`、`Match_type`、`Match_addr` 和 `Addr_type`。最小化和用户字段—用户自定义的字段以及 `MINIMAL` 字段也将被添加到地理编码结果中并返回。	String

派生输出

标注	说明	数据类型
输出要素类	输出要素类。	Feature Class
输出表	采用 CSV 或 XLS 格式的输出表，具体取决于输出类型值。	Table

arcpy.geocoding.GeocodeFile(in_table, locator, address_fields, output_type, output_location, output_name, {country}, {location_type}, {category}, {output_fields})

名称	说明	数据类型
in_table	包含要以 CSV、XLS 或 XLSX 格式或文件地理数据库表格式进行地理编码的地址或地点的输入表。	Record Set
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` 是要进行地理编码的地址表中相应的字段名称。您可以可以指定单个输入字段以存储完整地址，例如，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_type	指定将写入地理编码结果的文件类型。 `CSV`—将返回 `.csv` 文件。 `FEATURE_CLASS`—将返回文件地理数据库中的要素类。 `XLS`—将返回 `.xls` 文件。	String
output_location	将写入输出地理编码结果的文件夹。如果输出为 `.csv` 或 `.xls` 文件，则输出文件将置于指定的文件夹中。如果输出为要素类，则将创建输出文件地理数据库并将其置于指定的文件夹中，新文件地理数据库将包含已进行地理编码的要素类。输出文件地理数据库和文件地理数据库中的要素类将具有相同的名称。	Workspace
output_name	输出已地理编码结果的名称。	String
country [country,...] （可选）	用于将搜索范围限定为特定国家或地区的地理编码地址。在大多数情况下，指定一个国家/地区会提高地理编码的准确性。当未指定国家/地区时，地理编码将使用定位器支持的所有国家/地区执行。当 `in_table` 参数值中的字段已映射到 `address_fields` 参数中的 `Country` 字段时，此参数值将被覆盖。在逗号分隔的列表中，以两个字符或三个字符国家/地区代码的形式指定值。有关要使用的输入值，请参阅受支持的国家/地区代码列。	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` 字段。如果结果是 `.csv` 或 `.xls` 文件，则将存储 `Shape X` 和 `Shape Y` 字段。 `MINIMAL`—添加以下字段，用于描述位置以及其与地理编码结果中定位器中的信息的匹配程度：`Shape`、`Status`、`Score`、`Match_type`、`Match_addr` 和 `Addr_type`。 `MINIMAL_AND_USER`—用户自定义的字段以及 `MINIMAL` 字段也将被添加到地理编码结果中并返回。	String

派生输出

名称	说明	数据类型
out_feature_class	输出要素类。	Feature Class
out_table	采用 CSV 或 XLS 格式的输出表，具体取决于输出类型值。	Table

代码示例

GeocodeFile 示例（独立脚本）

以下 Python 脚本演示了如何在独立脚本中使用 GeocodeFile 函数。

注:

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

import arcpy

# Input is a local table
input_table = r"C:\data\customers.csv"

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

# The best way to generate a field mapping is to run the tool in ArcGIS
# Pro, right-click the green success ribbon, and click "Copy Python command"

field_mapping = "'Address or Place' Address VISIBLE NONE;Address2 <None> VISIBLE NONE;Address3 <None> VISIBLE NONE;Neighborhood <None> VISIBLE NONE;City <None> VISIBLE NONE;County <None> VISIBLE NONE;State <None> VISIBLE NONE;ZIP ZIP VISIBLE NONE;ZIP4 <None> VISIBLE NONE;Country <None> VISIBLE NONE"
output_type = "FEATURE_CLASS"

# Output folder for the output CSV, Excel, or GDB table. If you select
# FEATURE_CLASS output_type, a new GDB will be created in the
# output_folder with the geocoding results
output_folder = r"C:\data\outputs"
output_name = "Geocoding_output"

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

arcpy.geocoding.GeocodeFile(input_table, in_locator, field_mapping, output_type,
                            output_folder, output_name, country, location_type,
                            category)

环境

当前工作空间, 输出坐标系

许可信息

基本: 要求您在 ArcGIS Enterprise 中的账户具有执行分析权限
标准: 要求您在 ArcGIS Enterprise 中的账户具有执行分析权限
高级: 要求您在 ArcGIS Enterprise 中的账户具有执行分析权限

对文件进行地理编码 (地理编码工具)

汇总

用法

注:

注:

参数

注:

注:

派生输出

环境

许可信息

相关主题