Geocode Outputs

The following table lists the available output fields and their definitions.
Note: Your selected fields will display in the header of your geocoded results file prepended with "out_"; for example, "out X".
Output Field Name Description Applicable for
Default Fields - The following fields will be returned by default.
X Longitude of the candidate. Geocoding
Y Latitude of the candidate. Geocoding
Precision Code A code describing the precision of the geocode.

The possible match categories are as follows:

Postal match with post code 1 centroid.
Postal match with partial post code 2 centroid.
Postal match with post code 2 centroid.
Geographic match with area name 1 centroid.
Geographic match with area name 2 centroid.
Geographic match with area name 3 centroid.
Geographic match with area name 4 centroid.

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

Point located at a street intersection.
Match point located at the house-level that has been projected from the nearest segment.
No coordinates are available, but parts of the address may have matched the source data.
The geocode is located at a street centroid.
The geocode is located at a street address.
The geocode is located at a street address that has been interpolated between point house locations.
Match point located at the house location.
Point/parcel level precision.
Interpolated street level precision.
Street centroid level precision.
PO Box candidates return a result code beginning with the letter B.
B1 results are matched to unvalidated PO Box number.
B2 results are matched to a range of PO Boxes.
Reverse Geocoding
Additional match information is of the format HPNTSCSZA. If a match result was not made for the specified component, a dash (-) will appear in place of a letter.
House number.
Street prefix direction.
Street name.
Street type.
Street suffix direction.
City name.
Post code.
Geocoding dataset.
Source Dictionary Identifies the dictionary that is the source for the candidate information and data. The source dictionary is a 0-based integer value that indicates which configured dictionary the candidate came from. Geocoding/Reverse Geocoding
Country The three-letter ISO 3166-1 Alpha-3 country code. For a listing of the countries and associated ISO country codes, see Supported Countries. Geocoding/Reverse Geocoding
Optional Fields - The following fields may be selected to be returned as desired.
Formatted Street Address The formatted main address line. Geocoding/Reverse Geocoding
Formatted Location Address The formatted last address line. Geocoding/Reverse Geocoding
Place Name The building name, place name, Point of Interest (POI), company or firm name associated with the address. Geocoding/Reverse Geocoding
Area Name 1 The largest geographic area, such as a state, province or region. Geocoding/Reverse Geocoding
Area Name 2 The secondary geographic area, such as a county or district. Geocoding/Reverse Geocoding
Area Name 3 The town or city. Geocoding/Reverse Geocoding
Area Name 4 The city subdivision or locality. For Puerto Rico, the urbanization. Geocoding/Reverse Geocoding
Post Code 1 The postal code in the appropriate format for the country. Geocoding/Reverse Geocoding
Post Code 2 The secondary postal code, if used, in the appropriate format for the country. For USA, the 4-digit ZIP Code extension. Geocoding/Reverse Geocoding
Street Side USA only. Indicates which side of the street the address is located on. One of the following:
The address is on the left side of the street.
The address is on the right side of the street.
The address occupies both sides of the street.
The street side is unknown.
The address did not match a street segment (for example, the address was geocoded to a centroid).
Geocoding/Reverse Geocoding
Range Parity USA only. Indicates the parity of the house number in the range:
Geocoding/Reverse Geocoding
County Name USA only. The county. Geocoding/Reverse Geocoding
Block USA only. The 15-digit census block ID/census FIPS code, using the syntax sscccttttttgbbb where:
  • ss—2-digit State FIPS Code
  • ccc—3-digit County FIPS Code
  • tttttt—6-digit Census Tract FIPS Code (without period)
  • g—Single-digit Block FIPS Code
  • bbb—Block FIPS Code
Geocoding/Reverse Geocoding
Match Code USA only. Match codes indicate the portions of the address that matched or did not match to the reference data. For descriptions of match codes, see USA Match Codes. Geocoding/Reverse Geocoding
MM Result Code The MapMarker result code for the address. See result codes in MapMarker (MM) Result Codes. Geocoding/Reverse Geocoding
LOC Code USA only. Location codes indicate the accuracy of the assigned geocode. For descriptions of location codes, see USA Location Codes. Geocoding/Reverse Geocoding
Datatype Name The data set used to geocode the address. Geocoding/Reverse Geocoding
Precision Level A code describing the precision of the geocode. One of the following:
No coordinate information is available for this candidate address.
Interpolated street address.
Street segment midpoint.
Postal code 1 centroid.
Partial postal code 2 centroid.
Postal code 2 centroid.
Point of interest. (If database contains POI data.)
State/province centroid.
County centroid.
City centroid.
Locality centroid.
Reserved for unspecified custom items.
The result is an address point.
The result was generated by using address point data to modify the candidate's segment data.
The result is an address point that was projected using a centerline offset distance.
Geocoding/Reverse Geocoding
  1. No candidate found: Unable to find a matching candidate for a given input address.
  2. Country not supported: When country is incorrectly mapped or missing in the input. For more information, see Supported Countries
