Ayuda

Crear un 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.

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 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ámetroExplicaciónTipo 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.

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

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

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.

  • 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 (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 a separate file folder.
# Import system modules
import arcpy
from arcpy import env
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

  • ArcGIS Desktop Basic: Sí
  • ArcGIS Desktop Standard: Sí
  • ArcGIS Desktop Advanced: Sí