„GetCandidateAddresses“

„GetCandidateAddresses“ gibt eine Liste der Adressen zurück, die bei einer angegebenen Eingabeadresse als Übereinstimmungen gelten. „GetCandidateAddresses“ gibt Kandidatenadressen nur dann zurück, wenn die Eingabeadresse mit mehreren Adressen in der Postdatenbank übereinstimmt. Wenn die Eingabeadresse nur mit einer Adresse in der Postdatenbank übereinstimmt, werden keine Adressdaten zurückgegeben.

Wenn bei Adressen außerhalb der USA und Kanada treten bei den von „ValidateAddress“ zurückgegebenen Mehrfachübereinstimmungen und den für dieselbe Adresse von „GetCandidateAddresses“ zurückgegebenen Ergebnissen möglicherweise inkonsistente Ergebnisse auf. Die Ursache für die inkonsistenten Ergebnisse ist wahrscheinlich, dass Sie die Einstellung für die Leistungsoptimierung in „ValidateAddress“ auf einen anderen Wert als 100 festgelegt haben. Legen Sie die Option für die Leistungsoptimierung auf 100 fest, um konsistente Ergebnisse bei „GetCandidateAddresses“ und „ValidateAddress“ zu erzielen.

Anmerkung: Standardmäßig gleicht „GetCandidateAddresses“ keine einzelnen Hausnummern ab. Stattdessen werden für jede Straße Hausnummernbereiche verwendet. Nachdem „GetCandidateAddresses“ den Straßennamen, den Ortsnamen, Bundesland/Kanton und Postleitzahl bestimmt hat, überprüft es, ob die eingegebene Hausnummer in einen der Hausnummernbereiche fällt, die für die übereinstimmende Straße angegeben sind. Dieselbe Logik wird auf Einheitsnummern angewendet. Wenn Sie bestimmen möchten, ob eine einzelne Hausnummer gültig ist, müssen Sie die Delivery Point Validation(DPV)-Verarbeitungsoption von „ValidateAddress“ verwenden. Die Verfügbarkeit der DPV-Verarbeitung gilt nur für US-amerikanische Adressen.

Der kanadische Coder umfasst eine „Reverse Lookup“-Routine, die eine bestimmte Postleitzahl als Eingabe verwendet und die für diese Postleitzahl in der Datenbank gespeicherten Straßeninformationen zurückgibt. Geben Sie für die Verwendung dieser Funktion lediglich eine kanadische Postleitzahl in das Feld „PostalCode“ ein. Im zweiten Beispiel wird dargestellt, wie die Rückgabe über eine beispielhafte Postleitzahl erfolgt.

„GetCandidateAddresses“ ist Teil des Universal Addressing-Moduls.

Beispiel für US-amerikanische Adressen

AddressLine1: PO Box 1 City: NY State: NY

Kanadische Adressen: Beispiel

PostalCode: A1A1A1