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

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:

  AddNum	StPreDir	StName	StType
  123	South	Beach	Avenue

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

  AddNum	StName	StType
  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

Cuadro de diálogo

Etiqueta	Explicación	Tipo 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. Australia—Se utilizará la estructura de direcciones de Australia. Austria—Se utilizará la estructura de direcciones de Austria. Bélgica—Se utilizará la estructura de direcciones de Bélgica. Canadá—Se utilizará la estructura de direcciones de Canadá. Suiza—Se utilizará la estructura de direcciones de Suiza. República Checa—Se utilizará la estructura de direcciones de República Checa. Alemania—Se utilizará la estructura de direcciones de Alemania. España—Se utilizará la estructura de direcciones de España. Estonia—Se utilizará la estructura de direcciones de Estonia. Francia—Se utilizará la estructura de direcciones de Francia. Gran Bretaña—Se utilizará la estructura de direcciones de Gran Bretaña. Israel—Se utilizará la estructura de direcciones de Israel. Italia—Se utilizará la estructura de direcciones de Italia. Lituania—Se utilizará la estructura de direcciones de Lituania. Letonia—Se utilizará la estructura de direcciones de Letonia. Países Bajos—Se utilizará la estructura de direcciones de los Países Bajos. Puerto Rico—Se utilizará la estructura de direcciones de Puerto Rico. Suecia—Se utilizará la estructura de direcciones de Suecia. Estados Unidos—Se utilizará la estructura de direcciones de Estados Unidos. Sudáfrica—Se 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

Python

arcpy.geocoding.SplitAddressIntoComponents(country_code, in_address_data, in_address_fields, out_address_data, {in_exceptions})

Nombre	Explicación	Tipo 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. AUS—Se utilizará la estructura de direcciones de Australia. AUT—Se utilizará la estructura de direcciones de Austria. BEL—Se utilizará la estructura de direcciones de Bélgica. CAN—Se utilizará la estructura de direcciones de Canadá. CHE—Se utilizará la estructura de direcciones de Suiza. CZE—Se utilizará la estructura de direcciones de República Checa. DEU—Se utilizará la estructura de direcciones de Alemania. ESP—Se utilizará la estructura de direcciones de España. EST—Se utilizará la estructura de direcciones de Estonia. FRA—Se utilizará la estructura de direcciones de Francia. GBR—Se utilizará la estructura de direcciones de Gran Bretaña. ISR—Se utilizará la estructura de direcciones de Israel. ITA—Se utilizará la estructura de direcciones de Italia. LTU—Se utilizará la estructura de direcciones de Lituania. LVA—Se utilizará la estructura de direcciones de Letonia. NLD—Se utilizará la estructura de direcciones de los Países Bajos. PRI—Se utilizará la estructura de direcciones de Puerto Rico. SWE—Se utilizará la estructura de direcciones de Suecia. USA—Se utilizará la estructura de direcciones de Estados Unidos. ZAF—Se 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")

Entornos

Espacio de trabajo actual, Factor de procesamiento en paralelo

Información de licenciamiento

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