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.

  • Asegúrese de que el valor del parámetro Archivo de excepciones contiene una fila para cada registro que tendrá 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.

  • AustraliaSe utilizará la estructura de direcciones de Australia.
  • AustriaSe utilizará la estructura de direcciones de Austria.
  • BélgicaSe utilizará la estructura de direcciones de Bélgica.
  • CanadáSe utilizará la estructura de direcciones de Canadá.
  • SuizaSe utilizará la estructura de direcciones de Suiza.
  • República ChecaSe utilizará la estructura de direcciones de República Checa.
  • AlemaniaSe utilizará la estructura de direcciones de Alemania.
  • EspañaSe utilizará la estructura de direcciones de España.
  • EstoniaSe utilizará la estructura de direcciones de Estonia.
  • FranciaSe utilizará la estructura de direcciones de Francia.
  • Gran BretañaSe utilizará la estructura de direcciones de Gran Bretaña.
  • IsraelSe utilizará la estructura de direcciones de Israel.
  • ItaliaSe utilizará la estructura de direcciones de Italia.
  • LituaniaSe utilizará la estructura de direcciones de Lituania.
  • LetoniaSe utilizará la estructura de direcciones de Letonia.
  • Países BajosSe utilizará la estructura de direcciones de los Países Bajos.
  • Puerto RicoSe utilizará la estructura de direcciones de Puerto Rico.
  • SueciaSe utilizará la estructura de direcciones de Suecia.
  • Estados UnidosSe utilizará la estructura de direcciones de Estados Unidos.
  • SudáfricaSe utilizará la estructura de direcciones de Sudáfrica.
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.

  • AUSSe utilizará la estructura de direcciones de Australia.
  • AUTSe utilizará la estructura de direcciones de Austria.
  • BELSe utilizará la estructura de direcciones de Bélgica.
  • CANSe utilizará la estructura de direcciones de Canadá.
  • CHESe utilizará la estructura de direcciones de Suiza.
  • CZESe utilizará la estructura de direcciones de República Checa.
  • DEUSe utilizará la estructura de direcciones de Alemania.
  • ESPSe utilizará la estructura de direcciones de España.
  • ESTSe utilizará la estructura de direcciones de Estonia.
  • FRASe utilizará la estructura de direcciones de Francia.
  • GBRSe utilizará la estructura de direcciones de Gran Bretaña.
  • ISRSe utilizará la estructura de direcciones de Israel.
  • ITASe utilizará la estructura de direcciones de Italia.
  • LTUSe utilizará la estructura de direcciones de Lituania.
  • LVASe utilizará la estructura de direcciones de Letonia.
  • NLDSe utilizará la estructura de direcciones de los Países Bajos.
  • PRISe utilizará la estructura de direcciones de Puerto Rico.
  • SWESe utilizará la estructura de direcciones de Suecia.
  • USASe utilizará la estructura de direcciones de Estados Unidos.
  • ZAFSe utilizará la estructura de direcciones de Sudáfrica.
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