1.3.9.1 Address Verification
The Address Verification processor (AV) is used to verify and standardize address data from any country. It also provides geocoding.
Note:
If the processor has not been correctly installed it will still run but all the output fields will be left blank, except for Accuracy Code, which will have a value of -1.0.
Use the Address Verification processor:
-
to standardize addresses to a format;
-
to check whether an address is correct;
-
to complete partial addresses; and
-
to enhance address data with geocodes.
Configuration
This processor always appears with a re-run marker, indicating that it will be completely re-executed each time the process is run, regardless of whether or not its configuration has changed. This will also mean that processors that are downstream of the processor will need to be rerun. This is because there may be changes made outside of the EDQ application that could lead to different results on subsequent executions.
Inputs
The Input attribute mappings are used as clues by the processor as to which Input attributes may contain specific data types, according to the initial structure of the address data. It is not normally necessary to parse addresses fully into all the different Input attributes before putting data through Address Verification. In many cases, it is sufficient to simply add address data to the Input address lines (as long as a country is provided), as the Address Verification processor itself will internally parse addresses before matching them against country-specific reference data. However, if addresses are well structured, more effective verification results may be seen if the corresponding input attribute mappings are used (for example, if an Input attribute normally contains postal codes, it is best to map it to the Postal Code input attribute rather than simply mapping it in as an address line.)
-
Organization
-
Up to 8 address line values
-
Double Dependent Locality
-
Dependent Locality
-
Locality
-
Administrative Area
-
Postal Code
-
Country
-
Postal Box
-
Sub Building
-
Building
-
Premise
-
Thoroughfare
-
Dependent thoroughfare
-
Super Administrative Area
-
Sub Administrative Area
Note:
The Country input must be populated with a country name or code. Without it, Address Verification cannot verify an address or produce an Accuracy Code.
Options
Option | Description | Settings |
---|---|---|
Processing mode |
Whether to verify the input address or search all installed data and return multiple results. |
Verify (Best Match): 1 to 1 - Checks the reference data and returns the best match. Verify (Allow Multiple Results): Attempts to verify the input address 1 to 1, but allows Address Verification to return multiple possible results if the input address has an Ambiguous verification result. Search: 1 to Many - Checks the reference data and returns multiple matches. Allows searching across countries, for example. |
Maximum number of results |
An optional upper limit on number of results that can be returned.
Note: This field is greyed out if Verify (Best Match) is selected. |
Numeric field, maximum of 15 characters. |
Geocode |
Whether matching geocodes are to be returned. |
Yes No |
Output address separator |
The symbol used to separate the address elements. |
Selection of punctuation symbols and special characters. |
Output script |
The output is converted into the script selected. |
Drop-down list of available scripts. Native - the default - returns the output in its original script. |
Output Casing |
The case the output is returned in. |
The available options are Title (default - the first character of each word is upper case, the others are lower case), Upper or Lower. |
Additional options |
Free-text field. |
There are additional options available that are not listed on the Address Verification: Options tab. To use these options, enter them and the specified value in this free-text field. For example:
Note:
|
Outputs
The following table lists all the possible AV output fields. The exact output for each set of data depends on the settings of the AV processor, the original address data, and the information available for the country.
Note:
The CASS, AMAS and SERP options will only work if the appropriate additional Loqate libraries and data are installed.
Output Field | Description |
---|---|
av.Address |
The full address, matched/verified and correctly formatted for mailing in the relevant country. |
av.CountryName |
The full country name. |
av.ISO3166-2 |
The ISO3166 two-character country code. |
av.ISO3166-3 |
The ISO3166 three-character country code. |
av.ISO3166-N |
The ISO3166 three-digit numeric country code. |
av.SuperAdministrativeArea |
The largest geographic data element within a country. |
av.AdministrativeArea |
The most common geographic data element within a country; e.g. a US state or Canadian Province. |
av.SubAdministrativeArea |
The smallest geographic data element; e.g. a US county. |
av.Locality |
The most common population center data element in a country; e.g. a city or municipality. |
av.DependentLocality |
A smaller population center data element; e.g. a Turkish neighborhood. |
av.DoubleDependentLocality |
The smallest population center data element, depending on the contents of the Locality and DependentLocality fields; e.g. a UK village. |
av.Thoroughfare |
The most common street or block data element within a country; e.g. a street. |
av.ThoroughfarePreDirection |
The prefix direction contained within the Thoroughfare field. E.g. if Thoroughfare contains "N MAIN ST" ThoroughfarePreDirection will contain "N". |
av.ThoroughfareLeadingType |
The leading thoroughfare type indicator within the Thoroughfare field. E.g. if Thoroughfare contains "RUE DE LA GARE" ThoroughfareLeadingType will contain "RUE". |
av.ThoroughfareName |
The name indicator within the Thoroughfare field. E.g. if Thoroughfare contains "N MAIN ST" ThoroughfareName will contain "MAIN". |
av.ThoroughfareTrailingType |
The trailing thoroughfare type indicator within the Thoroughfare field. E.g. if Thoroughfare contains "N MAIN ST" ThoroughfareTrailingType will contain "ST". |
av.ThoroughfarePostDirection |
The postfix directional contained within the Thoroughfare field. E.g. if Thoroughfare contains "MAIN ST N" ThoroughfarePostDirection will contain "N". |
av.DependentThoroughfare |
The dependent street or block data element within a country; e.g. UK Dependent Street. |
av.DependentThoroughfarePreDirection |
The prefix directional contained within the DependentThoroughfare field. E.g. if DependentThoroughfare contains "N MAIN ST" DependentThoroughfarePreDirection will contain "N". |
av.DependentThoroughfareLeadingType |
The leading thoroughfare type indicator within the DependentThoroughfare field. E.g. if DependentThoroughfare contains "RUE DE LA GARE" DependentThoroughfareLeadingType will contain "RUE". |
av.DependentThoroughfareName |
The name indicator within the DependentThoroughfare field. E.g. if DependentThoroughfare contains "N MAIN ST" DependentThoroughfareName will contain "MAIN". |
av.DependentThoroughfareTrailingType |
The trailing thoroughfare type indicator within the DependentThoroughfare field. For instance, if DependentThoroughfare contains "N MAIN ST" DependentThoroughfareTrailingType will contain "ST". |
av.DependentThoroughfarePostDirection |
The postfix directional contained within the DependentThoroughfare field. E.g. if DependentThoroughfare contains "MAIN ST N" DependentThoroughfarePostDirection will contain "N". |
av.Building |
The descriptive name identifying an individual location. |
av.BuildingLeadingType |
The leading building type indicator within the Building field. E.g. if Building contains "BLOC C" BuildingLeadingType will contain "BLOC". |
av.BuildingName |
The name indicator within the Building field. E.g. if Building contains "WESTMINSTER HOUSE" BuildingName will contain "WESTMINSTER". |
av.BuildingTrailingType |
The trailing building type indicator within the Building field. E.g. if Building contains "WESTMINSTER HOUSE" BuildingTrailingType will contain "HOUSE". |
av.Premise |
The alphanumeric code identifying an individual location. |
av.PremiseType |
The leading premise type indicator within the Premise field. E.g. if Premise contains "Plot 7/7A" PremiseType will contain "Plot". |
av.PremiseNumber |
The alphanumeric indicator within the Premise field. For instance, if Premise contains "Plot 7/7A" PremiseNumber contains "7/7A". |
av.SubBuilding |
The secondary identifiers for a particular delivery point, e.g. "FLAT 1" or "SUITE 212". |
av.SubBuildingType |
The leading sub-building type indicator within the SubBuilding field. E.g. if SubBuilding contains "FLAT 1" SubBuildingType will contain "FLAT". |
av.SubBuildingNumber |
The alphanumeric indicator within the SubBuilding field. E.g. if SubBuilding contains "FLAT 1" SubBuildingNumber will contain "1". |
av.SubBuildingName |
The descriptive name within the SubBuilding field. E.g. if SubBuilding contains "BASEMENT FLAT" SubBuildingName will contain "BASEMENT FLAT". |
av.PostalCode |
The complete postal code for a particular delivery point. |
av.PostalCodePrimary |
The primary postal code used for a particular country; e.g. USA Zip, Canadian Postcode or Indian PINcode. |
av.PostalCodeSecondary |
Secondary postal code information; e.g., USA Zip Plus 4. |
av.Organization |
The business name associated with a particular delivery point. |
av.OrganizationName |
The name indicator within the Organization field. E.g. if Organization contains 'Loqate Inc" OrganizationName will contain "Loqate", if a sufficient level of parsing detail exists for the country. |
av.OrganizationType |
The trailing type indicator contained within the Organization field. E.g. if Organization contains "Loqate Inc" OrganizationType will contain "Inc", if a sufficient level of parsing detail exists for the country. |
av.PostBox |
The type indicator contained within the PostBox field. E.g. if PostBox contains "PO BOX 1234" PostBoxType will contain "PO BOX", if a sufficient level of parsing detail exists for the country. |
av.PostBoxNumber |
The alphanumeric indicator within the PostBox field. E.g. if PostBox contains "PO BOX 1234" PostBoxNumber will contain "1234", if a sufficient level of parsing detail exists for the country. |
av.Latitude |
The WGS 84 latitude in decimal degrees format. |
av.Longitude |
The WGS 84 longitude in decimal degrees format. |
av.DeliveryAddress |
The full address minus the Organization, Locality hierarchy, AdministrativeArea hierarchy and PostalCode hierarchy fields, correctly formatted for mailing in the relevant country, including line breaks specified using the AddressLineSeparator option. |
av.Geodistance |
The possible radius in meters of Geocoding results that have been calculated as the average of multiple points. |
av.Contact |
The contact name. |
av.Function |
The function or job title. |
av.Department |
Organizational department information. |
av.Unmatched |
Any words that could not be matched to a particular address component. |
avverify.amas.DPID |
Delivery Point Identifier: a unique 8-digit number which is assigned for every new address to the source address database |
avverify.amas.FloorType |
Type of floor or level |
avverify.amas.FloorNumber |
Floor or level number (which can include alpha characters) |
avverify.amas.LotNumber |
Allotment number |
avverify.amas.PostBoxNum |
Postal delivery number if the address is a postal delivery type |
avverify.amas.PostBoxNumberPrefix |
Postal delivery number prefix related to the postal delivery number |
avverify.amas.PostBoxNumberSuffix |
Postal delivery number suffix related to the postal delivery number |
avverify.amas.PrimaryPremise |
Thoroughfare number for a property (first number in a property ranged address) |
avverify.amas.PrimaryPremiseSuffix |
Suffix for the thoroughfare number |
avverify.amas.SecondaryPremise |
Second thoroughfare number (only used if the property has a ranged address. For example, 23-25) |
avverify.amas.SecondaryPremiseSuffix |
Suffix for the second thoroughfare number |
avverify.amas.PreSortZone |
Also known as Barcode Sort Plan (BSP) number. One of 54 individual sort regions around Australia. To qualify for Australia Post's PreSort Letters Service, letters must be sorted based on this number. |
avverify.amas.PrintPostZone |
Also known as a PreSort Indicator. To qualify for Australia Post's Print Post Service, letters must be sorted based on this number. |
avverify.amas.Barcode |
Barcode based on the DPID |
avverify.amas.PrimaryAddressLine |
Primary address line in standardized format |
avverify.amas.SecondaryAddressLine |
Secondary address line in standardized format |
avverify.cass.AutoZoneIndicator |
Automated Zone Indicator, where
|
avverify.cass.CarrierRoute |
Carrier route code assigned to a mail delivery or collection route within a 5-digit ZIP Code, also referred to as CRID. There are 5 types:
|
avverify.cass.CMRAIndicator |
Indicates whether the address is associated with a Commercial Mail Receiving Agency(CMRA).
|
avverify.cass.CongressionalDistrict |
The congressional district to which the address belongs |
avverify.cass.DefaultFlag |
A value of "Y" indicates that the record matched to a high rise default, rural route default, or street default record in the ZIP+4 file. |
avverify.cass.DeliveryPointBarCode |
3-digit code which consists of the 2-digit delivery point code and 1-digit check digit.This is used to create the 12-digit POSTNET barcode which consists of the 5-digit ZIP Code, 4-digit ZIP+4 addon code, and this 3-digit code. |
avverify.cass.DPVConfirmedIndicator |
Indicates the deliverability of the address using one of the following values:
|
avverify.cass.DPVFootnotes |
Delivery Point Validation footnotes. This field is used with the DPVConfirmedIndicator field determine the input address' validity and deliverability.
|
avverify.cass.eLOTCode |
eLOT directional indicator. See the eLOTNumber field for additional information. Values:
|
avverify.cass.eLOTNumber |
A 4-digit sequence number for eLOT (Enhanced Line of Travel). This number combined with the eLOTCode field is used in mail sorting. eLOT processing may be used by mailers to qualify for enhanced carrier route presort discounts. |
avverify.cass.EWSFlag |
A value of "Y" indicates that the address matched a record in the EWS (Early Warning System) file, thus resulting in a ZIP+4 no match |
avverify.cass.FalsePositiveIndicator |
The False Positive table flags the False Positive addresses. This flag determines whether a mailing list is being generated or created during validation. The USPS does not allow creating a mailing list through DPV certification.
|
avverify.cass.FIPSCountyCode |
A 5-digit FIPS (Federal Information Processing Standard) code which uniquely identifies counties. |
avverify.cass.Footnotes |
Footnote string
|
avverify.cass.LACSLinkCode |
Code returned by LACSLink after querying the LACSLink database.
|
avverify.cass.LACSLinkIndicator |
Indicator returned by LACSLink after querying the LACSLink database.
|
avverify.cass.LACSStatus |
A value of "L" indicates that the input address matched an entry in the Locatable Address Conversion Service database and the input address has been converted from a rural-style address to a city-style address. |
avverify.cass.NoStatIndicator |
Indicates the address is not receiving delivery, and the address is not counted as a possible delivery. These addresses are not receiving delivery because 1) delivery has not been established; 2) customer receives mail as a part of a drop; or 3) the address is no longer a possible delivery because the carrier destroys or returns all of the mail.
|
avverify.cass.PMBNumber |
Parsed PMB number following the PMB designator |
avverify.cass.PMBType |
Parsed Private Mailbox (PMB) designator |
avverify.cass.PrimaryAddressLine |
Primary delivery address line. This can include any of the following:
|
avverify.cass.RecordType |
Record type of address that is confirmed as a valid delivery address. Values:
|
avverify.cass.ReturnCode |
|
avverify.cass.ResidentialDelivery |
This field indicates whether the input address is a residential address or a business address. Values:
Note: This field is only available if RDI data pack is installed together with CASS. |
avverify.cass.SecondaryAddressLine |
Secondary delivery address line (if present). |
avverify.cass.SUITELinkFootnote |
Code returned by SuiteLink after querying the SuiteLink database. Values:
|
avverify.cass.VacantIndicator |
Indicates that the delivery point was active in the past, but is currently vacant (in most cases, unoccupied over 90 days) and is not receiving deliveries. Values:
|
avverify.serp.SerpStatusEx |
V (Valid) C (Correctable): Correctable fields will have been corrected to their right values in the output. N (Invalid) |
avverify.serp.Questionable |
QR (for "Questionable-Rural") QU (for "Questionable-Urban") Empty - the address is not questionable. |
avverify.serp.DeliveryInstallationAreaName |
Station/Postal Installation Area Name |
avverify.serp.DeliveryInstallationType |
Station/Postal Installation/Outlet Type |
avverify.serp.DeliveryInstallationQualifierName |
Name of the Postal Installation |
avverify.serp.RouteType |
The type of a Route Address: Rural Route, Military Route etc. |
avverify.serp.RouteNumber |
Identifies Route Number for a Route Address |
avverify.serp.AdditionalContentType |
Contains Site Or Compartment Specifier |
avverify.serp.AdditionalContentNumber |
Contains Site or Compartment Number |
Flags
Flag Name | Details |
---|---|
av.AccuracyCode |
A code that indicates how accurately each address has been identified and matched. Note: For the multiple output options (Verify: Allow Multiple Results and Search), an Accuracy Code is returned for each result found. |
av.ResultCount |
Number of addresses returned. Always "1" for Verify mode. |
av.MatchScore |
The match between the input and the closest reference match, expressed as a percentage. This is extracted from the Accuracy code. |
av.GeoAccuracy |
A code that indicates whether one or more Geocodes associated with the address have been identified. |
Note:
If the Returned field status flag? option on the Options tab of the processor is set to Yes, an additional flag will generated for each output attribute, with a numeric value indicating the verification status of each one.
Code | Description |
---|---|
0 |
Not Applicable: Field is not applicable to return field status. |
1 |
Verified No Change: Field has been verified using relevant reference data, no changes were needed. |
2 |
Verified Alias Change: Field has been verified using relevant reference data, an alias change was made during parsing (see 7: Identified Alias). |
3 |
Verified Small Change: Field has been verified using relevant reference data, a small spelling change was made. |
4 |
Verified Large Change: Field has been verified using relevant reference data, a large spelling change was made. |
5 |
Added: Field has been added using relevant reference data. |
6 |
Identified No Change: Field has been identified using relevant lexicon data, no changes were needed. e.g. an input value of "PO Box 1234" may be identifiable as a PostBox, but if it is unable to be verified then status 6 will be returned. |
7 |
Identified Alias: Field has been identified using relevant lexicon data, an alias change was made. e.g. an input value of 'Avnue' may be identifiable as an alias to the ThoroughfareType 'Ave'. |
8 |
Identified Context: Field has been identified using relevant context rules. e.g. an input Address of "123 sdovnsdv San Bruno CA USA" may identify the word "sdovnsdv" as a Thoroughfare, but only because of the context in which it appears (after an identifiable Premise Number, and before an identifiable Locality). |
9 |
Empty: Field is empty. |
10 |
Unrecognized: Field is unrecognized. |
AccuracyCode
This code consists of the following components:
A. Verification status - The level of verification.
-
V: Verified - A complete match was made between the input data and a single record from the available reference data.
-
P: Partially verified - A partial match was made between the input data and a single record from the available reference data.
-
U: Unverified - Unable to verify. The output fields will contain the input data.
-
A: Ambiguous - More than one close reference data match.
-
C: Conflict - More than one close reference data match with conflicting values.
-
R: Reverted - Record could not be verified to the specified minimum acceptable level. The output fields will contain the input data.
B. Post-processed verification match level - The extent to which the input data matches the available reference data following the verification process.
-
5: Delivery Point (PostBox or SubBuilding).
-
4: Premise (Premise or Building).
-
3: Thoroughfare.
-
2: Locality.
-
1: Administrative Area.
-
0: None.
C. Pre-processed verification match level - The extent to which the input data matches the available reference data prior to the verification process.
-
5: Delivery Point (PostBox or SubBuilding).
-
4: Premise (Premise or Building).
-
3: Thoroughfare.
-
2: Locality.
-
1: Administrative Area.
-
0: None.
D. Parsing status - Whether it has been possible to parse all the data.
-
I: Identified and Parsed - Input data has been able to be identified and placed into components
-
U: Unable to parse - Not all input data has been able to be identified and parsed.
E. Lexicon identification match level - The level to which the input data has a recognized form through pattern and lexicon matching.
-
5: Delivery Point (PostBox or SubBuilding).
-
4: Premise (Premise or Building).
-
3: Thoroughfare.
-
2: Locality.
-
1: Administrative Area.
-
0: None.
F. Context identification match level - The context identification match level gives the level to which the input data can be recognized based on the context in which it appears.
-
5: Delivery Point (PostBox or SubBuilding).
-
4: Premise (Premise or Building).
-
3: Thoroughfare.
-
2: Locality.
-
1: Administrative Area.
-
0: None.
G. Postcode status - The extent to which the postcode has been verified.
-
P8: PostalCodePrimary and PostalCodeSecondary verified.
-
P7: PostalCodePrimary verified, PostalCodeSecondary added or changed.
-
P6: PostalCodePrimary verified.
-
P5: PostalCodePrimary verified with small change.
-
P4: PostalCodePrimary verified with large change.
-
P3: PostalCodePrimary added.
-
P2: PostalCodePrimary identified by lexicon.
-
P1: PostalCodePrimary identified by context.
-
P0: PostalCodePrimary empty.
H. Matchscore - The similarity between the input data and closest reference data match as a percentage between 0 (no match) and 100 (perfect match).
GeoAccuracy
Also known as the Geocode, this flag consists of two values:
Value | Description | Settings |
---|---|---|
Geocoding Status |
Indicates whether a Geocode for the address has been found. |
P: Point - A single geocode was found matching the input address I: Interpolated - A geocode was interpolated from the input address's location in a range A: Average Multiple - Candidate geocodes were found to match the input address, and an average of these was returned U: Unable to geocode - A geocode was not able to be generated for the input address |
Geocoding Level |
Indicates the geographical accuracy of the Geocode. |
5: Delivery Point (PostBox or SubBuilding) 4: Premise (Premise or Building) 3: Thoroughfare 2: Locality 1: Administrative Area 0: None |
Execution
Execution Mode | Supported |
---|---|
Batch |
Yes |
Real-Time Monitoring |
Yes |
Real-Time Response |
Yes |
Results Browsing
The Address Verification processor presents no summary statistics on its processing.
In the Data view, each input attribute is shown with the output attributes to the right.
Output Filters
None.