反向地理编码 (地理编码工具)

汇总

基于要素类中的点位置创建地址。在反向地理编码过程中，根据使用创建定位器工具创建的定位器的优化距离值来搜索点位置的最近地址、地点或交叉点。

使用 ArcGIS World Geocoding Service 执行地理编码操作需要 ArcGIS 组织账户，还需使用配额。组织账户必须具有足够的配额，才能完成整个地理编码请求。

注:

当活动门户为 ArcGIS Online 且输入定位器为 ArcGIS World Geocoding Service 时，工具顶部提供配额估算功能。

用法

输入要素类必须包含具有有效 x,y 坐标的点形状。对于包含空坐标的点，将不返回结果。
输出要素类将包含与输入要素类相同的记录数。其他包含结果地址或地点的字段将被添加到要素类中。字段名以 REV_ 作为前缀。如果找不到某个匹配的地点或地址，字段将包含 NULL 值。
如果输入要素类的空间参考与定位器的空间参考不同，则定位器将动态转换坐标并尝试找到匹配项。输出要素类将保存在与输入要素类相同的空间参考中。要更改输出要素类的空间参考，请设置输出坐标系环境。
如果输入要素类中的某个点无法返回匹配的地点或地址，则表明定位器中不存在任何可与输入点关联的要素。以下是导致不匹配点的常见原因：
- 点包含空坐标。
- 点的坐标不正确并且无法转换为定位器中使用的空间参考。
- 定位器的相应区域内不包含可与点关联的参考要素。
- 系统已指定在合理距离内没有良好匹配项的要素类型。有关详细信息，请参阅要素类型匹配条件。
当在定位器属性中指定反向距离时，该设置将覆盖基于定位器支持的角色所使用的优化分层距离值。
若要使用 ArcGIS World Geocoding Service 对要素类进行反向地理编码，需要 ArcGIS Online 组织订阅。
当使用使用 z 感知数据构建的输入定位器时，该工具将返回非 z 感知的输出。该工具仅支持 2D 输出。

标注	说明	数据类型
输入要素类或图层	将根据要素的点位置从中返回匹配的地点或地址的点要素类或图层。	Feature Layer
输入地址定位器	将用于对输入要素类或图层进行反向地理编码的定位器。	Address Locator
输出要素类	输出要素类。注: 由于 shapefile 限制，系统不支持将输出保存为 shapefile 格式。	Feature Class
输出地址类型（可选）	旧版本：此参数已弃用，并将仅针对向后兼容性进行维护。默认情况下，将使用定位器支持的要素类型。	String
搜索距离（可选）	旧版本：此参数已弃用，并将仅针对向后兼容性进行维护。默认情况下，将根据定位器支持的角色使用优化的分层距离值，并且其不能被覆盖。	Linear Unit
要素类型（可选）	指定将返回的可能匹配类型。可指定单个值或多个值。如果指定单个值，则输入要素类型的搜索容差为 500 米。如果包括多个值，则将应用要素类型等级表中指定的默认搜索距离。有关将此参数用于反向地理编码的详细信息，请参阅要素类型。此参数不受所有定位器支持。子地址—匹配将限于街道地址（基于代表房屋和建筑物子地址位置的点）。如果作为服务发布，则此选项需要在 ArcGIS Pro 2.8 或更高版本中创建的定位器，并且需要 ArcGIS Enterprise 10.9 或更高版本。点地址—匹配将限于街道地址（基于代表房屋和建筑物位置的点）。宗地—匹配将限于被视为不动产并且可包括一个或多个房屋或其他建筑物的一片土地。该选项通常会为其分配一个地址和宗地标识号。此选项仅受使用“宗地”角色构建的自定义定位器支持；ArcGIS World Geocoding Service 或 ArcGIS StreetMap Premium 定位器不支持。街道地址—匹配将限于与点地址不同的街道地址，因为门牌号是由数字范围内插的。街道地址匹配包括匹配街段的门牌号范围，而不包括内插的门牌号值。街道交叉点—匹配将限于包括街道交叉点和城市以及州和邮政编码信息（可选信息）的街道地址。这是从街道地址参考数据中获取的，例如 Redlands Blvd & New York St, Redlands, CA, 92373。街道名称—匹配将限于类似于街道地址，但没有门牌号，且包含行政区域和邮政编码（可选）的街道地址，例如 W Olive Ave, Redlands, CA, 92373。地点—匹配将限于代表居民区的地名。邮政地址—匹配将限于邮政编码。参考数据是邮政编码点，例如 90210 USA。感兴趣点—匹配将限于感兴趣点。参考数据包括行政区域、地名、企业、地标和地理要素，例如星巴克。距离标记—匹配将限于表示沿某条街道的线性距离的街道地址（通常以公里或英里为单位，且指定了原点位置，如 Mile 25 I-5 N, San Diego, CA）。	String
首选位置类型（可选）	用于指定将返回的 `PointAddress` 匹配的首选输出几何。如果数据中不存在首选位置，则会返回地址位置的默认位置。有关 `geocodeAddresses` 的 `locationType` 参数的详细信息，请参阅 ArcGIS REST API Web 帮助。地址位置—将返回地理编码结果的几何，该几何可以表示地址位置，例如屋顶位置、宗地质心或前门。这是默认设置。路径位置—将返回表示靠近街道一侧（可用于车辆配送）的位置的地理编码结果的几何。	String

