Opciones de datos de salida

La tabla a continuación muestra las opciones que controlan el tipo de información devuelta por ValidateAddress. Algunas de estas opciones pueden anularse para las direcciones de Canadá. Para obtener más información, consulteOpciones de dirección de Canadá.

Tabla 1. Opciones de datos de salida

Opción

Descripción

Incluir una dirección estándar

Se devuelven entre 1 y 4 líneas de datos de dirección además de la información de ciudad, estado, código postal, nombre de la empresa y nombre de urbanización. Cada línea de dirección representa una línea real de la dirección tal como aparecería en un sobre. Para obtener más información, consulteOutput.

Si Validate Address puede validar la dirección, las líneas de dirección contienen la dirección estandarizada. Cuando se estandarizan las direcciones, se elimina la puntuación, se abrevia la información direccional, se abrevian los sufijos de calle y se corrigen los elementos de dirección.

Si Validate Address no puede validar la dirección, las líneas de dirección contienen la información tal como apareció en la entrada (son datos que "atraviesan" la etapa). Las direcciones no validadas siempre se incluyen como datos que atraviesan la etapa en los campos de líneas de dirección, incluso aunque se haya desactivado esta opción.

Incluir elementos de dirección cruzados

Cada parte de la dirección, como el número de casa, el nombre y el sufijo de la calle, los datos direccionales, etc. se devuelve en un campo separado. Para obtener más información, consulteSalida de elementos de dirección analizados. Si se selecciona esta opción y también se selecciona la opción Obtener datos normalizados si no se encuentra un cruce, los elementos de dirección incluirán la dirección de entrada en el caso de las direcciones que no pudieron validarse.

Incluir información postal

Las direcciones de salida contienen diversos datos adicionales para cada dirección validada. Para obtener más información, consulteSalida de datos postales.

Incluir elementos de dirección de entrada estandarizados

Esta opción permite obtener la dirección de entrada en formato analizado independientemente de que Validate Address pueda o no validar la dirección. Cada parte de la dirección de entrada, como el número de casa, el nombre y el sufijo de la calle, los datos direccionales, etc. se devuelve en un campo separado.

La diferencia entre seleccionar esta opción y seleccionar las opciones combinadas Incluir elementos de dirección cruzados/Obtener datos normalizados si no se encuentra un cruce es que la opción Devolver elementos de dirección de entrada estandarizados devuelve toda la dirección de entrada en formato analizado, y no solo los datos de entrada que no pudieron validarse. Para obtener más información, consulteEntrada analizada.

Incluir códigos de resultado para campos individuales

Especifica si deben incluirse indicadores de resultados de nivel de campo. Los indicadores de resultados de nivel de campo describen la forma en que se manejó cada elemento de dirección. Estos indicadores se devuelven con el calificador "Result". Por ejemplo, el indicador de resultados del campo HouseNumber se encuentra en HouseNumber.Result. Para obtener una lista completa de los campos de salida de indicadores de resultados, consulte Indicadores de resultado de nivel de campo.

Obtener datos normalizados si no se encuentra un cruce

Especifica si se devolverá una dirección con formato cuando no sea posible validar una dirección. A la dirección se le aplica el formato de dirección preferido para el país correspondiente. Si no se selecciona esta opción, los campos de dirección de salida quedarán en blanco cuando no se pueda validar la dirección.

Nota: Esta opción se aplica a las direcciones de Estados Unidos y Canadá. No se devuelven datos con formato para otros tipos de direcciones.

Las direcciones con formato aplicado se devuelven en el formato especificado en las casillas Incluir una dirección estándar, Incluir elementos de línea de dirección e Incluir información postal. Si se selecciona Incluir elementos de línea de dirección, los elementos de dirección analizados incluirán la dirección analizada y validada en el caso de las direcciones que no pudieron validarse. Si la dirección no pudo validarse, los elementos de dirección analizados incluirán la dirección de entrada en el formato analizado. Si desea que la dirección de entrada aparezca siempre en la salida en formato analizado, independientemente de que ValidateAddress pueda validarla o no, seleccione Incluir elementos de dirección de entrada estandarizados.

