Output

Global Address Validation output is determined by the output options you select.

Standard Address Output

Standard address output consists of address lines which correspond to how the address would appear on an address label. City, state or province, postal code, and other data are also included in the standard address output.

Table 1. Standard Address Output
Field Name Format Description
AdditionalInputData String Additional input data entered that was not used for matching.
AddressBlock1-2 String The AddressBlock output fields contain a formatted version of the standardized or normalized address as it would be printed on a physical mailpiece. Global Address Validation formats the address into address blocks using postal authority standards. Each line of the address is returned in a separate address block field. There can be up to two address block output fields: AddressBlock1 and AddressBlock2.

AddressBlock1 includes:

  • PO Box—CAN, FRA, GBR
  • Firm Name
  • Unit Number
  • Unit Type
  • House Number
  • Street Name

AddressBlock2 includes:

  • Locality
  • Town
  • Postal Code
  • County
  • State

For example, this input address:

AddressLine1: 34 Glenview Road
City: Mount Kurning-Gai StateProvince: NSW PostalCode: 2080

Results in this address block output:

AddressBlock1: 34 Glenview Road
AddressBlock2: Mount Kurning-Gai NSW 2080

In this example, the input address includes a PO Box (CAN, FRA, and GBR) and the "Prefer PO Box over street" option is selected:

AddressLine1: 1 Great Lawn PO Box 10916 CM5 5AL

Results in this address block output:

AddressBlock1: PO Box 10916
AddressBlock2: ONGAR CM5 5AL

AddressLine1 String The first address line.

For example, 34 GLENVIEW ROAD MOUNT KURNING-GAI NSW 2080.

In an example of a dual address, the address PO BOX 3220 STN C 181 QUEEN STREET OTTAWA ON K1Y1E4 contains both a PO Box and a street address.

If the option "Prefer PO Box over street" is enabled, PO BOX 3220 STN C displays in this field.

If the option "Prefer PO Box over street" is not enabled, 181 QUEEN STREET displays in this field.

Global Address Validations supports PO Box matching for these countries:

  • Canada (CAN)
  • France (FRA)
  • United Kingdom (GBR)
ApartmentLabel String The flat or unit type. For example, 39 Acacia Avenue Flat B.
ApartmentNumber String The flat or unit number. For example, 39 Acacia Avenue Flat B.
Building String The name of a building.
City String The city or town name. Your input address should use the official city name to produce the best match results.
City.Matched String The status of the city match.
True
Matched on the city name.
False
Did not match on the city name.
CitySubdivision String The name of one of the following depending on the country:
  • Not used—AUS, AUT, BEL, CHE, DEU, DNK, FIN, FRA, IRL, MYS, NLD, NOR, POL, SWE
  • Dissemination Area and Enumeration Area (DA and EA)—CAN
  • Locality—BRA, GBR, GRC, ITA, ESP
  • Suburb—NZL
CitySubdivision.Matched String The status of the match on city subdivision.
True
Matched on the city subdivision.
False
Did not match on the city subdivision.
Confidence String The level of confidence assigned to the address being returned. Range is from zero (0) to 100. Zero indicates failure. 100 indicates a very high level of confidence that the match results are correct.
Country String The country in the language or code specified in the Country format option. For a list of ISO codes, see ISO Country Codes and Coder Support.
Country specific fields String The country specific output information. To include the country specific output information in the output, check the Country specific fields output option.
FirmName String The name of a company.
Firmname.Matched String The status of the match on firm name.
True
Matched on the firm name.
False
Did not match on the firm name.
HouseNumber String The house number or PO Box number (CAN, FRA, UK). For example, 39 Acacia Avenue or PO Box 3220.
Housenumber.Matched String The status of the match on house number.
True
Matched on the house number.
False
Did not match on the house number.
LeadingDirectional String The leading directional. For example, 123 E Main St Apt 3.
MatchOnAllStreetFields String The status of the match on all street fields.
True
Matched on all street fields.
False
Did not match on all street fields.
MatchOnStreetDirectional String The status of the match on street directional.
True
Matched on the street directional.
False
Did not match on the street directional.
MultimatchCount String If the address was matched to multiple candidate addresses in the reference data, this field contains the number of candidate matches found.
PostalCode String The postal code for the address. The format of the postal code varies by country.
PostalCode.AddOn String The second part of a postal code. This field is not used by most countries.
Postalcode.Matched String The status of the match on postal code.
True
Matched on the postal code.
False
Did not match on the postal code.
Principality String An area within a country. For example, England, Scotland, and Wales are principalities. This field will normally be blank.
ProcessedBy String The Global Addressing Module stage name.
StateProvince String The name of one of the state or province depending on the country:
  • Not used—BEL, CHE, DNK, IRL, NLD, NOR
  • Bundesland—DEU
  • Province—CAN
  • Province (voivodship)—POL
  • Region—AUT, ESP, FRA, GBR, GRC, NZL
  • Region (län)—FIN
  • Region (lan)—SWE
  • State—AUS, BRA
  • State (negeri)—MYS
