Result Codes

Result codes contain information about the success or failure of the geocoding attempt, as well as information about the accuracy of the geocode.

Table 1. Result Code Output

columnName

Description

Geocoder.MatchCode

Indicates how closely the input address matches the candidate address.

IsCloseMatch

Indicates whether or not the address is considered a close match. An address is considered close based on the "Close match criteria" options on the Matching tab.

Y
Yes, the address is a close match.
N
No, the address is not a close match.

MultiMatchCount

For street address geocoding, the number of matching address positions found for the specified address.

For intersection geocoding, the number of matching street intersection positions found for the specified addresses.

Status

Reports the success or failure of the match attempt

null
Success
F
Failure

Status.Code

If the geocoder could not process the address, this field will show the reason.

  • Internal System Error
  • No Geocode Found
  • Insufficient Input Data
  • Multiple Matches Found
  • Exception occurred
  • Unable to initialize Geocoder
  • No Match Found

Status.Description

If the geocoder could not process the address, this field will show a description of the failure.

Problem + explanation
Returned when Status.Code = Internal System Error.
Geocoding Failed
Returned when Status.Code = No Geocode Found.
No location returned
Returned when Status.Code = No Geocode Found.
No Candidates Returned
The geocoder could not identify any candidate matches for the address.
Multiple Candidates Returned and Keep Multiple Matches not selected
The address resulted in multiple candidates. In order for the candidate address to be returned, you must specify KeepMultimatch=Y.

LocationPrecision

A code describing the precision of the geocode. One of the following:

0
No coordinate information is available for this candidate address.
1
Interpolated street address.
2
Street segment midpoint.
3
Postal code 1 centroid.
4
Partial postal code 2 centroid.
5
Postal code 2 centroid.
6
Intersection.
7
Point of interest. This is a placeholder value. Spectrum databases do not have POI data, so it is not possible to get this return.
8
State/province centroid.
9
County centroid.
10
City centroid.
11
Locality centroid.
12 - 15 (LocationPrecision codes)
For most countries, LocationPrecision codes 12 through 15 are reserved for unspecified custom items.
13
Additional point precision for unspecified custom item.
14
Additional point precision for unspecified custom item.
15
Additional point precision for unspecified custom item.
16
The result is an address point.
17
The result was generated by using address point data to modify the candidates segment data.
18
The result is an address point that was projected using the centerline offset feature. You must have both a point and a street range database to use the centerline offset feature, and thereby return LocationPrecision 18.

StreetDataType

The default search order rank of the database used to geocode the address. A value of "1" indicates that the database is first in the default search order, "2" indicates that the database is second in the default search order, and so on.