ValidateAddressLoqate

ValidateAddressLoqate standardizes and validates addresses using postal authority address data. ValidateAddress Loqate can correct information and format the address using the format preferred by the applicable postal authority. It also adds missing postal information, such as postal codes, city names, state/province names, and so on.

ValidateAddressLoqate also returns result indicators about validation attempts, such as whether or not ValidateAddressLoqate validated the address, the level of confidence in the returned address, the reason for failure if the address could not be validated, and more.

During address matching and standardization, ValidateAddressLoqate separates address lines into components and compares them to the contents of the Universal Addressing Module databases. If a match is found, the input address is standardized to the database information. If no database match is found, ValidateAddressLoqate optionally formats the input addresses. The formatting process attempts to structure the address lines according to the conventions of the appropriate postal authority.

ValidateAddressLoqate is part of the Universal Addressing Module.

Resource URL

JSON endpoint:

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

XML endpoint:

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

Example with JSON Response

The following example requests a JSON response:

http://myserver:8080/rest/ValidateAddressLoqate/results.json?​Data.AddressLine1=1+Global+View&Data.City=Troy&​Data.StateProvince=NY

The JSON returned by this request would be:

{"output_port": [{
   "Confidence": "95",
   "CouldNotValidate": "",
   "ProcessedBy": "LOQATE",
   "MatchScore": "100.0",
   "AddressLine1": "1 Global Vw",
   "AddressLine2": "",
   "City": "Troy",
   "StateProvince": "NY",
   "PostalCode": "12180-8371",
   "Country": "United States",
   "FirmName": "",
   "PostalCode.Base": "12180",
   "PostalCode.AddOn": "8371",
   "user_fields": []
}]}

Example with XML Response

The following example requests an XML response:

http://myserver:8080/rest/ValidateAddressLoqate/results.xml?​Data.AddressLine1=1+Global+View&Data.City=Troy&​Data.StateProvince=NY

The XML returned by this request would be:

<ns2:xml.ValidateAddressLoqateResponse
xmlns:ns2="http://www.pb.com/spectrum/services/ValidateAddressLoqate">
   <ns2:output_port>
      <ns2:Address>
         <ns2:Confidence>95</ns2:Confidence>
         <ns2:CouldNotValidate/>
         <ns2:ProcessedBy>LOQATE</ns2:ProcessedBy>
         <ns2:MatchScore>100.0</ns2:MatchScore>
         <ns2:AddressLine1>1 Global Vw</ns2:AddressLine1>
         <ns2:AddressLine2/>
         <ns2:City>Troy</ns2:City>
         <ns2:StateProvince>NY</ns2:StateProvince>
         <ns2:PostalCode>12180-8371</ns2:PostalCode>
         <ns2:PostalCode.Base>12180</ns2:PostalCode.Base>
         <ns2:PostalCode.AddOn>8371</ns2:PostalCode.AddOn>
         <ns2:Country>United States</ns2:Country>
         <ns2:FirmName/>
         <ns2:user_fields/>
      </ns2:Address>
   </ns2:output_port>
</ns2:xml.ValidateAddressLoqateResponse>