Opciones

La tabla a continuación muestra las opciones que controlan el tipo de información devuelta por ValidateAddressLoqate.

Tabla 1. Opciones de datos de salida

optionName

Descripción

Database.Loqate

Especifica la base de datos que se desea utilizar para validar las direcciones internacionales. Para especificar una base de datos para la validación de direcciones internacionales, seleccione una base de datos en la lista desplegable Base de datos.

OutputFieldLevelReturnCodes

Especifica si deben incluirse indicadores de resultados de nivel de campo. Los indicadores de resultados de nivel de campo muestran la forma en que ValidateAddressLoqate 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.

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 en caso de que ValidateAddressLoqate no pueda validar la dirección.

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 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 los datos de salida en formato analizado, independientemente de que ValidateAddressLoqate 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.

Las direcciones con formato se devuelven con el formato que se especifica en la opciónOutputRecordType. 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 los datos de salida en formato analizado, independientemente de que ValidateAddressLoqate pueda validarla o no, especifique OutputRecordType=I.

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

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 los datos de salida en formato analizado, independientemente de que ValidateAddressLoqate pueda validarla o no, especifique Option.OutputRecordType=I.

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

ValidateAddressLoqate aplica el formato de bloque 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, sino que solo tiene efecto en el nombre devuelto en el campo de salida País.

Una de las siguientes:

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

AmasFormatting

Especifica que se va a dar formato a los datos de las direcciones de salida mediante convenciones de Address Matching Approval System.

Esta opción hace que Validate Address Loqate use reglas de AMAS al estandarizar una dirección. AMAS es un programa del servicio australiano de correspondencia para hacer cumplir las normas. Para obtener más información sobre las convenciones de formato de AMAS, consulte el manual de sistema de Address Matching Approval System (AMAS).

Esta opción modifica los datos de salida de la siguiente manera.

  • Los campos numéricos se rellenan con ceros. Afecta a los siguientes campos de salida: HouseNumber, HouseNumber2, PostalDeliveryNumber y DPID. Por ejemplo, si la dirección de entrada es 298 New South Head Rd Double Bay NSW 2028, entonces, el formato de HouseNumber cambia de 298 a 00298.
  • Si no se hace un cruce, entonces todos los dígitos en el campo DPID serán cero. Por ejemplo, 00000000.
  • Si no se hizo un cruce, entonces, todos los campos de retorno (elementos de dirección analizados) se dejarán en blanco, excepto los campos numéricos que contendrá solo ceros.
  • El campo CCD no es de salida.

Los valores válidos son:

N
No, no dar formato a los datos de la salida mediante convenciones de AMAS (valor predeterminado).
Y
Sí, dar formato a los datos de salida con convenciones de AMAS.
Nota: Cuando se selecciona esta opción, los resultados se devuelven con el formato de AMAS, independientemente de las selecciones hechas en los campos Nivel de aceptación y Puntuación mínima de cruce.

OutputCasing

Especifica el uso de mayúsculas y minúsculas en los datos de salida. Una de las siguientes:

M
Los datos de salida combinan mayúsculas y minúsculas (opción predeterminada). Por ejemplo:

123 Main St
Mytown FL 12345

U
Los datos de salida aparecen en mayúscula. Por ejemplo:

123 MAIN ST
MYTOWN FL 12345

HomeCountry

Especifica el país predeterminado. Debe especificar el país al que corresponden la mayoría de las direcciones. Por ejemplo, si la mayoría de las direcciones que procesa corresponden a Alemania, indique ese país. ValidateAddressLoqate utiliza el país especificado para intentar realizar la validación si no puede determinar el país por medio de los campos de dirección StateProvince (Estado/Provincia), PostalCode (Código postal) y Country (País). Los nombres de países válidos son:

