描述
基于要素类中的点位置创建地址。在反向地理编码过程中,根据指定的搜索距离搜索点位置的最近地址或交叉点。使用 ArcGIS World Geocoding Service 时,此操作可能会消耗配额。
使用 ArcGIS World Geocoding Service 执行地理编码操作需要 ArcGIS Online 组织订阅并需要消耗配额。组织帐户必须具有足够的配额,才能完成整个地理编码请求。
使用方法
输入要素类必须包含具有有效 x,y 坐标的点形状。对于包含空坐标的点,将不返回地址。
输出要素类将包含与输入要素类相同的记录数。其他包含结果地址的字段将被添加到要素类中。字段名以 REV_ 作为前缀。如果找不到某个地址,字段将包含空值。
如果输入要素类的空间参考与地址定位器不同,则地址定位器将动态转换坐标并尝试找到匹配项。输出要素类将保存在与输入要素类相同的空间参考中。要更改输出要素类的空间参考,请在工具的环境设置中设置其他输出坐标系。
如果输入要素类中的某个点无法返回地址,则表明地址定位器中不存在任何可与输入点关联的要素。以下是导致不匹配点的常见原因:
- 搜索距离过小,点无法查找到任何最近的要素。
- 点包含空坐标。
- 点的坐标不正确并且无法转换为地址定位器中使用的空间参考。
- 地址定位器的相应区域内不包含可与点关联的参考要素。
您可以增加搜索距离以提高找到最近地址的几率,或者使用包含更多要素或覆盖更大区域的其他地址定位器以与输入点匹配。
使用 ArcGIS World Geocoding Service 对某要素类进行反向地理编码时,需要 ArcGIS Online for organizations 订阅。
语法
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 | 输出要素类。 | Feature Class |
address_type (可选) | 指定是将点的地址以街道地址的形式返回,还是以交叉点地址的形式返回(如果定位器支持交叉点匹配)。 旧版本:此参数仅适用于使用创建地址定位器工具构建的定位器,或包含使用创建地址定位器工具构建的定位器的复合定位器。
| String |
search_distance | 搜索点位置的最近地址或交叉点时所用的距离。某些定位器使用不支持覆盖搜索距离参数的优化距离值。使用创建地址定位器工具创建的定位器的默认搜索距离为 100 米。 | Linear Unit |
feature_type [feature_type,...] (可选) | 指定返回的可能匹配类型。可选择单个值或多个值。如果选择单个值,则输入要素类型的搜索容差为 500 米。如果包括多个值,则将应用要素类型等级表中指定的默认搜索距离。有关 reverseGeocode 的 featureTypes 参数的更多详细信息,请参阅 REST API Web 帮助。 此参数不受所有定位器支持。
| String |
location_type (可选) | 用于指定 POINT_ADDRESS 匹配的首选输出几何。此参数的选项是 ROUTING_LOCATION(街道位置的一侧,可用于路径),或 ADDRESS_LOCATION(表示屋顶、地址的宗地质心或前门的位置)。如果数据中不存在首选位置,则会返回 ROUTING_LOCATION 的默认位置。对于 Addr_type = "PointAddress" 的地理编码结果,x,y 属性值用于描述沿着街道的地址的坐标,而 DisplayX 和 DisplayY 值用于描述屋顶或建筑物质心坐标。有关 reverseGeocode 的 locationType 参数的更多详细信息,请参阅 REST API Web 帮助。 此参数不受所有定位器支持。
| String |
代码示例
以下 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"
result_feature_class = "customers_with_address"
arcpy.ReverseGeocode_geocoding(input_feature_class, address_locator,
result_feature_class, "ADDRESS", "100 Meters")
以下 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"
search_distance = "0 Unknown"
feature_type = "STREET_INTERSECTION;STREET_ADDRESS"
location_type = "ROUTING_LOCATION"
# Execuste ReverseGeocode
arcpy.geocoding.ReverseGeocode(input_features, locator, reverse_output,
addr_type, search_distance, feature_type,
location_type)
环境
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是