Recortar localizador (Geocodificación)

Resumen

Recorta un localizador basado en un área de interés o extensión y crea un localizador con una extensión y tamaño menores.

Uso

  • Esta herramienta puede recortar un localizador basado en entidades de una capa, en entidades seleccionadas de una capa o en una extensión. El resultado es un nuevo localizador con una extensión menor.

  • Cuando geocodifique lugares en un área de estudio específica, utilice esta herramienta para recortar el localizador a esa área a fin de reducir el tamaño del localizador y devolver únicamente resultados de geocodificación dentro de la extensión más pequeña. Cuando se recorta el localizador, los datos de referencia indexados en el localizador también se recortarán. No se obtendrán resultados cuando se busquen direcciones fuera de la extensión del localizador recortado.

  • Se necesita una licencia de ArcGIS StreetMap Premium para recortar localizadores de ArcGIS StreetMap Premium.

  • Si el valor de Localizador de entrada es un localizador compuesto, los localizadores participantes de un localizador compuesto se recortarán y se guardarán en una subcarpeta de la localización de salida. El localizador compuesto se guardará en la ubicación de salida.

  • Los servicios de geocodigo que sean localizadores participantes en un localizador compuesto no se recortarán.

Parámetros

EtiquetaExplicaciónTipo de datos
Localizador de entrada

Localizador (archivo .loc) que se recortará.

Nota:

No se admiten como localizadores participantes los servicios de geocodificación ni localizadores compuestos que contengan servicios de geocodificación, incluidos servicios de ArcGIS Enterprise o ArcGIS Online. Si el servicio es un localizador participante en un localizador compuesto, no se recortará.

Address Locator
Localizador de salida

Localizador de salida (archivo .loc) recortado.

Address Locator
Área de interés
(Opcional)

Capa de polígono que define un área de interés que se utilizará para recortar el localizador.

Este parámetro invalida el parámetro Extensión.

Feature Layer
Extensión
(Opcional)

Especifica la extensión que se utilizará para recortar el localizador.

  • Predeterminada: la extensión se basará en la extensión del mapa en el momento de ejecutar la herramienta. Esta es la opción predeterminada.
  • Extensión de visualización actual: la extensión será igual a la visualización actual. Esta opción no está disponible si no hay ningún mapa activo. La extensión no cambia si el mapa cambia tras especificar esta opción.
  • Como se especifica en la parte inferior: la extensión se basará en los valores mínimo y máximo de extensión que se especifiquen.
  • Examinar: la extensión se basará en un dataset existente.
Extent

arcpy.geocoding.ClipLocator(in_locator, out_locator, {area_of_interest}, {extent})
NombreExplicaciónTipo de datos
in_locator

Localizador (archivo .loc) que se recortará.

Nota:

No se admiten como localizadores participantes los servicios de geocodificación ni localizadores compuestos que contengan servicios de geocodificación, incluidos servicios de ArcGIS Enterprise o ArcGIS Online. Si el servicio es un localizador participante en un localizador compuesto, no se recortará.

Address Locator
out_locator

Localizador de salida (archivo .loc) recortado.

Address Locator
area_of_interest
(Opcional)

Capa de polígono que define un área de interés que se utilizará para recortar el localizador.

Este parámetro invalida el parámetro extent.

Feature Layer
extent
(Opcional)

Especifica la extensión que se utilizará para recortar el localizador.

  • DISPLAY: la extensión será igual a la visualización actual.
  • Nombre de capa: se utilizará la extensión de la capa especificada.
  • Objeto de Extent: se utilizará la extensión del objeto especificado.
  • Cadena de coordenadas delimitada por espacios: se utilizará la extensión de la cadena especificada. Las coordenadas se expresan como x-min, y-min, x-max, y-max.
Extent

Muestra de código

Ejemplo 1 de ClipLocator (script independiente)

Recortar un localizador de Estados Unidos mediante un polígono de país.

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)
Ejemplo 2 de ClipLocator (script independiente)

Recortar un localizador de Estados Unidos mediante una extensión.

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)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.