Geocoding/Reverse Geocoding
REVERSE_GEOCODE_DISTANCE Reverse geocode distance. Reverse Geocode
REVERSE_GEOCODE_DISTANCE_UNIT Reverse geocode distance unit. Reverse Geocode
GNAF_PID GNAF unique identifier. Geocoding/Reverse Geocoding
GNAF_CONFIDENCE The confidence level of an address indicates the level of usage of each address by the contributor address datasets. Geocoding/Reverse Geocoding
GNAF_RELIABILITY Refers to the geocode precision and is linked to how the geocode was generated. Geocoding/Reverse Geocoding
GNAF_PARCEL_ID The parcel id. Geocoding/Reverse Geocoding
GNAF_GEOCODE_LEVEL The geocode level type indicates which geocodes have been assigned to an address. Geocoding/Reverse Geocoding
GNAF_ADDRESS_CLASS The geocoded address class. Geocoding/Reverse Geocoding
PreciselyID Unique ID for an addressable location.
Note: PreciselyID was previously known as PB Key.
Geocoding/Reverse Geocoding
LOT_NUMBER The lot number. Geocoding/Reverse Geocoding
GEOCONTAINMENT The geo containment. Geocoding/Reverse Geocoding
GEOFEATURE Characteristic of a feature (e.g. name of an area). Geocoding/Reverse Geocoding
DPV Fields Delivery Point Validation (DPV) validates the address as a known USPS address record. This allows users to identify potential addressing issues that may cause problems with delivery.

To know about DPV output fields and description, see DPV Output Fields.


DPV Output Fields

Note: This option is available for USA only.
Output Fields Name Description


Delivery Point Validation CMRA indicator.

Y: Address found in CMRA table.

N: Address not found in CMRA table

Blank: DPV not loaded.


Indicates if a match occurred for DPV data.

N: Nothing confirmed

Y: Everything confirmed (ZIP+4, primary and secondary)

S: ZIP+4 and primary (house number) confirmed.

D: ZIP+4 and primary (house number) confirmed and a default match (HI_RISE_DFLT = Y), secondary did not confirm.

Blank: Non-matched input address to USPS ZIP+4 data, or DPV data not loaded.


DPV false-positive indicator.

Y: False-positive match found.

Blank: False-positive match not found.


Information about the matched DPV records.

AA: ZIP+4 matched

A1: Failure to match a ZIP+4.

Blank: Address not presented to hash table or DPV data not loaded.


Information about the matched DPV records.

BB: All DPV categories matched.

CC: DPV matched primary/house number, where the secondary/unit number did not match (present but invalid).

M1: Missing primary/house number

M3: Invalid primary/house number.

N1: DPV matched primary/house number, with a missing secondary number.

P1: Missing PS, RR, or HC Box number.

P3: Invalid PS, RR or HC Box number.

F1: All military addresses.

G1: All general delivery addresses.

U1: All unique ZIP Code addresses.

Blank: Address not presented to hash table or DPV data not loaded.
Note: A unique ZIP Code is a ZIP Code assigned to a company, agency, or entity with sufficient mail volume to receive its own ZIP Code.


Information about the matched DPV records.

R1: Matched to CMRA but PMB designator not present.

R2: Matched to CMRA and PMB designator present (PMB 123 or #123).

Blank: Address not presented to hash table or DPV data not loaded.


Y: The address is valid for CDS pre-processing.

N: The address is not valid for CDS pre-processing.

Blank: DPV is not loaded or DPV did not confirm.


Y: Address was found in false-positive table.

N: Address was not found in false-positive table.

Blank: Address was not presented to hash table or DPV data not loaded.


Y: The address is vacant.

N: The address is not vacant.

Blank: DPV is not loaded or DPV did not confirm (so vacancy is irrelevant).