Si marca esta opción, debe seleccionar Incluir una dirección estándar o Incluir elementos de línea de dirección.

Obtener alias de nombre de calle

Para para las direcciones de Estados Unidos, esta opción especifica cómo se procesarán los alias de nombres de calles utilizados en la entrada. Un alias de calle es un nombre alternativo y se aplica solamente a un rango específico de direcciones en esa calle.

Si se habilita esta opción, los alias de nombres de calles utilizados en los datos de entrada aparecerán en los datos de salida. Si esta opción no se habilita, los alias de nombres de calles que aparecen en los datos de entrada se convertirán al nombre de calle básico en la salida, con las siguientes excepciones:

  • Si se utiliza un alias preferido en los datos de entrada, el alias preferido aparecerá siempre en la salida.
  • Los alias modificados que aparecen en los datos de entrada siempre se convierten al nombre de calle básico en la salida.

Esta es una de las tres opciones que controlan la forma en que ValidateAddress maneja los alias de nombres de calles. Las otras dos son Procesamiento de alias de calle preferido y Procesamiento de alias de calle abreviado.

Nota: Si se activa la opción Procesamiento de alias de calle abreviado, el alias abreviado siempre aparecerá en los datos de salida, incluso aunque la opción Obtener alias de nombre de calle esté desactivada.

Obtener bloques de datos de dirección

Especifica si se devolverá una versión de la dirección con formato aplicado tal como se imprimiría en una pieza postal física. Cada línea de la dirección se devuelve en un campo de bloque de dirección separado. Puede haber hasta nueve campos de salida del bloque de dirección: AddressBlock1 hasta AddressBlock9.

Por ejemplo, para esta dirección de entrada:

AddressLine1: 4200 Parliament Place
AddressLine2: Suite 600
City: Lanham
StateProvince: MD
PostalCode: 20706

Se genera este bloque de dirección de salida:

AddressBlock1: 4200 PARLIAMENT PL STE 600
AddressBlock2: LANHAM MD 20706-1882
AddressBlock3: UNITED STATES OF AMERICA

ValidateAddress aplica el formato a los bloques de dirección según los estándares de las autoridades postales. El nombre de país se devuelve con el nombre de país estipulado por la Unión Postal Universal. Tenga en cuenta que la opción Formato de país no afecta al nombre del país en el bloque de dirección, sino que solo tiene efecto en el nombre devuelto en el campo de salida País.

Para direcciones que no corresponden a Estados Unidos ni Canadá, si ValidateAddress no puede validar la dirección no se obtienen bloques de dirección. Para direcciones en los Estados Unidos y Canadá, se obtienen bloques de dirección incluso si falla la validación.

Dar formato a datos mediante convenciones de AMAS

Especifica si se devolverá una versión de la dirección con formato aplicado tal como se imprimiría en una pieza postal física. Cada línea de la dirección se devuelve en un campo de bloque de dirección separado. Puede haber hasta nueve campos de salida del bloque de dirección: AddressBlock1 hasta AddressBlock9.

Por ejemplo, para esta dirección de entrada:

AddressLine1: 4200 Parliament Place
AddressLine2: Suite 600
City: Lanham
StateProvince: MD
PostalCode: 20706

Se genera este bloque de dirección de salida:

AddressBlock1: 4200 PARLIAMENT PL STE 600
AddressBlock2: LANHAM MD 20706-1882
AddressBlock3: UNITED STATES OF AMERICA

ValidateAddress aplica el formato a los bloques de dirección según los estándares de las autoridades postales. El nombre de país se devuelve con el nombre de país estipulado por la Unión Postal Universal. Tenga en cuenta que la opción Formato de país no afecta al nombre del país en el bloque de dirección, sino que solo tiene efecto en el nombre devuelto en el campo de salida País.

Para direcciones que no corresponden a Estados Unidos ni Canadá, si ValidateAddress no puede validar la dirección no se obtienen bloques de dirección. Para direcciones en los Estados Unidos y Canadá, se obtienen bloques de dirección incluso si falla la validación.