Dividir dirección en componentes (Geocodificación)

Resumen

Divide información de direcciones de calles en componentes de dirección y crea una tabla o clase de entidad con los componentes adicionales agregados como campos únicos.

Ilustración

Ilustración de la herramienta Dividir dirección en componentes

Uso

  • Los datos de direcciones de entrada pueden ser una tabla o clase de entidad que contenga atributos de direcciones de calles que se puedan analizar o dividir en componentes de direcciones de calles individuales.

  • Puede almacenar la dirección de calle de entrada para dividirla en un único campo, como StreetName o Address, que seleccione como campo de dirección de entrada en la herramienta.

  • La dirección de calle de entrada también puede estar en varios campos, por ejemplo, cuando la información del número de casa y la unidad está en campos separados. En este caso, los campos se concatenan al vuelo en el orden en que se seleccionan y la dirección de calle se divide en sus componentes.

  • No incluya información de zona (como ciudad, vecindario, subregión ni código postal) en la dirección de calle de entrada. Estos componentes no se analizarán durante el procesamiento y generarán resultados incorrectos si se incluyen.

  • El valor del parámetro Archivo de excepciones debe contener una fila para cada registro para el que desee especificar un patrón de análisis personalizado. Aplique formato al archivo para que contenga el campo de dirección de entrada (si tiene más de un campo, concatene los valores en una sola cadena de caracteres) seguidos de los componentes de dirección divididos esperados. Los nombres de campo para los componentes de dirección divididos deben coincidir con los siguientes:

    • AddNum
    • StPreDir
    • StPreType
    • StName
    • StType
    • StDir
    • UnitType
    • UnitName
    • BuildingType
    • BuildingUnit
    • LevelType
    • LevelName
    Nota:

    No todos los campos son obligatorios; solo son obligatorios los necesarios en función de la dirección personalizada cuando se dividen en componentes.

    Nota:

    Para obtener más información, descargue un ejemplo de un archivo de excepciones.

    La primera dirección del archivo, 123 South Beach Avenue, normalmente se divide en los siguientes campos:

    AddNumStPreDirStNameStType

    123

    South

    Beach

    Avenue

    Sin embargo, el archivo de excepciones creará la siguiente división personalizada:

    AddNumStNameStType

    123

    South Beach

    Avenue

  • Esta herramienta admite el procesamiento en paralelo. Si su equipo tiene varios procesadores o procesadores con varios núcleos, puede conseguir un mayor rendimiento, especialmente al dividir direcciones en los datasets mayores. Si el entorno Factor de procesamiento en paralelo no está definido (predeterminado), el procesamiento paralelo se escala en función del tamaño de la tabla y del número de núcleos lógicos. En las tablas con menos de 50 filas se utiliza un solo proceso, pero la herramienta escala el número de procesos utilizados hasta el número de procesadores lógicos de la máquina en el caso de tablas con muchas filas. Configurar el entorno a 0 desactiva el procesamiento en paralelo. Especificar un factor entre 1 y 99 hará que la herramienta identifique el porcentaje de núcleos lógicos que debe usar aplicando la fórmula (Factor de procesamiento en paralelo / 100 * Núcleos lógicos) redondeada al entero más próximo. Si el resultado de la fórmula es 0 o 1, no se habilitará el procesamiento en paralelo.

  • Puede revisar y actualizar el archivo de salida generado por esta herramienta en el panel Revisar direcciones divididas. Este proceso también le permite generar o agregar a un archivo de excepciones actualizado que se puede utilizar en el parámetro Archivo de excepciones al dividir datos con esta herramienta en el futuro.

Parámetros

EtiquetaExplicaciónTipo de datos
País o región

Especifica la estructura de direcciones por países que se utilizará para dividir las direcciones en componentes.

El valor predeterminado es la configuración regional del sistema operativo.

  • AustraliaAustralia
  • AustriaAustria
  • BélgicaBélgica
  • CanadáCanadá
  • SuizaSuiza
  • AlemaniaAlemania
  • EspañaEspaña
  • FranciaFrancia
  • Gran BretañaGran Bretaña
  • IsraelIsrael
  • Países BajosPaíses Bajos
  • Estados UnidosEstados Unidos
String
Datos de direcciones de entrada

La tabla o clase de entidad que contiene información de direcciones de calles que se dividirá en componentes de dirección individuales.

No se admite información de zona, por ejemplo, ciudad, vecindario, subregión ni código postal.

Table View
Campos de dirección de entrada

El o los campos en la tabla o clase de entidad de entrada que, cuando se concatenan, forman la dirección de calle que se va a dividir. No se admite información de zona, por ejemplo, ciudad, vecindario, subregión ni código postal.

El orden en que se seleccionan los campos es el orden en el que estos se concatenarán.

String
Datos de direcciones de salida

La tabla o clase de entidad de salida que contendrá los datos de direcciones de calles divididas.

Dataset
Archivo de excepciones
(Opcional)

La tabla que contiene excepciones de análisis de calles.

La tabla puede estar en cualquier formato de tabla compatible.

Table View

arcpy.geocoding.SplitAddressIntoComponents(country_code, in_address_data, in_address_fields, out_address_data, {in_exceptions})
NombreExplicaciónTipo de datos
country_code

Especifica la estructura de direcciones por países que se utilizará para dividir las direcciones en componentes.

El valor predeterminado es la configuración regional del sistema operativo.

  • AUSAustralia
  • AUTAustria
  • BELBélgica
  • CANCanadá
  • CHESuiza
  • DEUAlemania
  • ESPEspaña
  • FRAFrancia
  • GBRGran Bretaña
  • ISRIsrael
  • NLDPaíses Bajos
  • USAEstados Unidos
String
in_address_data

La tabla o clase de entidad que contiene información de direcciones de calles que se dividirá en componentes de dirección individuales.

No se admite información de zona, por ejemplo, ciudad, vecindario, subregión ni código postal.

Table View
in_address_fields
[in_address_fields,...]

El o los campos en la tabla o clase de entidad de entrada que, cuando se concatenan, forman la dirección de calle que se va a dividir. No se admite información de zona, por ejemplo, ciudad, vecindario, subregión ni código postal.

El orden en que se seleccionan los campos es el orden en el que estos se concatenarán.

String
out_address_data

La tabla o clase de entidad de salida que contendrá los datos de direcciones de calles divididas.

Dataset
in_exceptions
(Opcional)

La tabla que contiene excepciones de análisis de calles.

La tabla puede estar en cualquier formato de tabla compatible.

Table View

Muestra de código

Ejemplo 1 de SplitAddressIntoComponents (ventana de Python)

Dividir una tabla con cadenas de direcciones de un solo campo en componentes separados.


import arcpy
atlanta_addresses = r"C:\AtlantaAddresses.csv"
arcpy.geocoding.SplitAddressIntoComponents("USA", atlanta_addresses, "Address", 
                                           r"C:\MySplitAddresses.csv", 
                                           "ExceptionsFile.csv")

Información de licenciamiento

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

Temas relacionados