Validate Address

„Validate Address“ standardisiert und prüft Adressen mithilfe der Adressdaten von Postbehörden. „Validate Address“ kann Daten korrigieren und die Adresse entsprechend dem durch die jeweilige Postbehörde bevorzugten Format formatieren. Durch „Validate Address“ werden zudem fehlende postalische Daten wie Postleitzahlen, Ortsnamen, Namen von Bundesländern/Kantonen usw. hinzugefügt.

Des Weiteren gibt „Validate Address“ Indikatoren zu Vergleichsversuchen zurück, z. B. ob „Validate Address“ die Adresse geprüft hat, das Zuverlässigkeitsniveau der zurückgegebenen Adresse, den Fehlergrund, wenn die Adresse nicht validiert werden konnte, usw.

Während des Adressenvergleichs und der Standardisierung trennt „Validate Address“ Adresszeilen in Komponenten und vergleicht sie mit den Inhalten der Datenbanken des Universal Addressing-Moduls. Wenn eine Übereinstimmung ermittelt wird, wird die eingegebene Adresse entsprechend den Informationen in der Datenbank standardisiert. Wenn keine Übereinstimmung in der Datenbank gefunden wird, formatiert „Validate Address“ die eingegebenen Adressen (optional). Bei dem Formatierungsvorgang wird versucht, die Adresszeilen gemäß den Standards der jeweiligen Postbehörde zu strukturieren.

„Validate Address“ ist Teil des Universal Addressing-Moduls.

Ressourcen-URL

JSON-Endpunkt:

http://server:port/rest/ValidateAddress/results.json

XML-Endpunkt:

http://server:port/rest/ValidateAddress/results.xml

Beispiel mit JSON-Antwort

Im folgenden Beispiel wird eine JSON-Antwort angefordert:

http://myserver:8080/rest/ValidateAddress/results.json?Data.AddressLine1=1825+Kramer+Ln&Data.PostalCode=78758

Die von dieser Anforderung zurückgegebene JSON-Antwort würde wie folgt lauten:

{"output_port": [{
   "Confidence": "100",
   "RecordType": "Normal",
   "CountryLevel": "A",
   "ProcessedBy": "USA",
   "MatchScore": "0",
   "AddressLine1": "1825 Kramer Ln",
   "City": "Austin",
   "StateProvince": "TX",
   "PostalCode": "78758-4260",
   "Country": "United States Of America",
   "PostalCode.Base": "78758",
   "PostalCode.AddOn": "4260",
   "user_fields": []
}]}

Beispiel mit XML-Antwort

Im folgenden Beispiel wird eine XML-Antwort angefordert:

http://myserver:8080/rest/ValidateAddress/results.xml?Data.AddressLine1=1825+Kramer+Ln&Data.PostalCode=78758

Die von dieser Anforderung zurückgegebene XML-Antwort würde wie folgt lauten:

<ns2:xml.ValidateAddressResponse xmlns:ns2="http://www.pb.com/spectrum/services/ValidateAddress">
   <ns2:output_port>
      <ns2:Address>
         <ns2:Confidence>93</ns2:Confidence>
         <ns2:RecordType>Normal</ns2:RecordType>
         <ns2:CountryLevel>A</ns2:CountryLevel>
         <ns2:ProcessedBy>USA</ns2:ProcessedBy>
         <ns2:MatchScore>0</ns2:MatchScore>
         <ns2:AddressLine1>1825 Kramer Ln</ns2:AddressLine1>
         <ns2:City>Austin</ns2:City>
         <ns2:StateProvince>TX</ns2:StateProvince>
         <ns2:PostalCode>78758-4260</ns2:PostalCode>
         <ns2:PostalCode.Base>78758</ns2:PostalCode.Base>
         <ns2:PostalCode.AddOn>4260</ns2:PostalCode.AddOn>
         <ns2:Country>United States Of America</ns2:Country>
         <ns2:user_fields/>
      </ns2:Address>
   </ns2:output_port>
</ns2:xml.ValidateAddressResponse>