StateProvince.Matched String The status of the match on state or province.
True
Matched on the state or province.
False
Did not match on the state or province.
StateProvinceSubdivision String The name of the state or province subdivision depending on the country.
  • Not used—AUT, BRA, CAN, FIN, GBR, MYS
  • Department—FRA
  • District—GRC
  • District (fylke/counties)—NOR
  • District (poviat)—POL
  • Kommun—SWE
  • Kreis—DEU
  • Local Government Authority (LGA)—AUS
  • Province—BEL, CHE, DNK, ESP, IRL, ITA, NLD
  • Region—NZL
StateProvinceSubdivision.Matched String The status of the match on state or province subdivision.
True
Matched on the state or province subdivision.
False
Did not match on the state or province subdivision.
StreetName String The name of street where the property is located or "PO Box" to indicate the input record matched to a PO Box. For example, 123 E Main St or PO Box 3220.
StreetName.Matched String The status of the match on street name.
True
Matched on the street name.
False
Did not match on the street name.
StreetType String The street type. For example, 123 E Main St Apt 3. In another example, 123 E Main Ave Apt 3. These are two entirely different entities. Using street types adds precision to your data.
StreetType.Matched String The status of the match on street type.
True
Matched on the street type.
False
Did not match on the street type.
TrailingDirectional String The trailing directional. For example, 123 Pennsylvania Ave NW.
Vendor Code String The vendor code. This field is only available if you select the output option "Country specific fields".

Parsed Input

The output can include the input address in parsed form. This type of output is referred to as "parsed input." Parsed input fields contain the address data that was used as input regardless of whether or not Global Address Validation validated the address. This information is not available when the address is validated at the postal / city level . It is available when an address gets validated at the street level. To include parsed input fields in the output, check the Parsed address output option.

Table 2. Parsed Input
Field Name Format Description
DualAddressParsed.Input String A dual address is an address that contains more than one mailable address. For example, an address that contains both a PO Box and a street address is considered a dual address. When a dual address line is entered as input, this field contains the address line that is not used for AddressBlock1.

If a PO Box (CAN, FRA, and UK) and a street address are entered as input and the option "Prefer PO Box over street" is enabled, the PO Box number is returned in the AddressLine1 field and AddressBlock1 fields and the street address is returned in the DualAddressParsed.Input field.

If a PO Box (CAN, FRA, and UK) and a street address are entered as input and the option "Prefer PO Box over street" is not enabled, the street address is returned in the AddressLine1 field and AddressBlock1 fields and the PO Box is returned in the DualAddressParsed.Input field.

ParsedAddressLine1.Input String The first address line passed on input.

For some countries (CAN, FRA, and UK), when the "PO Box over street" option is activated, this field contains PO Box.

ParsedCity.Input String The city/locality/suburb name passed on input.
ParsedCountry.Input String The country passed on input.
ParsedHouseNumber.Input String The house number passed on input. For example, 123 E Main St Apt 3.
ParsedPostCodeAddOn.Input String The second part of a postal code passed on input. This field is not used by most countries.
ParsedPostCodeBase.Input String The postal code passed on input.

For some countries, this field contains the first part of the postal code and the ParsedPostCodeAddOn.Input contains the second part of the postal code.