arcpy.geocoding.ReverseGeocode(in_features, in_address_locator, out_feature_class, {address_type}, {search_distance}, {feature_type}, {location_type})

名称	说明	数据类型
in_features	将根据要素的点位置从中返回匹配的地点或地址的点要素类或图层。	Feature Layer
in_address_locator	将用于对输入要素类或图层进行反向地理编码的定位器。	Address Locator
out_feature_class	输出要素类。注: 由于 shapefile 限制，系统不支持将输出保存为 shapefile 格式。	Feature Class
address_type （可选）	旧版本：此参数已弃用，并将仅针对向后兼容性进行维护。默认情况下，将使用定位器支持的要素类型。	String
search_distance （可选）	旧版本：此参数已弃用，并将仅针对向后兼容性进行维护。默认情况下，将根据定位器支持的角色使用优化的分层距离值，并且其不能被覆盖。	Linear Unit
feature_type [feature_type,...] （可选）	指定将返回的可能匹配类型。可指定单个值或多个值。如果指定单个值，则输入要素类型的搜索容差为 500 米。如果包括多个值，则将应用要素类型等级表中指定的默认搜索距离。有关将此参数用于反向地理编码的详细信息，请参阅要素类型。此参数不受所有定位器支持。 `SUBADDRESS`—匹配将限于街道地址（基于代表房屋和建筑物子地址位置的点）。如果作为服务发布，则此选项需要在 ArcGIS Pro 2.8 或更高版本中创建的定位器，并且需要 ArcGIS Enterprise 10.9 或更高版本。 `POINT_ADDRESS`—匹配将限于街道地址（基于代表房屋和建筑物位置的点）。 `PARCEL`—匹配将限于被视为不动产并且可包括一个或多个房屋或其他建筑物的一片土地。该选项通常会为其分配一个地址和宗地标识号。此选项仅受使用“宗地”角色构建的自定义定位器支持；ArcGIS World Geocoding Service 或 ArcGIS StreetMap Premium 定位器不支持。 `STREET_ADDRESS`—匹配将限于与 `POINT_ADDRESS` 不同的街道地址，因为门牌号是由数字范围内插的。 `STREET_ADDRESS` 匹配包括匹配街段的门牌号范围，而不包括内插的门牌号值。 `STREET_INTERSECTION`—匹配将限于包括街道交叉点和城市以及州和邮政编码信息（可选信息）的街道地址。这是从 `STREET_ADDRESS` 参考数据中获取的，例如 Redlands Blvd & New York St, Redlands, CA, 92373。 `STREET_NAME`—匹配将限于类似于 `STREET_ADDRESS`，但没有门牌号，且包含行政区域和邮政编码（可选）的街道地址，例如 W Olive Ave, Redlands, CA, 92373。 `LOCALITY`—匹配将限于代表居民区的地名。 `POSTAL`—匹配将限于邮政编码。参考数据是邮政编码点，例如 90210 USA。 `POINT_OF_INTEREST`—匹配将限于感兴趣点。参考数据包括行政区域、地名、企业、地标和地理要素，例如星巴克。 `DISTANCE_MARKER`—匹配将限于表示沿某条街道的线性距离的街道地址（通常以公里或英里为单位，且指定了原点位置，如 Mile 25 I-5 N, San Diego, CA）。	String
location_type （可选）	用于指定将返回的 `PointAddress` 匹配的首选输出几何。如果数据中不存在首选位置，则会返回 `ADDRESS_LOCATION` 的默认位置。有关 `geocodeAddresses` 的 `locationType` 参数的详细信息，请参阅 ArcGIS REST API Web 帮助。 `ADDRESS_LOCATION`—将返回地理编码结果的几何，该几何可以表示地址位置，例如屋顶位置、宗地质心或前门。这是默认设置。 `ROUTING_LOCATION`—将返回表示靠近街道一侧（可用于车辆配送）的位置的地理编码结果的几何。	String

