Forward Geocoding Result Codes - 23.1

Spectrum Global Geocoding Guide
Product type
Software
Portfolio
Locate
Product family
Spectrum
Product
Spectrum > Geo Addressing > Global Geocoding
Version
23.1
Language
English
Product name
Spectrum Technology Platform
Title
Spectrum Global Geocoding Guide
Copyright
2023
First publish date
2007
Last updated
2024-09-10
Published on
2024-09-10T01:25:02.872726

Result Code General Descriptions

The following table provides general descriptions for the returned result codes.

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. For information on the specific S result codes supported for your country, see Single Match 'S' Result Codes.
S8 Single match with the 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 with the point located at an interpolated point along a street segment. Both a point dictionary and a street segment dictionary must be available. Because known point data is available, the S7 interpolation is more accurate than an S5 result.
S6 Single match, point located at point ZIP centroid.
S5 Single match with the point located at a street address position. Because only street segment data is available, the interpolation is not as accurate as an S7 return The S5 code is followed by letters and dashes indicating match precision.
S4 Single match with the point located at a street centroid.
S3 Single match with the point located at a ZIP + 4® centroid. This is the same quality match as a Z3 result.
S2 Single match with the point located at a ZIP + 2 centroid. This is the same quality match as a Z2 result.
S1 Single match with the point located at a ZIP Code centroid. This is the same quality match as a Z1 result.
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 dictionary and a street segment dictionary are available and when the centerline offset feature is used.
SL India only. A street level match at the sublocality (block or sector) level. A SL result code also requires a match on other geographic input fields (city, district, or state).
Result Code Description

For S (street geocoded) result codes, eight additional characters describe how closely the address matches an address in the database. The characters appear in the order listed in the following table. Any non-matched components are represented by a dash.

For example, the result code S5--N-SCZA represents a single match that matched the street name, street post directional, town and postcode. The dashes indicate that there was no match on house number, street prefix direction, or thoroughfare type. The match came from the Street Range Address database. This record would be geocoded at the street address position of the match candidate.
H House number match.
P

Street prefix (pre-directional).

P is present if any of these conditions are satisfied:

  • The candidate pre-directional matches the input pre-directional.
  • The candidate post-directional matches the input pre-directional after pre- and post-directionals are swapped.
  • The input does not have a pre-directional.
N Street name match.
T Street/thoroughfare type match.
S

Street post-directional

S in result code is present if any of these conditions are satisfied:

  • The candidate post-directional matches the input post-directional.
  • The candidate pre-directional matches the input post-directional after pre- and post-directionals are swapped.
  • The input does not have a post-directional.
C areaName3 match (this is usually the city or town).
Z Postal code match.
A or U Match to Address Dictionary or User Dictionary.
Result Code Description
Matches in the Z category indicate that a match was made at the postcode level. A postcode match is returned in either of these cases:
  • You specified to match to postal code centroids. The resulting point is located at the postal code centroid with the following possible accuracy levels.
  • There is no street level match and you specified to fall back to postal code centroid.
    Note: Refer to the section covering your country to locate the specific meanings of postCode1 & 2.
Z6 Z6 results are matched to a point ZIP centroid. Point ZIPs are 5-digit The Z6 code indicates that these special ZIPs are actual point locations, not an area. Point ZIPs include unique single sites, buildings, or organizations.
Z3 Z3 results are matched to ZIP + 4 or postCode2 centroid locations.
Z2 Z2 results are matched to ZIP + 2 or partial postCode2 centroid locations.
Z1 Z1 results are matched to ZIP Code or (postCode1) centroid locations.
PO Box candidates return a result code beginning with the letter B. PO Box geocoding can be the priority match over streets when the preference PREFER_POBOX_OVER_STREET is set.
B1 B1 results are matched to unvalidated PO Box number
B2 B2 results are matched to a range of PO Boxes
Geographic level geocoded candidates return a result code beginning with the letter G. The numbers following the G in the result code provides more detailed information on the accuracy of the candidate.
Note: Refer to the section covering your country to locate the specific meanings of areaName1-4.
G1 State/Province (areaName1) match with the point located at the state centroid.
G2 County/Region (areaName2) match with the point located at the county centroid.
G3 City/Town (areaName3) match with the point located at the city centroid.
G4 Suburb/village (areaName4) match with the point located at the suburb/village centroid.