GetCandidateAddresses

GetCandidateAddresses devuelve una lista de direcciones que se consideran cruces (coincidencias) para una dirección dada. GetCandidateAddresses devuelve direcciones de candidatos solo si la dirección de entrada coincide con múltiples direcciones de la base de datos postales. Si la dirección de entrada coincide solo con una dirección de la base de datos postales, no se devuelven datos de dirección.

Para direcciones que no corresponden a Estados Unidos y Canadá, pueden observarse contradicciones entre los múltiples cruces devueltos por ValidateAddress y los resultados correspondientes a esas mismas direcciones devueltos por GetCandidateAddresses. Si observa resultados contradictorios, probablemente se deba a que el ajuste de rendimiento de ValidateAddress está configurado con un valor que no es 100. Para obtener resultados uniformes entre GetCandidateAddresses y ValidateAddress, configure la opción de ajuste de rendimiento con el valor 100.

Nota: De forma predeterminada, GetCandidateAddresses no establece cruces con números de casa individuales, sino que utiliza rangos de números de casas para cada calle. Después de que GetCandidateAddresses determina el nombre de la calle, la ciudad, el estado o la provincia y el código postal, verifica que el número de casa de entrada corresponda a uno de los rangos de números de casas dados para el nombre de calle coincidente. El mismo tipo de lógica se aplica a los números de unidades. Si usted desea determinar que un número de casa individual es válido, debe utilizar la opción de procesamiento de validación de punto de entrega (Delivery Point Validation, DPV) de ValidateAddress. El procesamiento DPV solo está disponible para direcciones de Estados Unidos

El codificador de Canadá incluye una rutina de búsqueda inversa que toma como entrada un código postal específico y arroja la información de calle almacenada en la base de datos para ese código postal. Para usar esta función no ingrese ningún dato salvo un código postal de Canadá en el campo PostalCode. Consulte el segundo ejemplo para ver los resultados obtenidos con un código postal de ejemplo.

GetCandidateAddresses forma parte del módulo Universal Addressing.