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.
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 unir 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 unir 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
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.
| 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.
Los estilos del localizador personalizado o estilos del localizador proporcionados por terceros pueden definir un conjunto de roles diferentes para los datasets de referencia. | 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:
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.
| Boolean |
Muestra de código
Ejemplo de CreateAddressLocator (script independiente)
En el siguiente script de Python se muestra 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
Información sobre licencias
- Basic: Sí
- Standard: Sí
- Advanced: Sí