Afghanistan, Albania, Algeria, American Somoa, Andorra, Angola, Anguilla, Antigua And Barbuda, Argentina, Armenia, Aruba, Australia, Austria, Azerbaijan, Bahamas, Bahrain, Bangladesh, Barbados, Belarus, Belgium, Belize, Benin, Bermuda, Bhutan, Bolivia, Bosnia And Herzegovina, Botswana, Brazil, British Virgin Islands, Brunei Darussalam, Bulgaria, Burkina Faso, Burundi, Cambodia, Cameroon, Canada, Cape Verde, Cayman Islands, Central African Republic, Chad, Chile, China, Colombia, Comoros Islands, Congo, Cook Islands, Costa Rica, Cote D'Ivoire, Croatia, Cuba, Cyprus, Czech Republic, Democratic Republic Of Congo, Denmark, Djibouti, Dominica, Dominican Republic, East Timor, Ecuador, Egypt, El Salvador, Equitorial Guinea, Eritrea, Estonia, Ethiopia, Falkland Islands, Faroe Islands, Federated States Of Micronesia, Fiji, Finland, France, French Guiana, Gabon, Gambia, Germany, Ghana, Gibraltar, Greece, Greenland, Grenada, Guadeloupe, Guam, Guatemala, Guinea, Guinea Bissau, Guyana, Haiti, Holy See, Honduras, Hong Kong, Hungary, Iceland, India, Indonesia, Iran, Iraq, Ireland, Israel, Italy, Jamaica, Japan, Jordan, Kazakhstan, Kenya, Kiribati, Korea, Kuwait, Kyrgyzstan, Laos, Latvia, Lebanon, Lesotho, Liberia, Libya, Liechtenstein, Lithuania, Luxembourg, Macau, Macedonia, Madagascar, Malawi, Malaysia, Maldives, Mali, Malta, Marshall Islands, Martinique, Mauritania, Mauritius, Mayotte, Mexico, Moldova, Monaco, Mongolia, Monserrat, Morocco, Mozambique, Myanmar, Namibia, Nauru, Nepal, Netherlands Antilles, New Caledonia, New Zealand, Nicaragua, Niger, Nigeria, Niue, Norway, Oman, Pakistan, Palau, Panama, Papua New Guinea, Paraguay, Peru, Philippines, Pitcairn Islands, Poland, Portugal, Puerto Rico, Qatar, Republic Of Georgia, Republic Of Korea, Republic Of Singapore, Reunion, Romania, Russia, Rwanda, Saint Helena, Saint Kitts And Nevis, Saint Lucia, Saint Pierre And Miquelon, Saint Vincent And The Grenadines, Samoa, San Marino, Sao Tome And Principe, Saudi Arabia, Senegal, Seychelles, Sierra Leone, Slovakia, Slovenia, Solomon Islands, Somalia, South Africa, Spain, Sri Lanka, Sudan, Surivalue, Swaziland, Sweden, Switzerland, Syria, Tahiti, Taiwan, Tajikistan, Tanzania, Thailand, The Netherlands, Togo, Tonga, Trinidad And Tobago, Tristan Da Cunha, Tunisia, Turkey, Turkmenistan, Turks And Caicos Islands, Tuvalu, Uganda, Ukraine, United Arab Emirates, United Kingdom, United States, Uruguay, Uzbekistan, Vanuatu, Venezuela, Vietnam, Virgin Islands (US), Wallis And Futuna, Yemen, Yugoslavia, Zambia, Zimbabwe

OutputCountryFormat

Especifica el formato a usar para el nombre de país devuelto en el campo de salida País. Por ejemplo, si se selecciona el idioma inglés, el nombre de país "Deutschland" se devolverá como "Germany" (Alemania).

E
Se utilizan los nombres de los países en inglés (opción predeterminada).
I
Se utiliza la abreviatura ISO de dos letras en lugar de los nombres de los países.
U
Se utiliza la abreviatura de la Unión Postal Universal (UPU) en lugar de los nombres de los países.

OutputScript

Especifica el alfabeto o tipo de escritura que deben utilizarse para devolver los datos de salida. Esta opción es bidireccional y por lo general se realiza de un alfabeto nativo al latino, y viceversa.

Input
No se realiza la transcripción (transliteración) y los datos de salida se devuelven en el mismo tipo de escritura de los datos de entrada (opción predeterminada).
Native
Los datos de salida se devuelven en el tipo de escritura nativo del país seleccionado de ser posible.
Latn
Se usan valores del inglés.
Nivel de aceptación

AcceptanceLevel

