Geocode Output

ValidateAddressLoqate returns the latitude/longitude, geocoding match code, dependent and double dependent localities, dependent thoroughfare, subadministrative and superadministrative areas, and the search distance as output. Match codes describe how well the geocoder matched the input address to a known address; they also describe the overall status of a match attempt. Search distance codes represent how close the geocode is to the actual physical location of an address.

Table 1. Geocode Address Output

Response Element

Description

Geocode.MatchCode

This two-byte code reflects the status and level of geocode matching for an address.

The first byte represents the geocoding status and is one of the following:

A
Multiple candidate geocodes were found to match the input address, and an average of these was returned
I
A geocode was able to be interpolated from the input addresses location in a range
P
A single geocode was found matching the input address
U
A geocode was not able to be generated for the input address

The second byte represents the level of geocoding matching and is one of the following:

5
Delivery point (post box or subbuilding)
4
Premise or building
3
Thoroughfare
2
Locality
1
Administrative area
0
None

Latitude

Eight-digit number in degrees and calculated to five decimal places (in the format specified).

Longitude

Eight-digit number in degrees and calculated to five decimal places (in the format specified).

SearchDistance

The radius of accuracy in meters, providing an indication of the probable maximum distance between the given geocode and the actual physical location. This field is derived from and dependent upon the accuracy and coverage of the underlying reference data.

Table 2. City/Street/Postal Code Centroid Match Codes
Element Match Code
Address Point P4
Address Point Interpolated I4
Street Centroid A4/P3
Postal Code/City Centroid A3/P2/A2
Note: Geocode.Match.Code does not return two coordinates for a street segment (such as the beginning and ending of a portion of a street). Instead, with input resulting in return codes of I3 (interpolated to thoroughfare or street level, where no input premise number was provided), the complete street is used in the computation.