You are here: Reference information > Geocoding codes

Geocoding codes

Use the code tables below to better understand what is returned from your geocoding results.

Match codes
Hexadecimal codes
Auto data source match codes
ArcWeb:TI.PhoneNumber.US match codes
Error codes
Place type codes
 

Match codes

These match codes only apply to United States data sources. The auto data source and the data source ArcWeb:TI.PhoneNumber.US return their own set of match codes. See the auto match codes table and the ArcWeb:TI.PhoneNumber.US match codes table for these codes and descriptions.

Code Match code description
Shh Indicates a match found in United States Postal Service (USPS) data. This is considered the best address match because it was matched directly against the USPS list of addresses. See the Hexadecimal codes for the interpretation of the hexadecimal digits.
LA Lookup at the street segment level.
LC Lookup at the city-level using Place Finder Web Service.

LP

Lookup at the state or province level using Place Finder Web Service.

LZ

Lookup at the postal or ZIP code level using Place Finder Web Service.

Xhhh Match found was for an intersection of two streets, for example, "Clay St & Michigan Ave." Note that the USPS does not allow intersections as a valid deliverable address. The first hexadecimal digit refers to the last line information, the second hexadecimal digit refers to the first street in the intersection, and the third hexadecimal digit refers to the second street in the intersection. To decode the hexadecimal digits, see the Hexadecimal codes.
Yhhh Same as Xhhh, but indicates that an alias record for one or both streets was used. The first hexadecimal digit refers to the last line information, the second hexadecimal digit refers to the first street in the intersection, and the third hexadecimal digit refers to the second street in the intersection. To decode the hexadecimal digits, see the Hexadecimal codes.

Hexadecimal codes

These codes only apply to United States data sources.

Code In first hexadecimal position In second and third hexadecimal position
0 No change in last line. No change in address line.
1 ZIP code was changed. Street type was changed.

2

City was changed. Predirectional was changed.
3 City and ZIP code were changed. Street type and Predirectional were changed.
4 State was changed. Postdirectional was changed.
5 State and ZIP code were changed. Street type and Postdirectional were changed.
6 State and City were changed. Predirectional and Postdirectional were changed.
7 State, City, and ZIP code were changed. Street type, Predirectional, and Postdirectional were changed.
8 ZIP+4 was changed. Street name was changed.
9 ZIP and ZIP+4 were changed. Street name and Street type were changed.
A City and ZIP+4 were changed. Street name and Predirectional were changed.
B City, ZIP, and ZIP+4 were changed. Street name, Street type, and Pre-directional were changed.
C State and ZIP+4 were changed. Street name and Postdirectional were changed.
D State, ZIP, and ZIP+4 were changed. Street name, Street type, and Postdirectional were changed.
E State, City, and ZIP+4 were changed. Street name, Predirectional, and Postdirectional were changed.
F State, City, ZIP, and ZIP+4 were changed. Street name, Street type, Predirectional, and Postdirectional were changed.

Auto data source match codes

The following codes are included in the auto data source.

Auto code Auto code description
address House number and street name
street Address range and street name (e.g., 300–457 New York Street)
intersection Street and cross street
city City name
postal code Five-digit ZIP Code
admin area State or province

ArcWeb:TI.PhoneNumber.US match codes

These match codes from ArcWeb:TI.PhoneNumber.US include both an address code and a phone type, for example CAP-POTS. See the Match codes table for code and descriptions returned from other geocoding data sources.

Address Code Address code description
CAP Complete address. Indicates a perfect match found in United States Postal Service (USPS) data.
CAM Complete address. Minor inconsistencies with USPS data.
PAC Partial address. Complete primary with incomplete secondary. Primary contains the house number and street name (for example, 380 New York St) and the secondary contains the city, state, and/or zip code (for example, Redlands, CA 92373).
PAI Partial address. Incomplete primary. Primary contains the house number and street name (for example, 380 New York St).
VUP Valid United States phone number. Only city and state of corresponding telco switch are available.
VPN Valid phone number. No address information is available.
IPN Invalid phone number. Phone number outside North American dialing plan.

Phone Type

