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 el mismo espacio de trabajo que los datos de referencia o en otro espacio de trabajo en una geodatabase o carpeta de archivos que especifique. Como práctica recomendada y para obtener un rendimiento mayor de la geocodificación, se recomienda almacenar los localizadores en una carpeta de archivos en lugar de hacerlo en una geodatabase.
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 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
CreateAddressLocator_geocoding (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 que utiliza el estilo del localizador de direcciones a un campo en un dataset de referencia, especifique que no hay asignación al utilizar "<None>" en lugar de un nombre de campo. Para determinar el nombre del alias para un campo de datos de referencia que utiliza un estilo de localizador, abra el cuadro de diálogo de la herramienta Crear un localizador de direcciones y elija el estilo del localizador. El nombre que aparece en la columna Nombre de campo del control Mapa de campo es el nombre del alias del campo. | Field Info |
out_address_locator | El localizador de direcciones que se va a crear. | 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 |
Ejemplo de código
Ejemplo de CreateAddressLocator (Ventana de Python)
La siguiente secuencia de comandos de la ventana de Python demuestra cómo utilizar la función CreateAddressLocator en el modo inmediato.
# 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 the same file geodatabase.
# Import system modules
import arcpy
from arcpy import env
env.workspace = "C:/ArcTutor/Geocoding/atlanta.gdb"
arcpy.CreateAddressLocator_geocoding("US Address - Dual Ranges", "streets Primary", "'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;'Left City or Place' CITYL VISIBLE NONE;'Right City or Place' CITYR VISIBLE NONE;'Left Zipcode' ZIPL VISIBLE NONE;'Right Zipcode' ZIPR VISIBLE NONE;'Left State' State_Abbr VISIBLE NONE;'Right State' State_Abbr VISIBLE NONE", Atlanta_AddressLocator, "", "DISABLED")
Entornos
Información sobre licencias
- ArcGIS for Desktop Basic: Sí
- ArcGIS for Desktop Standard: Sí
- ArcGIS for Desktop Advanced: Sí