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

optionName

Descripción

OutputRecordType

Tipo de registro de salida. Si son varios, debe proporcionarse una lista.

A
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 la dirección se valida, 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 la dirección no se valida , las líneas de dirección contienen la dirección 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, aunque no se especifique OutputRecordType=A.
AND
Elementos de dirección analizados. 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. Tenga en cuenta que si se especifica “E” y OutputFormattedOnFail=Y, los elementos de dirección analizados incluirán la dirección de entrada de las direcciones que no se pudo validar.
I
Entrada analizada. Esta opción devuelve la dirección de entrada en formato analizado independiente de que haya validado 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 entrada analizada (value "I") difiere de la combinación de OutputRecordType=E y OutputFormattedOnFail=Y en que "I" 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.
P
Datos postales. Las direcciones de salida contienen datos adicionales para cada dirección validada. Para obtener más información, consulteSalida de datos postales.
En blanco
No se devuelven datos de dirección ni datos postales.

OutputFieldLevelReturnCodes

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.

N
No se obtienen códigos de resultado de nivel de campo (opción predeterminada).
Y
Sí, se obtienen códigos de resultado de nivel de campo.

OutputFormattedOnFail

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.
N
No se aplica un formato a las direcciones fallidas (opción predeterminada).
Y
Sí, se aplica un formato a las direcciones fallidas.

Las direcciones con formato se devuelven con el formato que se especifica en la opción OutputRecordType Tenga en cuenta que si especifica el valor OutputRecordType=E, los elementos de dirección analizados incluirán la dirección analizada y validada 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 dirección de salida en formato analizado, independiente de si ValidateAddress pudo validarla, especifique OutputRecordType=I.

Las direcciones con formato se devuelven con el formato que se especifica en la opción Option.OutputRecordType Tenga en cuenta que si especifica el valor Option.OutputRecordType=E, los elementos de dirección analizados incluirán la dirección analizada y validada 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 dirección de salida en formato analizado, independientemente de que ValidateAddress pueda validarla o no, especifique Option.OutputRecordType=I.

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 especifica Y, entonces debe especificar "A" o "E" para OutputRecordType.

Si especifica Y, entonces debe especificar "A" o "E" para Option.OutputRecordType.

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

OutputStreetNameAlias

Para para las direcciones de Estados Unidos, esta opción especifica si se usará o no el alias de las calles en la salida. Un alias de una calle es un nombre alternativo y suele aplicarse solamente a un rango específico de direcciones en esa calle. Si no se permite el uso de alias de calles en la salida, el nombre "básico" de la calle aparecerá en los datos de salida independientemente de que la calle tenga o no un alias. El nombre básico es el nombre que se aplica a toda la calle.

N
No se devolverán alias de nombres de calles en los datos de salida.
Y
Sí, se devolverán alias de nombres de calles en los datos de salida si hay un alias para la calle (opción predeterminada).

OutputStreetNameAlias

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 una calle es un nombre alternativo y suele aplicarse 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 opciones son OutputPreferredAlias y OutputAbbreviatedAlias.

Nota: Si está activada OutputAbbreviatedAlias, el alias abreviado siempre aparecerá en la salida, incluso si OutputStreetNameAlias está desactivada.
N
No se devolverán alias de nombres de calles en los datos de salida.
Y
Sí, se devolverán alias de nombres de calles en los datos de salida si el nombre de calle de entrada es un alias (opción predeterminada).

OutputAddressBlocks

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 la dirección en bloques de dirección por medio de las normas 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 OutputCountryFormat no afecta al nombre del país en el bloque de dirección, solo afecta al nombre devuelto en el campo de salida Country.

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

N
No se devuelven bloques de dirección. Opción predeterminada.
Y
Sí, se devuelven bloques de dirección.

OutputAMAS

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 la dirección en bloques de dirección por medio de las normas 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 OutputCountryFormat no afecta al nombre del país en el bloque de dirección, solo afecta al nombre devuelto en el campo de salida Country.

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

N
No se devuelven bloques de dirección. Opción predeterminada.
Y
Sí, se devuelven bloques de dirección.