Return Values

In the Return Values category, you can select the fields you would like returned with your match. The following sections cover the global defaults return values, which are available for all countries, and the country-specific return values, which apply to a subset of countries.

In Management Console, you can set up country-specific overrides for some of the global defaults. See Setting Country Overrides for details about setting up these overrides.

Global Defaults

Option Name Country Support Description
Return all available information All When enabled, returns all available return fields and all available options, including any country-specific options are enabled. When disabled, allows you to selectively choose the return fields listed below. Default = disabled.
Quality Descriptors
Returns the result codes. The result codes indicate how well the input address matched to a known address and assigned a location. They also describe the overall status of a match attempt. For all countries, see Global Result Codes. The USA has additional result codes. For details, see Match and Location Codes for USA.
Parsed Address
Returns the separate address fields, such as mainAddressLine, areaName<1-4>, postcodes and country. The meaning of some of these fields may vary by country. For a list of the returned parsed address fields and their definitions, refer to your country's section in Appendix A - Country-Specific Information.
Point
Returns the latitude/longitude coordinates of the input address.
Max results to be returned   Select a number. The default is 10 and maximum is 100.

Country-Specific Return Values

Option Name Country Support Description
  AUS Australia has the following additional return field options:
Use abbreviated types
Returns the abbreviated street types instead of the default of fully spelled-out type.
Street frontage
Coordinates returned from the GNAF geocoding dataset can be returned as standard points or as street frontage points. The standard points are the most precise (rooftop) points available and are returned by default. This option returns points that have been relocated to the frontage of the candidate location. This is generally preferable for routing applications.
Original Point
Returns the GNAF original latitude/longitude coordinates, or if applicable, the original latitude/longitude coordinates from a User Dictionary.
Level and Lot
Returns the address level type and number and address lot identifier.
GNAF Identifiers
Returns the following GNAF identifier fields - GNAF PID, Principal PID, Meshblock ID, Geocontainment, Geofeature, Address class, SA1, and Parcel ID - from a match to the GNAF National Address File geocoding dataset.

For detailed descriptions of these output fields, see the Custom Output Fields section of Australia (AUS).

  CAN Canada has the following additional return field options:
Formatted range
Returns the formatted range for the address.
Note: This field is only returned for postal centroid candidates.
Census
Returns the following Census fields for the matched address location: Centrus Tract (CT), Census Metropolitan Area (CMA), Census Division (CD), Census Subdivision (CSD), and Census Dissemination Area (DA).

For detailed descriptions of these output fields, see the Custom Output Fields section of Canada (CAN).

  IND India has the following additional return field options:
Rural status
Indicates when the candidate's address is located in a rural region (village).
POI category
Point of interest category. This return field describes the type of POI, such as a bank, ATM, or restaurant.
Block
Returns block information.
Sublocality
Returns the municipal division below locality (areaName4) level.

For detailed descriptions of these output fields, see the Custom Output Fields section of India (IND).

  ITA Italy has the following additional return field options:
Historical post code
Where applicable, returns the previous postal code for the address.
  JPN Japan has the following additional return field options:
Jusho code
Returns a point ID that represents a unique address.
Address Data
Returns the chooaza, chomoku, go, and banchi address fields.

For detailed descriptions of these output fields, see the Custom Output Fields section of Japan (JPN).

  NZL New Zealand has the following additional return field options:
UFI
Returns the New Zealand UFI. The Unique Identifier (UFI) identifies the street segment that the geocoded address belongs to. UFIs are up to 7-digit numbers, assigned by New Zealand Post, that uniquely identify each postal delivery point.
Mesh block
Returns the New Zealand Meshblock identifier. A Meshblock is the smallest geographic unit for which statistical data is collected by Statistics New Zealand. Meshblocks vary in size from part of a city block to large areas of rural land.
Aliased suburb
Returns the New Zealand Aliased suburb. An alternative to the officially-recognized suburb name.
Original Point
Returns the original latitude and longitude coordinates.

For detailed descriptions of these output fields, see the Custom Output Fields section of New Zealand (NZL).

Mixed case output addresses USA The output data is returned in mixed case. Default = disabled. When not selected, the output data is returned in upper case. Not enabled when Return all available information is selected.
Output corrected last line USA Corrects the elements of the output lastline, providing a good ZIP Code or close match on the soundex even if the address did not match or was non-existent. Default = disabled. Not enabled when Return all available information is selected.
Return coordinates as integer USA Returns the latitude and longitude values in integer format, not decimal format. Default = disabled. Not enabled when Return all available information is selected.
  USA The USA has the following additional return field options:
Centerline
Returns information about a centerline match which includes additional data about the geocode's parent street segment.
Intersection
Returns information resulting from a match to an intersection.
Census
Census output fields contain U.S. Census information about the address.
DPV
DPV® data output fields contain information about a match made using DPV® data. These field values are only returned when matching against DPV® data. Default = disabled.
LACS
Provides the USPS® Locatable Address Conversion System results. LACS corrects addresses that have changed as a result of a rural route address converting to street-style address, a PO Box renumbering, or a street-style address changing. Default = disabled.
Suitelink
SuiteLink is a Postal Service™-maintained database of business addressing information, which will add known secondary (suite) information. SuiteLink uses the input business name, street number location, and 9 digit ZIP+4 to return a unit type (i.e. "STE") and unit number for that business. Default = disabled.
Note: Ignored in Exact match mode.
Postal
Postal data output fields contain detailed postal information for the address, such as the preferred city name and the US carrier route.
Short Address
Short address output fields contain abbreviated address fields.
Segment
Segment output fields contain information on the street segment identified by the data provider.
Others
Returns additional information about the match.

For detailed descriptions of these output fields, see the Custom Output Fields section of United States (USA).

  XWG The World Geocoder has the following additional return field options:
City Rank
Returns the city ranking from 1 (highest) to 10 (lowest). Zero (0) means that a rank was not available.