Crear localizador de direcciones (Geocodificación)

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:

Esta herramienta ha quedado obsoleta. Esta función se ha reemplazado por la herramienta Crear localizador.

Uso

  • Los localizadores de direcciones se pueden crear en una carpeta de archivos que se especifique. En ArcGIS Pro, los localizadores se deben almacenar en una carpeta de archivos, no en una geodatabase.

  • El rol de un dataset de referencia define su uso como datos de referencia para el localizador de direcciones. Los estilos del localizador de direcciones que se proporcionan con ArcGIS Pro utilizan los siguientes valores para describir los roles de los 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 de alias: define una tabla de alias de nombres de lugares que contiene nombres de lugares y direcciones reales para los nombres. Los usuarios pueden encontrar la ubicación con el nombre del lugar (por ejemplo, Field Museum), o con la dirección (por ejemplo, 1400 S Lakeshore Drive Chicago, IL 60605). Esta tabla es opcional.
  • Las tablas y clases de entidad representadas como servicios no son tipos de datos compatibles para usarlos como datos de referencia.

  • 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 compuestos no se pueden crear mediante esta herramienta. Utilice la herramienta Crear localizador de direcciones compuesto para crear un localizador compuesto.

Sintaxis

arcpy.geocoding.CreateAddressLocator(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.

  • US Address-Dual Ranges: usar cuando los datos de referencia sean una clase de entidad de línea que contiene rangos de números de casas a ambos lados de un segmento postal y usted desee buscar una dirección en un lado específico de la calle o intersección.
  • US Address-One Range: usar cuando los datos de referencia sean una clase de entidad de línea con un rango de números de casas a cada lado del segmento de carretera y usted desee buscar una dirección (en la que no se necesita el lado) o una intersección.
  • US Address-Single House: usar cuando los datos de referencia sean una clase de entidad poligonal o de puntos en la que cada entidad represente una sola dirección y usted desee buscar la dirección exacta de una parcela, edificio o punto de dirección.
  • US Address-Single House Subadress: usar cuando los datos de referencia sean una clase de entidad poligonal o de puntos en la que cada entidad represente una sola dirección con elementos de subdirección opcionales y usted desee buscar bloques de apartamentos, viviendas adosadas, dúplex o tiendas de un centro comercial.
  • US Address-Street Name: usar cuando los datos de referencia sean una clase de entidad de línea y usted desee buscar direcciones solo con el nombre de la calle. La información del rango de direcciones no es necesaria.
  • US Address-City State: usar cuando los datos de referencia sean una clase de entidad poligonal o de puntos y usted desee buscar una ciudad en concreto en un estado.
  • US Address-ZIP 5 Digit: usar cuando los datos de referencia sean una clase de entidad poligonal o de puntos en la que cada entidad represente centroide de código postal o área geográfica y usted desee buscar la ubicación de un código postal específico.
  • General-Gazetteer: usar cuando los datos de referencia sean una clase de entidad poligonal o de puntos en la que cada entidad represente una entidad única y usted desee 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 tablas y clases de entidad de datos de referencia, junto con sus roles, que el localizador de direcciones utilizará.

  • Primary table: define la clase de entidad del dataset de referencia primario para un localizador, como una clase de entidad de línea de centro de calle. Esta es una tabla obligatoria.
  • Alternate City Name table: 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.
  • Alternate Name table: 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.
  • Alias table: define una tabla de alias de nombres de lugares que contiene nombres de lugares y direcciones reales para los nombres. Los usuarios pueden encontrar la ubicación con el nombre del lugar (por ejemplo, Field Museum), o con la dirección (por ejemplo, 1400 S Lakeshore Drive Chicago, IL 60605). Esta tabla es opcional.

Las tablas y clases de entidad representadas como servicios no son tipos de datos compatibles para usarlos como datos de referencia.

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

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 de este parámetro está en el siguiente formato:

# <locator field alias> <dataset field name>
# This shows as an example:
reference_data_field_map = """
"'Feature ID' FeatureID;'*From Left' L_F_ADD;
'*To Left' L_T_ADD;'*From Right' R_F_ADD;
'*To Right' R_T_ADD;'Prefix Direction' PREFIX;
'Prefix Type' PRE_TYPE;'*Street Name' NAME;
'Suffix Type' TYPE;'Suffix Direction' SUFFIX;
'Left City or Place' CITYL;'Right City or Place' 
CITYR;'Left ZIP Code' ZIPL;'Right ZIP Code' 
ZIPR;'Left State' State_Abbr;'Right State' State_Abbr"
"""

donde <locator field alias> es el nombre del alias para el campo de datos de referencia que utiliza el localizador de direcciones y <dataset field name> 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.

Si decide no asignar un campo de datos de referencia opcional que utiliza el estilo de localizador de direcciones a un campo de un dataset de referencia, especifique que no hay ninguna asignación usando <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 la herramienta Crear un localizador de direcciones y elija el estilo del localizador. El nombre que aparece en la columna Nombre de campo del parámetro Mapa de campo es el nombre de alias del campo.

Field Info
out_address_locator

El localizador que se creará en una carpeta de archivos. 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)

Este parámetro no tiene ningún efecto en ArcGIS Pro. Se conserva para permitir la compatibilidad con versiones anteriores.

String
enable_suggestions
(Opcional)

Especifica si se generarán sugerencias para autocompletar carácter por carácter las entradas de usuario en una aplicación cliente. Esta funcionalidad 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 coincidencia sugerida. La idea es que una aplicación cliente pueda proporcionar una lista de sugerencias que se actualice con cada carácter introducido por un usuario hasta que el lugar que está buscando aparezca en la lista.

Solo los estilos de localizador proporcionados por Esri se pueden usar para generar localizadores con las sugerencias habilitadas. La funcionalidad de sugerencia solo se expone cuando el localizador se comparte con el portal.

  • ENABLEDLas sugerencias se habilitan para el localizador.
  • DISABLEDLas sugerencias no se habilitan para el localizador. Esta es la opción predeterminada.
Boolean

Muestra de código

Ejemplo de CreateAddressLocator (ventana de Python)

El siguiente script 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 file folder.
# Import system modules
import arcpy
arcpy.env.workspace = "C:/ArcTutor/Geocoding/atlanta"
arcpy.CreateAddressLocator_geocoding("US Address - Dual Ranges", "streets.shp 'Primary table'", "'Feature ID' FID;'*From Left' L_F_ADD;'*To Left' L_T_ADD;'*From Right' R_F_ADD;'*To Right' R_T_ADD;'Prefix Direction' PREFIX;'Prefix Type' PRE_TYPE;'*Street Name' NAME;'Suffix Type' TYPE;'Suffix Direction' SUFFIX;'Left City or Place' CITYL;'Right City or Place' CITYR;'Left ZIP Code' ZIPL;'Right ZIP Code' ZIPR;'Left State' State_Abbr;'Right State' State_Abbr", "Atlanta_AddressLocator", "", "DISABLED")

Información de licenciamiento

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

Temas relacionados