Phone type description

POTS Plain old telephone service
IMTS Improved mobile telephone service
FDP Fully dedicated paging
PS Packet switching
FDC Fully dedicated cellular
TC Test code
M Maritime
ATG Air to ground
800S 800 service
900S 900 service
CPP Called pary pays
IPS Information provider service
DA Directory assistance
SCC Special calling cards
OECS Official exchange carrier service
OO Originating only
BO Billing only
800D 800 database
B Broadband

Error code descriptions

Note: Error codes are returned for United States addresses only.

Code

Error code description

E000 No address found by the geocoder.
E001 Low-level error.
E010 No city+state or ZIP Code was found.
E011 Input ZIP was not in the geocoding database.
E012 Input city was not in the geocoding database.
E013 Input city was not unique in the geocoding database.
E020 No matching streets found in the geocoding database.
E021 No matching cross streets for an intersection match.
E022 No matching ranges.
E023 Match is unresolved.
E024 No matching ranges. (Same as E022)
E025 Too many possible cross streets for intersection match.
E026 No address found when attempting a multi-line match.
E027 Invalid directional attempted.
E028 Record also matched Early Warning System (EWS) data, therefore the match was denied.

Place type ID codes

ArcWeb:ESRI.Gazetteer.World

ArcWeb:TA.PopulatedPlaces.US

ArcWeb:GM.PostalCodes.World

ArcWeb:TA.PostalPlaces.US

ArcWeb:TA.Landmarks.US

 

ArcWeb:ESRI.Gazetteer.World

Place type ID code

Place type ID description

Notes

A

Countries

Includes continents

B

Large non-U.S. cities

 

C

Large U.S. cities

 

D

U.S. states

 

E

Non-U.S. administrative areas

Level 1 areas such as states and provinces

F

Medium U.S. cities

 

G

Small U.S. cities

 

H

U.S. counties/parishes

U.S. administrative areas such as counties, parishes, and boroughs.

I

Medium Non-U.S. cities

 

J

Small Non-U.S. cities

 

K

U.S. points of interest

Examples include BLM districts, national forests, national wilderness, national grasslands, national recreation areas, congressional districts, and national scenic areas

M

U.S. ZIP Codes

 

N

Non-U.S. postal codes

 

O

Land features

Examples include desert, mountain, hill, quadrangle, volcano, and cliff

P

Water features

Examples include lake, river, drainage, glacier, reservoir, dam, lagoon, channel, canal, well/spring, bay, fall, salt flat, and seasonal river

Q

Ocean features

Examples include sea, fjord, lagoon, ocean hazard, bay, strait, and estuary

R

Coastal features

Examples include landing, isthmus, point, cape, head, topographic feature, peninsula, and beach

S

Islands

 

T

Airports

 

U

U.S. recreation facilities

Examples include national parks, national wildlife refuges, recreation areas, national historic sites, reservoirs, dams, national forests, lakes, fish hatcheries, national conservation areas, art museums, wildlife sanctuaries, and parkways

ArcWeb:GM.PostalCodes.World

Place type ID code

Place type ID code description

M

U.S. ZIP Codes

N

Non-U.S. postal codes

ArcWeb:TA.Landmarks.US

Place type ID code

Place type ID code description

D10

U.S. ZIP Codes

D31

Hospitals

D37

Prisons

D43

Colleges

D61

Major Retail Centers

D64

Amusement Parks

D65 State Capitols
D67

Stadiums and Performance Areas

D81

Golf Courses (PGA/LPGA)

D82

Veteran Cemeteries

ArcWeb:TA.PopulatedPlaces.US

Place type ID code

Place type ID code description

A

Place

ArcWeb:TA.PostalPlaces.US

Place type ID code

Place type ID code description

A

ZIP Code area. Shows the actual extent of the ZIP code area.

P

ZIP code point. The object parameter GeocodeCandidate.extent is calculated as a buffer of .001 degrees around the point.

 


Visit the Feedback page to give comments or suggestions about the ArcWeb Developer's Guide.

ArcWeb site | ArcWeb support | support.esri.com

Copyright © ESRI