ParsedPostStreetType.Input String The street type passed on input. For example, 123 E Main St Apt 3.
ParsedStateProvince.Input String The name of one of the state or province depending on the country passed on input.

Precision

The output can include the precision code that describes the precision of the address match for the input address. To include the precision code in the output, check the Precision output option.
Note: The "Precision code counts" section on the Match Analysis Report only displays when you check the "Precision" output option.
Table 3. Precision
Field Name Format Description
PrecisionCode String A code describing the precision of the address match.

The matches in the Z category indicate that a match was made at the postal code level.

Z1
Match to ZIP Code™ or postal code 1.
Z2
Match to ZIP + 2 or partial match to postal code 2.
Z3
Match to ZIP + 4® or postal code 2.

The matches in the G category indicate that the record was matched to an area name.

G1
Match to state/province (area name 1).
G2
Match to country/region (area name 2).
G3
Match to city/town (area name 3).
G4
Match to suburb/village (area name 4).

The matches in the B category indicate that the record was matched to a PO Box.

B1
Matched to an unvalidated PO Box. Although there is enough information in the record to identify this as a PO Box, not enough information exists to determine whether the PO Box number is valid.
B2
Matched to a validated PO Box.

The matches in the S category indicate that the record was matched to a single address candidate.

S0
Single match; however, no coordinates are available. This is a very rare occurrence. Parts of the address may have matched the source data.
S1
Single match to a ZIP Code™ or postal code 1 level. This is the same quality match as a Z1 result.
S2
Single match to a ZIP + 2 or partial match to postal code 2 level. This is the same quality match as a Z2 result.
S3
Single match to a ZIP + 4® or postal code 2 level. This is the same quality match as a Z3 result.
S4
Single match at the street level.
S5
Single match to the street address. Because only the street segment data is available, the interpolation is not as accurate as an S7 return. The S5 code is followed by letters and dashes indicating match precision.
S6
Single match to a point located at a ZIP centroid.
S7
Single match to a street address that was interpolated between houses.
S8
Single match to the street address or house number.
SC
Single match at the house-level that has been projected from the nearest segment.
SG
Single match with point at the center of a locality (areaName3) or Locality level geocode derived from topographic feature. An SG result code is associated with GNAF Reliability Level 5 (locality or neighborhood) or with Level 6 (unique region). (Australia addresses only.)
SL
Single match to a sublocality (block or sector) street level match. An SL result code also requires a match on other geographic input fields (city, district, or state). (India addresses only.)
SX
Single match to a point located at a street intersection.

For S (street matched) precision codes, eight additional characters describe how closely the address matches an address in the database. The characters appear in the order shown.

For example, the result code S5--N-SCZA represents a single match that matched the street name, street suffix direction, town, and postal code. The dashes indicate that there was no match on house number, street prefix direction, or thoroughfare type. The match came from the Street Range Address database. This record would be matched at the street address level of the match candidate.

H
House number match.
P
Street prefix (pre-directional). P is present if any of these conditions are satisfied:
  • The candidate pre-directional matches the input pre-directional.
  • The candidate post-directional matches the input pre-directional after pre- and post-directionals are swapped.
  • The input does not have a pre-directional.
N
Street name match.
T
Street/thoroughfare type match.
S
Street suffix (post-directional).
  • The candidate post-directional matches the input post-directional.
  • The candidate pre-directional matches the input post-directional after pre- and post-directionals are swapped.
  • The input does not have a post-directional.
C
City or town name.
Z
Postal code match.
A
Addressing dataset match.
U
Custom user dictionary match.

Single Match 'S' Precision Codes

The following table shows the support for the S category precision codes by country. For more information on the 'S' precision codes, see Output These descriptions apply to the vast majority of the countries. The exceptions for Australia and Canada are described in the sections that follow this table.

A bullet "•" indicates the S code is supported. A blank cell indicates the S code is not supported.

Country Name S8 S7 S6 S5 S4 S3 S2 S1 S0 SX SC SG SL

Australia (AUS)

Canada (CAN)

Denmark (DNK)

Germany (DEU)

Great Britain

(GBR)

India (IND)

New Zealand (NZL)

All other countries

Australia — 'S' Precision Code Descriptions

