Crear localizador de entidades (Geocodificación)

Resumen

Crea un localizador con datos de referencia que contiene un nombre o valor único para cada entidad que se almacena en un único campo. Un localizador creado con esta herramienta ofrece gran variedad de aplicaciones. Se puede utilizar para buscar nombres o atributos únicos en sus entidades, como contadores de agua, nombres cortos de lugares, torres de telefonía móvil o cadenas alfanuméricas que se utilizan para identificar ubicaciones (por ejemplo, N1N115).

Los localizadores que cree esta herramienta utilizarán los valores indexados en un único campo para buscar valores en dicho campo único y devolverlos como un conjunto de puntos, o bien identificar entidades cerca de una ubicación de punto. Las tablas de direcciones que pueden geocodificarse con un localizador creado con esta herramienta también deben contener un único campo con el mismo nombre o valor único que se utilice para identificar las ubicaciones.

Nota:

Los localizadores creados con esta herramienta se pueden utilizar en ArcGIS Pro 2.5 o versiones posteriores, Enterprise 10.8 o versiones posteriores y como un servicio de localizador en ArcMap. Los localizadores creados con esta herramienta no se pueden utilizar como un localizador local en ArcMap.

Uso

  • Las clases de entidad representadas como servicios son tipos de datos compatibles para usarlos como datos de referencia.

  • La herramienta admite clases de entidad que contienen geometría de polígonos y puntos como datos de referencia.

  • Es posible utilizar un localizador creado con esta herramienta para buscar identificadores únicos o valores cortos de cadena de caracteres que no superen las cinco palabras.

  • La salida de esta herramienta se puede usar como entrada de la herramienta Crear localizador de direcciones compuesto. Sin embargo, la combinación de un localizador creado con esta herramienta con otros localizadores basados en la función de dirección en un localizador compuesto se debe tratar con precaución, ya que la asignación de campos del campo de rol de localizador de entidades Nombre puede dar lugar a un comportamiento inesperado. La práctica recomendada es usar un localizador creado con la herramienta Crear localizador basado en su lugar en el rol POI.

Sintaxis

arcpy.geocoding.CreateFeatureLocator(in_features, search_fields, output_locator, {locator_fields})
ParámetroExplicaciónTipo de datos
in_features

La clase de entidad o capa de entidades de los datos de referencia que se utilizará para crear el localizador.

Las clases de entidad representadas como servicios son tipos de datos compatibles para usarlos como datos de referencia.

Precaución:

Cuando se define una consulta de definición para los datos de referencia o existen entidades seleccionadas, solo se incluyen las entidades consultadas y seleccionadas cuando se crea el localizador.

Nota:

Al crear un localizador con datos de referencia que contienen millones de entidades, debe disponer al menos de 3 a 4 veces el tamaño de los datos en espacio libre en disco en la unidad que contiene el directorio temporal, ya que los archivos utilizados para construir el localizador se escriben en esta ubicación antes de que el localizador se copie en la ubicación de salida. Si no se dispone de suficiente espacio en disco, la herramienta fallará cuando se quede sin espacio. Además, al crear localizadores grandes, su equipo debe tener RAM suficiente para manejar grandes procesos que requieren mucha memoria.

Feature Layer
search_fields

Asigna el campo de datos de referencia al campo utilizado para buscar en el parámetro in_features. La representación cartográfica de search_fields se realiza con el siguiente formato, donde <locator field name> es el nombre del campo que admite el rol de localizador y <data field name> es el nombre del campo que se utiliza para buscar en el parámetro in_features.

# <locator field name> <data field name>
# This shows an example:
reference_data_field_map = """
"'Name' AssetName"
"""

El campo seleccionado se indexará y utilizará para la búsqueda. Asigne el campo relevante para los datos de referencia en el parámetro in_features.

Field Info
output_locator

El archivo de localizador de salida que se creará en una carpeta de archivos. Cuando se crea un localizador, las opciones y propiedades adicionales se pueden modificar en la configuración del localizador.

Address Locator
locator_fields
(Opcional)

Asigna campos adicionales por extensión y clasificación si existen en los datos. El campo Rank se utiliza para ordenar resultados para consultas ambiguas o candidatos con el mismo nombre y puntuación. Los campos de extensión ayudan a definir la extensión de mapa para visualizar resultados geocodificados. La representación cartográfica locator_fields se realiza con este formato:

# <additional locator field name> <additional data field name>
# This shows an example:
additional_fields_map = """
"'Rank' RANK;'Min X' Xmin;
'Max X' Xmax;'Min Y' Ymin;
'Max Y' Ymax"
"""

El campo <additional locator field name> es el nombre de los campos adicionales que admite el localizador y el campo <additional data field name> es el nombre del campo en el parámetro in_features. Asigne los campos relevantes para los datos de referencia en el parámetro in_features.

Field Info

Muestra de código

Ejemplo 1 de CreateFeatureLocator (script independiente)

El siguiente script de Python muestra cómo utilizar la función CreateFeatureLocator en un script independiente.

# Description: Create a feature locator using local data.
# Import system modules
import arcpy
# Set local variables
in_features = r"C:\data\arizona.gdb\az_points"
search_field = "*Name NAME VISIBLE NONE"
output_locator = r"C:\output\locators\az_points_locator"
locator_fields = "Rank <None> VISIBLE NONE;'Min X' <None> VISIBLE NONE;'Max X' <None> VISIBLE NONE;'Min Y' <None> VISIBLE NONE;'Max Y' <None> VISIBLE NONE"
# Execute CreateFeatureLocator
arcpy.geocoding.CreateFeatureLocator(in_features, search_field, output_locator, 
                                     locator_fields)
Ejemplo 2 de CreateFeatureLocator (script independiente)

El siguiente script de Python muestra cómo utilizar la función CreateFeatureLocator en un script independiente.

# Description: Create a feature locator using data from a hosted feature service in ArcGIS Online.
# Import system modules
import arcpy
# Sign in to Portal
arcpy.SignInToPortal("https://www.arcgis.com", "<username>", "<password>")
# Set local variables
in_features = "https://services.arcgis.com/<layer_id>/arcgis/rest/services/<service_name>/FeatureServer/<layer_number>"
search_field = "*Name NAME VISIBLE NONE"
output_locator = r"C:\output\locators\service_locator"
locator_fields = "Rank <None> VISIBLE NONE;'Min X' <None> VISIBLE NONE;'Max X' <None> VISIBLE NONE;'Min Y' <None> VISIBLE NONE;'Max Y' <None> VISIBLE NONE"
arcpy.geocoding.CreateFeatureLocator(in_features, search_field, output_locator, 
                                     locator_fields)

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí

Temas relacionados