Crear localizador de direcciones

Resumen

Crea un localizador de direcciones. El localizador de direcciones se puede utilizar para encontrar la ubicación de una dirección, geocodificar una tabla de direcciones u obtener la dirección de la ubicación de un punto.

Heredado:

Los localizadores se deben almacenar en una carpeta de archivos para utilizar las nuevas características que no son compatibles con los localizadores almacenados en las geodatabases, como las mejoras de rendimiento, las capacidades de procesamiento múltiple y las sugerencias. ArcGIS 10.4 es la última versión que admite el almacenamiento de localizadores en las geodatabases.

Nota:

No se admite la publicación de localizadores creados con esta herramienta en ArcGIS Server 11.0 o posterior.

Más información sobre las tareas de geocodificación comunes

Uso

• Los localizadores de direcciones se pueden crear en cualquier carpeta de archivos que se especifique.

• El rol de un dataset de referencia define el rol que desempeña como datos de referencia para el localizador de direcciones. Los estilos del localizador de direcciones que se proporcionaron con ArcGIS utilizan los siguientes valores para describir los roles de datasets de referencia:

  • Tabla principal: define la clase de entidad de dataset de referencia principal para un localizador, tal como una clase de entidad de línea de centro de calle. Esta es una tabla obligatoria.
  • Tabla de nombres de ciudad alternativos: define una tabla de nombres de ciudad alternativos que contiene nombres alternativos para ciudades o lugares. Se requiere que la tabla tenga un JoinID que se pueda utilizar para unirla a la tabla principal. Esta tabla es opcional.
  • Tabla de nombre alternativo: define una tabla de nombres de calle alternativos que contiene nombres alternativos para las entidades de calle o de punto. Se requiere que la tabla tenga un JoinID que se pueda utilizar para unirla a la tabla principal. Esta tabla es opcional.
  • Tabla Alias: define una tabla de nombres alias de lugar, que contiene nombres de lugares y direcciones reales para los nombres. El usuario puede encontrar la ubicación mediante el nombre del lugar como Field Museum o la dirección 1400 S Lakeshore Drive Chicago, IL 60605. Esta tabla es opcional.

• Los estilos del localizador personalizado o estilos del localizador proporcionados por terceros pueden definir diferentes roles para las clases y tablas de entidad de datos de referencia. Consulte la documentación para obtener información sobre los roles que se definen para los datasets de referencia.

• Los localizadores de direcciones compuestos no se pueden crear mediante esta herramienta. Utilice la herramienta Crear localizador de direcciones compuesto para crear un localizador de direcciones compuesto.

Sintaxis

arcpy.geocoding.CreateAddressLocator(in_address_locator_style, in_reference_data, in_field_map, out_address_locator, {config_keyword}, {enable_suggestions})