The following table provides 'S' precision code descriptions for Australia.

Result Code Description
Street level geocoded candidates return a result code beginning with the letter S. The second character in the code indicates the positional accuracy of the resulting point for the geocoded record.
S8 Single match, point located at either the single point associated with an address point candidate or at an address point candidate that shares the same house number. No interpolation is required.
S8.......G The S8.......G result code is used for single matches with GNAF Reliability levels of 1or 2 (the highest level of GNAF Reliability.
S7 Single match, located at an interpolated point along the candidate’s street segment. When the potential candidate is not an address point candidate and there are no exact house number matches among other address point candidates, the S7 result is returned using address point interpolation.
S7.......G The S7.......G result code is used for single matches with GNAF Reliability level of 3.
S5 Single match, point located at a street address position.
S4 Single match, point located at the center of a shape point path (shape points define the shape of the street polyline).
S4.......G The S4.......G result code is used for single matches with a GNAF Reliability level of 4 (associated with a unique road feature.)
S0 Single match, however, no coordinates are available (this is a very rare occurrence).
SX Single match with the point located at street intersection.
SC Single match where the original point has been moved a specified distance (usually along a perpendicular line) toward or away from the associated street segment. This result code can be returned only when both a point geocoding dataset and a street segment geocoding dataset are available and when the centerline offset feature is used.
SG Single match with point at the center of a locality (areaName3) or Locality level geocode derived from topographic feature. An SG result code is associated with GNAF Reliability Level 5 (locality or neighborhood) or with Level 6 (unique region.)

Canada — 'S' Precision Code Descriptions

The following table provides 'S' precision code descriptions for Canada.

Result Code Description
Street level geocoded candidates return a result code beginning with the letter S. The second character in the code indicates the positional accuracy of the resulting point for the geocoded record.
S8 Single match, point located at either the single point associated with an address point candidate or at an address point candidate that shares the same house number. No interpolation is required.
S7 Single match, located at an interpolated point along the candidate’s street segment. When the potential candidate is not an address point candidate and there are no exact house number matches among other address point candidates, the S7 result is returned using address point interpolation.
S5 Single match, point located at a street address position.
S4 Single match, point located at the center of a shape point path (shape points define the shape of the street polyline).
S3 Single match, point located at postal centroid of FSALDU
S1 Single match, point located at postal centroid of FSA
S0 Single match, however, no coordinates are available (this is a very rare occurrence).
SC Single match where the original point has been moved a specified distance (usually along a perpendicular line) toward or away from the associated street segment. This result code can be returned only when both a point geocoding dataset and a street segment geocoding dataset are available and when the centerline offset feature is used.

Input Address

The output can include the input address. To include the input address, check the Input address output option.

Table 4. Input Address
Field Name Format Description
AddressLine1.Input String The first address line passed on input.
City.Input String The city/locality/suburb name passed on input.
CitySubdivision.Input String The city/town subdivision passed on input.
StateProvince.Input String The state/province passed on input.
StateProvinceSubdivision.Input String The state/province subdivision passed on input.
PostalCode.Input String The postal code passed on input.
Country.Input String The country passed on input.
FirmName.Input String The firm name passed on input.

Country Specific Fields

The output can include country specific fields. To include country specific fields in the output, check the Country specific fields output option.

Table 5. Australia (AUS) Country Specific Fields
Field Name Format Description
AUS.GNAF_PARCEL_ID String The GNAF parcel identifier.
AUS.GNAF_PID String The GNAF Persistent Identifier (GNAF PID) is a 14-character alphanumeric string that uniquely identifies each GNAF address. The PID is constructed from a combination of the major address fields of the GNAF Dictionary. For example, GAACT718519668.
AUS.GNAF_PRINCIPAL_PID String The Persistent Identifier of the principal address.
AUS.GNAF_ADDRESS_CLASS String The GNAF address classification.
AUS.GNAF_SA1 String The GNAF Statistical Area Level 1 (SA1) identifier.
AUS.LEVEL_NUMBER String The number of a floor or level in a multi-story building. For example, Floor 2, 17 Jones Street.
Table 6. Canada (CAN) Country Specific Fields
Field Name Format Description
CAN.CENSUS.CD String

The Census Division (CD) in which the address is located. For more information about Census Divisions, see: http://www12.statcan.ca/english/census01/Products/Reference/dict/geo008.htm on the Statistics Canada website.

CAN.CENSUS.CMA String

The Census Metropolitan Area (CMA) in which the address is located. For more information about Census Metropolitan Areas, see http://www12.statcan.ca/english/census01/Products/Reference/dict/geo009.htm on the Statistics Canada website.

CAN.CENSUS.CSD String

The Census Subdivision (CSD) in which the address is located. For more information about Census Subdivisions, see http://www12.statcan.ca/english/census01/Products/Reference/dict/geo012.htm on the Statistics Canada website.

CAN.CENSUS.CT String

The Census Tract (CT) in which the address is located. For more information about Census Tracts, see http://www12.statcan.ca/english/census01/Products/Reference/dict/geo013.htm on the Statistics Canada website.

CAN.CENSUS.DA String

The Dissemination Area (DA) in which the address is located. For more information about Dissemination Areas, see http://www12.statcan.ca/english/census01/Products/Reference/dict/geo021.htm on the Statistics Canada website.

Table 7. India (IND) Country Specific Fields
Field Name Format Description
IND.IS_RURAL String Indicates whether an address is located in a rural region (village).
IND.POI_CATEGORY String Point of interest category. This field describes the type of POI, such as a bank, ATM, or restaurant.
IND.BLOCK_INFORMATION String Block information.
IND.SUBLOCALITY String The municipal division below locality level.
Table 8. Ireland (IRL) Country Specific Fields
Field Name Format Description
IRL.EIRCODE String The Eircode for the address. The Eircode is a seven character alpha-numeric code made up of two parts.
Routing key
The first three characters define a principal post town span of delivery.
Unique Identifier
The last four characters uniquely identify each residential and business address.
Table 9. Italy (ITA) Country Specific Fields
Field Name Format Description
ITA.HISTORICALPOSTCODE String The previous postal code for this address.
Table 10. Japan (JAP) Country Specific Fields
Field Name Format Description
JPN.BANCHI String The block number.
JPN.CHOMOKU String The city block number.
JPN.CHOOAZA String The number for a group of city blocks.
JPN.GO String The house number.
JPN.JUSHO CODE String A point ID that represents a unique address.
Table 11. Netherlands (NLD) Country Specific Fields
Field Name Format Description
NLD.EXTENED_POST_CODE String This field is both an input and output field that supports a 6-digit postal code. The output contains a candidate’s 6-digit postal code if one is available.
Table 12. New Zealand (NZL) Country Specific Fields
Field Name Format Description
NZL.ALIASED_SUBURB String The New Zealand aliased suburb. An alternative to the officially-recognized suburb name.
Table 13. United Kingdom (GBR) Country Specific Fields
Field Name Format Description
GBR.DEPENDENT_STREET_ NAME String The addresses in the United Kingdom may contain two street names: a main street name and dependent street name. Some addresses may not contain a street name at all.
GBR.DEPENDENT_LOCALITY String The dependent locality name. A dependent locality is a large village or district. For example, Wimbledon.
GBR.DOUBLE_DEPENDENT_ LOCALITY String The double dependent locality name. A double dependent locality is a small village or subdistrict.
GBR.HISTORIC_POSTCODE String If the input address contained an old postal code that has been replaced by a new postal code, this field contains the old postal code.
GBR.ALIASED_LOCALITY String A locality that is not part of the postal address.
GBR.OSAPR String The Ordnance Survey Address Point reference (OSAPR). Each address has a unique OSAPR. OSAPRs are always 18 characters long and must start with the letters AP.
GBR.UPRN String The Unique Property Reference Number. The UPRN is a unique identifier that provides a persistent reference to a unique property, regardless of changes in the property name, status, subdivision, use (such as from single occupancy to multiple occupancy), or demolition of the property. All historic, alternative, and provisional addresses are recorded against the same UPRN. The UPRN field is not returned for Northern Ireland addresses.
GBR.RPC String The RPC identifies the positional accuracy of the candidate. The RPC describes the accuracy of the coordinates allocated to the address.