裁剪定位器 (地理编码)

摘要

根据感兴趣的区域或范围裁剪定位器,并创建具有更小范围和大小的定位器。

使用情况

  • 该工具可以根据图层中的要素、图层中的选定要素或一定范围裁剪定位器。 输出为范围更小的新定位器。

  • 对目标研究区域中的地点进行地理编码时,使用此工具将定位器裁剪到该区域以减小定位器的大小并仅返回更小范围内的地理编码结果。 裁剪定位器时,定位器中索引的参考数据也将被裁剪。 搜索裁剪定位器范围之外的地址时,不会返回任何结果。

  • 剪辑 ArcGIS StreetMap Premium 定位器需要 ArcGIS StreetMap Premium许可

  • 如果输入定位器值为复合定位器,复合定位器的参与定位器将被裁剪并保存到输出位置的子文件夹中。 复合定位器将保存到输出位置。

  • 复合定位器中参与定位器的地理编码服务将不会被剪裁。

参数

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

将被剪裁的定位器(.loc 文件)。

注:

不支持作为参与定位器的地理编码服务或包含地理编码服务的复合定位器,包括来自 ArcGIS EnterpriseArcGIS Online 的服务。 如果服务是复合定位器中的参与定位器,则不会对其进行剪裁。

Address Locator
输出定位器

裁剪后的输出定位器(.loc 文件)。

Address Locator
感兴趣区域
(可选)

此面图层可定义将用于裁剪定位器的感兴趣区域。

此参数覆盖范围参数。

Feature Layer
范围
(可选)

指定将用于裁剪定位器的范围。

  • 默认 - 该范围将基于工具运行时地图的范围。 这是默认设置。
  • 当前显示范围 - 该范围将与可见显示范围相等。 当没有活动地图时,此选项不可用。 如果在指定此选项后地图发生变化,范围不会改变。
  • 如下面的指定 - 该范围将基于指定的最小和最大范围值。
  • 浏览 - 该范围将基于现有数据集。
Extent

arcpy.geocoding.ClipLocator(in_locator, out_locator, {area_of_interest}, {extent})
名称说明数据类型
in_locator

将被剪裁的定位器(.loc 文件)。

注:

不支持作为参与定位器的地理编码服务或包含地理编码服务的复合定位器,包括来自 ArcGIS EnterpriseArcGIS Online 的服务。 如果服务是复合定位器中的参与定位器,则不会对其进行剪裁。

Address Locator
out_locator

裁剪后的输出定位器(.loc 文件)。

Address Locator
area_of_interest
(可选)

此面图层可定义将用于裁剪定位器的感兴趣区域。

此参数覆盖 extent 参数。

Feature Layer
extent
(可选)

指定将用于裁剪定位器的范围。

  • DISPLAY - 该范围将与可见显示范围相等。
  • 图层名称 - 将使用指定图层的范围。
  • Extent 对象 - 将使用指定对象的范围。
  • 以空格分隔的坐标字符串 - 将使用指定字符串的范围。 坐标以 x-min,y-min,x-max,y-max 的顺序表示。
Extent

代码示例

ClipLocator 示例 1(独立脚本)

使用县面裁剪 USA 定位器。

import arcpy

usa_locator = r"C:\Data\USA.loc"
my_clipped_locator = r"C:\Data\SanDiego.loc"
my_san_diego_polygon_layer = r"C:\Data\SanDiegoCounty.shp"

# Run ClipLocator
arcpy.geocoding.ClipLocator(usa_locator, my_clipped_locator, my_san_diego_polygon_layer)
ClipLocator 示例 2(独立脚本)

使用范围裁剪 USA 定位器。

import arcpy

usa_locator = r"C:\Data\USA.loc"
my_clipped_locator = r"C:\Data\SanDiego.loc"

# Define the extent using an arcpy Extent object
my_san_diego_extent = arcpy.Extent(
    -13115569.084655, 3826591.24577018, -12897364.810527, 3969918.09780486, 
    spatial_reference=arcpy.SpatialReference('WGS 1984 Web Mercator (auxiliary sphere)'))

# Run ClipLocator
arcpy.geocoding.ClipLocator(usa_locator, my_clipped_locator, None, my_san_diego_extent)

环境

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