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.
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:
AddressBlock2 includes:
For example, this input address: AddressLine1: 34 Glenview Road Results in this address block output: AddressBlock1: 34 Glenview Road 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 |
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:
|
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.
|
CitySubdivision | String | The name of one of the following depending on the country:
|
CitySubdivision.Matched | String | The status of the match on 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.
|
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.
|
LeadingDirectional | String | The leading directional. For example, 123 E Main St Apt 3. |
MatchOnAllStreetFields | String | The status of the match on all street fields.
|
MatchOnStreetDirectional | String | The status of the match on 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.
|
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:
|
StateProvince.Matched | String | The status of the match on state or province.
|
StateProvinceSubdivision | String | The name of the state or province subdivision depending on the country.
|
StateProvinceSubdivision.Matched | String | The status of the match on 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.
|
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.
|
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.
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
Field Name | Format | Description |
---|---|---|
PrecisionCode | String | A code describing the precision of the address
match. The matches in the
The matches in the
The matches in the
The matches in the
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
|
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.
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.
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. |
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. |
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. |
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.
|
Field Name | Format | Description |
---|---|---|
ITA.HISTORICALPOSTCODE | String | The previous postal code for this address. |
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. |
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. |
Field Name | Format | Description |
---|---|---|
NZL.ALIASED_SUBURB | String | The New Zealand aliased suburb. An alternative to the officially-recognized suburb name. |
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. |