代码示例

ReverseGeocode 示例 1（Python 窗口）

以下 Python 窗口脚本演示了如何在即时模式下使用 ReverseGeocode 函数。

import arcpy

arcpy.env.workspace = "C:/data/locations.gdb"

# Set local variables:
input_feature_class = "customers"
address_locator = "e:/StreetMap/data/Street_Addresses_US.loc"
result_feature_class = "customers_with_address"

arcpy.geocoding.ReverseGeocode(input_feature_class, address_locator,
                               result_feature_class, "ADDRESS")

ReverseGeocode 示例 2（独立脚本）

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

# Description:
# Reverse Geocode customer point locations using a locator created with
# the Create Locator tool.

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "c:/data/Atlanta.gdb"

# Set local variables
input_features = "MyCustomers"
locator = "c:/data/Atlanta/Atlanta_StreetAddress.loc"
reverse_output = "MyCustomers_Reverse_Streets"
addr_type = "ADDRESS"
feature_type = "STREET_INTERSECTION;STREET_ADDRESS"
location_type = "ROUTING_LOCATION"

# Run ReverseGeocode
arcpy.geocoding.ReverseGeocode(input_features, locator, reverse_output,
                               addr_type, None, feature_type, location_type)

ReverseGeocode 示例 3（独立脚本）

以下 Python 脚本演示了如何在独立 Python 脚本中使用 ArcGIS World Geocoding Service 的 ReverseGeocode 函数。

注:

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

# Description:
# Reverse Geocode customer point locations using the ArcGIS World Geocoding Service.

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "c:/data/Atlanta.gdb"

# Set local variables
input_features = "MyCustomers"
locator = "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer/ArcGIS World Geocoding Service"
reverse_output = "MyCustomers_Reverse_Streets"
addr_type = "ADDRESS"
feature_type = "STREET_INTERSECTION;STREET_ADDRESS"
location_type = "ROUTING_LOCATION"

# Run ReverseGeocode
arcpy.geocoding.ReverseGeocode(input_features, locator, reverse_output,
                               addr_type, None, feature_type, location_type)

环境

输出坐标系

许可信息

基本: 是
标准: 是
高级: 是

反向地理编码 (地理编码工具)

汇总

注:

用法

参数

注:

旧版本：

旧版本：

环境

许可信息

相关主题