Parámetro	Explicación	Tipo de datos
in_address_locator_style	El estilo del localizador de direcciones en el que se basa el nuevo localizador de direcciones. US Address-Dual Ranges: se usa cuando los datos de referencia son una clase de entidad de línea que contiene rangos de números de casas a ambos lados de un segmento postal y desea buscar una dirección en un lado específico de la calle o intersección. US Address-One Range: se usa cuando los datos de referencia son una clase de entidad de línea con un rango de números de casas a cada lado del segmento de carretera y desea buscar una dirección (en la que no se necesita el lado) o una intersección. US Address-Single House: se usa cuando los datos de referencia son una clase de entidad poligonal o de puntos en la que cada entidad representa una sola dirección y desea buscar la dirección exacta de una parcela, edificio o punto de dirección. US Address-Single House Subaddress: se usa cuando los datos de referencia son una clase de entidad poligonal o de puntos en la que cada entidad representa una sola dirección con elementos de subdirección opcionales y desea buscar bloques de apartamentos, viviendas adosadas, dúplex o tiendas de un centro comercial. US Address-Street Name: se usa cuando los datos de referencia son una clase de entidad de línea y desea buscar direcciones solo con el nombre de la calle. La información del rango de direcciones no es necesaria. US Address-City State: se usa cuando los datos de referencia son una clase de entidad poligonal o de puntos y desea buscar una ciudad en concreto en un estado. US Address-ZIP 5 Digit: se usa cuando los datos de referencia son una clase de entidad poligonal o de puntos en la que cada entidad representa un centroide de código postal o un área geográfica y desea buscar la ubicación de un código postal específico. General-Gazetteer: se usa cuando los datos de referencia son una clase de entidad poligonal o de puntos en la que cada entidad representa una entidad única y desea buscar el nombre de un lugar, un hito, un contador de agua u otro valor único.	Address Locator Style
in_reference_data [[Reference Data, {Role}],...]	Las clases y tablas de entidad de datos de referencia que se utilizarán por el localizador de direcciones, junto con sus roles. Tabla principal: define la clase de entidad de dataset de referencia principal para un localizador, tal como una clase de entidad de línea de centro de calle. Esta es una tabla obligatoria. Tabla de nombres de ciudad alternativos: define una tabla de nombres de ciudad alternativos que contiene nombres alternativos para ciudades o lugares. Se requiere que la tabla tenga un JoinID que se pueda utilizar para unirla a la tabla principal. Esta tabla es opcional. Tabla de nombre alternativo: define una tabla de nombres de calle alternativos que contiene nombres alternativos para las entidades de calle o de punto. Se requiere que la tabla tenga un JoinID que se pueda utilizar para unirla a la tabla principal. Esta tabla es opcional. Tabla Alias: define una tabla de nombres alias de lugar, que contiene nombres de lugares y direcciones reales para los nombres. El usuario puede encontrar la ubicación mediante el nombre del lugar como Field Museum o la dirección 1400 S Lakeshore Drive Chicago, IL 60605. Esta tabla es opcional. Los estilos del localizador personalizado o estilos del localizador proporcionados por terceros pueden definir un conjunto de roles diferentes para los datasets de referencia. Nota: Al crear un localizador de direcciones con datos de referencia que contienen millones de entidades, es necesario 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 porque 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á durante la ejecución cuando se quede sin espacio. Además, se debe tener en cuenta que al crear localizadores muy grandes se debe disponer de un equipo con RAM suficiente para manejar grandes procesos que requieren mucha memoria. También se recomienda instalar Background Geoprocessing (64 bits) y ejecutar la herramienta con geoprocesamiento en segundo plano habilitado.	Value Table
in_field_map	La asignación de los campos de datos de referencia que utiliza el estilo del localizador de direcciones para los campos en los datasets de referencia. Cada asignación de campos en este parámetro está en el formato: # <locator field alias> <dataset field name> VISIBLE NONE # This shows as an example: reference_data_field_map = """ "'Feature ID' FeatureID VISIBLE NONE;'*From Left' L_F_ADD VISIBLE NONE; '*To Left' L_T_ADD VISIBLE NONE;'*From Right' R_F_ADD VISIBLE NONE; '*To Right' R_T_ADD VISIBLE NONE;'Prefix Direction' PREFIX VISIBLE NONE; 'Prefix Type' PRE_TYPE VISIBLE NONE;'*Street Name' NAME VISIBLE NONE; 'Suffix Type' TYPE VISIBLE NONE;'Suffix Direction' SUFFIX VISIBLE NONE""" donde <alias de campo de localizador> es el nombre del alias para el campo de datos de referencia utilizado por el localizador de direcciones y <nombre de campo de dataset> es el nombre del campo en el dataset de referencia. En el estilo del localizador de direcciones, los campos con un asterisco (*) al lado del nombre son obligatorios. VISIBLE: el campo es visible; NONE: la geometría es una copia del valor original. Si decide no asignar un campo de datos de referencia opcional utilizado por el estilo del localizador de direcciones a un campo de un dataset de referencia, especifique que no hay asignación usando "<Ninguno>" en lugar de un nombre de campo.	Field Info
out_address_locator	El localizador de direcciones que se va a crear. Guardar el localizador en una carpeta de archivos le permite sacar ventaja de las mejoras de rendimiento, capacidades de procesamiento múltiple y las sugerencias. Cuando se crea un localizador, las opciones y propiedades adicionales se pueden modificar en la configuración del localizador.	Address Locator
config_keyword (Opcional)	La palabra clave de configuración que determina los parámetros de almacenamiento de la tabla en un Sistema de administración de bases de datos relacionales (RDBMS): solo geodatabases corporativas y geodatabases de archivos.	String
enable_suggestions (Opcional)	Permite generar sugerencias para autocompletar carácter por carácter las entradas realizadas por el usuario en una aplicación cliente. Esta prestación facilita la experiencia de búsqueda interactiva del usuario, ya que reduce el número de caracteres que se deben escribir antes de obtener una sugerencia coincidente. La idea es que una aplicación cliente puede proporcionar una lista de sugerencias que se actualiza con cada carácter que introduce un usuario hasta que el lugar que está buscando aparece en la lista. Solo los estilos de localizador proporcionados por Esri se pueden usar para generar localizadores con las sugerencias habilitadas. La función de sugerencia solo se expone cuando el localizador se publica como un servicio de geocodificación. Los localizadores con sugerencias activadas solo se pueden guardar en una carpeta de archivos. No se pueden guardar en una geodatabase. ENABLED —Las sugerencias se habilitan para el localizador. DISABLED —Las sugerencias se deshabilitan para el localizador. Esta es la opción predeterminada.	Boolean

Muestra de código

Ejemplo de CreateAddressLocator (script independiente)

El siguiente script de Python demuestra cómo utilizar la función CreateAddressLocator.

# Create a street address locator using a street centerline feature class 
# in a file geodatabase as reference data.
# The new address locator will be created in a separate file folder.

# Import system modules
import arcpy

arcpy.env.workspace = "C:/ArcTutor/Geocoding/atlanta.gdb"
Atlanta_AddressLocator_OutputPath = "C:/ArcTutor/Geocoding/Atlanta"

arcpy.CreateAddressLocator_geocoding("US Address - Dual Ranges", "streets 'Primary Table'", "'Feature ID' OBJECTID VISIBLE NONE;'*From Left' L_F_ADD VISIBLE NONE;'*To Left' L_T_ADD VISIBLE NONE;'*From Right' R_F_ADD VISIBLE NONE;'*To Right' R_T_ADD VISIBLE NONE;'Prefix Direction' PREFIX VISIBLE NONE;'Prefix Type' PRE_TYPE VISIBLE NONE;'*Street Name' NAME VISIBLE NONE;'Suffix Type' TYPE VISIBLE NONE;'Suffix Direction' SUFFIX VISIBLE NONE;'Left City or Place' CITYL VISIBLE NONE;'Right City or Place' CITYR VISIBLE NONE;'Left ZIP Code' ZIPL VISIBLE NONE;'Right ZIP Code' ZIPR VISIBLE NONE;'Left State' STATE_ABBR VISIBLE NONE;'Right State' STATE_ABBR VISIBLE NONE", Atlanta_AddressLocator_OutputPath, "", "DISABLED")

Entornos

• Espacio de trabajo actual
• Palabra clave CONFIG de salida
• Espacio de trabajo temporal

Información de licenciamiento

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