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 de 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.

  • Los localizadores creados con esta herramienta admiten búsquedas globales de coordenadas (latitud/longitud, MGRS, DD o USNG). Se debe incluir al menos una entidad en los datos de referencia primarios utilizados para crear el localizador. La compatibilidad con la búsqueda de coordenadas se deshabilita o habilita en Categorías que se admitirán, en la página Opciones de geocodificación del cuadro de diálogo Propiedades del localizador del localizador.

  • Se pueden proporcionar y agregar al localizador campos adicionales de los datos de referencia como campos de salida personalizados cuando se crea el localizador. Estos campos se utilizan para proporcionar información adicional sobre los candidatos del resultado de la geocodificación. Por ejemplo, si desea saber a qué bloque censal o distrito de bomberos está asociada una boca de riego, puede geocodificar el Id. de la boca de riego y unir espacialmente los atributos del bloque censal o distrito de bomberos al resultado de la geocodificación. Al unir espacialmente los atributos de las capas con la información adicional a los datos de referencia utilizados para crear el localizador, puede especificar los campos unidos como campos de salida personalizados definidos por el usuario al crear el localizador. El resultado de la geocodificación incluirá los campos de salida personalizados y sus valores.

  • 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.

  • Para generar la sintaxis de Python correcta, ejecute primero la herramienta desde el panel Geoprocesamiento con las opciones de parámetros apropiadas. A continuación, abra el menú Ejecutar y elija la opción Copiar comando de Python.

  • Puede crear localizadores utilizando clases de entidad de puntos sensibles a valores z como datos de referencia primarios. Las entidades sensibles a valores z deben crearse en una elevación absoluta para que los resultados de la geocodificación se muestren en la elevación esperada en el mapa.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

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
Campos de búsqueda

Asigna el campo de datos de referencia al campo utilizado para buscar en el valor del parámetro Entidades de entrada. Los campos con un asterisco (*) al lado del nombre son obligatorios. El campo seleccionado se indexará y utilizará para la búsqueda.

Field Info
Localizador de salida

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
Campos de localizador adicionales
(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.

Field Info
Campos de salida personalizados
(Opcional)

Añade campos de salida definidos por el usuario al localizador. Los valores especificados para este parámetro definen los nombres de los campos de salida personalizados que se devuelven en el resultado de geocodificación; sin embargo, cada nuevo campo debe asignarse a un campo en los datos de referencia. El número máximo permitido de campos admitido en el localizador es 50.

Realice lo siguiente para agregar campos de salida personalizados al localizador para usarlos en el resultado de geocodificación:

  • Escriba los nombres de los campos de salida personalizados. Los nombres de los campos de salida personalizados se agregan a la asignación de campos.
  • Seleccione el campo de los datos de referencia que contenga los valores adicionales que desea incluir en la salida de geocodificación.
String

arcpy.geocoding.CreateFeatureLocator(in_features, search_fields, output_locator, {locator_fields}, {custom_output_fields})
NombreExplicació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 valor del 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
custom_output_fields
[custom_output_fields,...]
(Opcional)

Añade campos de salida definidos por el usuario al localizador. Los valores especificados para este parámetro definen los nombres de los campos de salida personalizados que se devuelven en el resultado de geocodificación; sin embargo, cada nuevo campo debe asignarse a un campo en los datos de referencia. El número máximo permitido de campos admitido en el localizador es 50.

Nota:

Primero se deben incluir los nombres de los campos de salida personalizados en el parámetro field_mapping y, a continuación, se deben enumerar los nombres en el parámetro custom_output_fields.

String

Muestra de código

Ejemplo 1 de CreateFeatureLocator (script independiente)

La siguiente secuencia de comandos Pythonindependiente muestra cómo utilizar la función CreateFeatureLocator en una secuencia de comandos 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"

# Run CreateFeatureLocator
arcpy.geocoding.CreateFeatureLocator(in_features, search_field, output_locator, 
                                     locator_fields)
Ejemplo 2 de CreateFeatureLocator (script independiente)

La siguiente secuencia de comandos Pythonindependiente muestra cómo utilizar la función CreateFeatureLocator en una secuencia de comandos 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)