Especifica el nivel mínimo de validación que debe obtener un registro para que se considere como procesado correctamente. El valor en este campo corresponde al segundo carácter del Código de verificación de direcciones, que se denomina “Nivel de coincidencia de verificación procesado posteriormente":

  • 5: punto de entrega (edificio o casilla postal). El registro se pasará o tendrá una alta confianza si ApartmentNumber, HouseNumber, Street, City y StateProvince proporcionados en el registro de entrada, coinciden con el conjunto de datos de referencia de Loqate. Tendrá una confianza moderada si ApartmentNumber es correcto, pero los campos restantes son incorrectos. En este caso, sin embargo, el motor Loqate debe tener la capacidad de identificar el campo ApartmentNumber ya que ApartmentNumber está a un nivel más granular. Tendrá cero confianza si el motor Loqate no puede analizar ApartmentNumber y los otros campos.
  • 4: oficina o lugar / edificio. El registro se pasará o tendrá una alta confianza si House Number, Street, City y StateProvince proporcionados en el registro de entrada, coinciden con el conjunto de datos de referencia de Loqate. Tendrá una confianza moderada si HouseNumber es correcto, pero los otros campos son incorrectos. En este caso, sin embargo, el motor Loqate debe tener la capacidad de identificar el campo HouseNumber, ya que HouseNumber está a un nivel más granular. Tendrá cero confianza si el motor Loqate no puede analizar HouseNumber y los otros campos.
  • 3: vía pública, camino o calle. El registro se pasará o tendrá una alta confianza si Street, City y StateProvince proporcionados en el registro de entrada, coinciden con el conjunto de datos de referencia de Loqate. Tendrá una confianza moderada si City es correcto, pero StateProvince es incorrecto. En este caso, sin embargo, el motor Loqate debe tener la capacidad de identificar el campo StateProvince ya que City en sí mismo forma parte de StateProvince. Tendrá cero confianza si el motor Loqate no puede analizar City o ambos campos (City y StateProvince).
  • 2: localidad (ciudad o pueblo). El registro se pasará o tendrá una alta confianza si tanto City como StateProvince proporcionados en el registro de entrada, coinciden con el conjunto de datos de referencia de Loqate. Tendrá una confianza moderada si City es correcto, pero StateProvince es incorrecto. En este caso, sin embargo, el motor Loqate puede identificar el campo StateProvince, ya que City en sí mismo forma parte de StateProvince. Tendrá cero confianza si el motor Loqate no puede analizar City o ambos campos (City y StateProvince).
  • 1: área administrativa (estado o región). El registro se pasará o tendrá una alta confianza si StateProvince proporcionado en el registro de entrada, coincide con el conjunto de datos de referencia de Loqate.
  • 0: ninguno. Esto equivale a la opción de coincidencia más imprecisa.

IsDuplicateHandlingMaskEnable

Enables the duplicate handling mask and specifies how duplicate records are processed and removed. Seleccione una o ambas opciones siguientes:

S
Selected by default. Procesa previamente los datos de entrada y elimina los duplicados que se producen en un campo único.
C
Selected by default. Procesa previamente los datos de entrada y elimina los duplicados entre los campos.
T
Pre-process the input and remove duplicates in fields that are not standard address fields.
F
Selected by default. Procesa posteriormente los datos de salida de la verificación y elimina duplicados desde campos sin verificar.

MinimumMatchScore

Especifica un valor numérico entre 0 y 100 que indica el grado en el cual Validate Address Loqate cambiará una dirección para obtener una coincidencia en la base de datos de referencia de Loqate. Mientras más bajo sea el número, mayor es el grado de cambio que admite. Un valor de 100 significa que después del análisis, la dirección de entrada es casi idéntica a la dirección validada. Un valor de 0 significa que la dirección de entrada analizada puede cambiar completamente para obtener una dirección validada.

KeepMultimatch

Especifica si se devolverán múltiples direcciones para las direcciones de entrada que tienen más de una coincidencia posible.

Y
Sí, se devolverán múltiples cruces (opción predeterminada).
N
No se devolverán múltiples cruces.

Para obtener más información, consultereturning_multiple_matches.html#returning_multiple_matches.

FailMultipleMatches

No hay direcciones múltiples para las direcciones de entrada que tienen más de una posible coincidencia.