Status Codes - GeoTAX_Premium - 7 - 7.7

GeoTAX Premium for Windows, UNIX/Linux, and z/OS

Product type
Software
Portfolio
Verify
Product family
Geo Addressing
Product
GeoTAX Premium
Version
7.7
Language
English
Product name
GeoTAX Premium
Title
GeoTAX Premium for Windows, UNIX/Linux, and z/OS
Copyright
2023
First publish date
1998
ft:lastEdition
2023-10-19
ft:lastPublication
2023-10-19T16:49:54.924301

The Match, Extended Match and Location Codes are only returned when matching to the Points or Streets data files. These return codes provide detailed information about the status and results of the address matching and geocoding operations. This section describes these codes.

Match Codes

The address matching process returns a Match Code that provides information about the quality of the match. The Match Code indicates the differences between the input address and the reference address to which the address was matched. The match ratings are described in Match codes. This code also defines what elements of an input address were modified, or the reason a match was not made.

Use the following to view the Match Codes:

Batch processing

Refer to the Location for 4-byte Address Match Return Code field specified in the ALOUT parameter card.

Integrator Series API

Refer to the szAMMatchCode element in the GTXOUTPUT Output Structure.

Callable Functions

Refer to the MOA-ADDR-MATCH-CODE field in the Matcher Output Area (MOA).

Extended Match Codes

Extended Match Codes return additional information about any changes in the house number, unit number and unit type fields. In addition, it can indicate whether there was address information that was ignored. The Extended Match Code is only returned for address-level matches (match codes that begin with A, G, H, J, Q, R, S, T or U), in which case a 3rd hex digit is appended to the match code (see Match codes).

When available, the Extended Match Code is returned automatically. Since it is an extension to the Match Code, it is returned in the same location (see the table in the previous section).

Note: A typical match code contains up to 4 characters: a beginning alpha character followed by 2 or 3 hex digits. The third hex digit is only populated for intersection matches or as part of the Extended Match Code.

For information about the 3rd hex digit values for:

“Address information ignored” is specified when any of the following conditions apply:

  • The output address has extra information; for example, a mail stop.

  • The output address has a second address line (Address Line 2).

  • The input address is a dual address (two complete addresses in the input address). For example, “4750 Walnut St. P.O Box 50”.

  • The input last line has extra information that is not a city, state or ZIP Code, and is ignored. For example, “Boulder, CO 80301 USA”, where “USA” is ignored when matching.

The following table contains the description of the Extended Match Code 3rd hex digit return values:

Input Addressline

Output Addressline

Extended Code

Description

4750 WALNUT ST STE 200

4750 WALNUT ST STE 200

0

Matched on all address information on line, including Unit Number and Unit Type if included.

4750 WALNUT ST C/O JOE SMITH

4750 WALNUT ST

1

Matched on Unit Number and Unit Type if included. Extra information on address line ignored. Extra information not considered for matching moved to Address Line 2.

4750 WALNUT ST UNIT 200

4750 WALNUT ST STE 200

2

Matched on Unit Number. Unit Type changed.

4750 WALNUT ST UNIT 200 C/O JOE SMITH

4750 WALNUT ST STE 200

3

Matched on Unit Number. Unit Type changed. Extra information on address line ignored. Extra information not considered for matching moved to Address Line 2.

4750 WALNUT ST STE 2-00

4750 WALNUT ST STE 200

4

Unit Number changed or ignored.

4750 WALNUT ST STE 2-00 C/O JOE SMITH

4750 WALNUT ST STE 200

5

Unit Number changed or ignored. Extra information on address line ignored. Extra information not considered for matching moved to Address Line 2.

4750 WALNUT ST STE 400

4750 WALNUT ST STE 400

6

Unit Number changed or ignored. Unit Type changed or ignored. In this example, Suite 400 is not valid for the input address, but the address match is not prevented because of an invalid unit number.

4750 WALNUT ST UNIT 2-00 C/O JOE SMITH

4750 WALNUT ST STE 200

7

Unit Number changed or ignored. Unit Type changed or ignored. Extra information on address line ignored. Extra information not considered for matching moved to Address Line 2.

47-50 WALNUT ST STE 200

4750 WALNUT ST STE 200

8

Matched on Unit Number and Unit Type if included. House number changed or ignored.

47-50 WALNUT ST STE 200 C/O JOE SMITH

4750 WALNUT ST STE 200

9

Matched on Unit Number and Unit Type if included. House number changed or ignored. Extra information not considered for matching moved to Address Line 2.

47-50 WALNUT ST UNIT 200

4750 WALNUT ST STE 200

A

Matched on Unit Number. Unit Type changed. House Number changed or ignored.

47-50 WALNUT ST UNIT 200 C/O JOE SMITH

4750 WALNUT ST STE 200

B

Matched on Unit Number. Unit Type changed. House Number changed or ignored. Extra information on address line ignored. Extra information not considered for matching moved to Address Line 2.

47-50 WALNUT ST STE 20-0

4750 WALNUT ST STE 200

C

House Number changed or ignored. Unit Number changed or ignored.

47-50 WALNUT ST STE 20-0 C/O JOE SMITH

4750 WALNUT ST STE 200

D

House Number changed or ignored. Unit Number changed or ignored. Extra information on address line ignored. Extra information not considered for matching moved to Address Line 2.

47-50 WALNUT ST UNIT 20-0

4750 WALNUT ST STE 200

E

House Number changed or ignored. Unit Number changed or ignored. Unit Type changed or ignored.

47-50 WALNUT ST UNIT 2-00 C/O JOE SMITH

4750 WALNUT ST STE 200

F

House Number changed or ignored. Unit Number changed or ignored. Unit Type changed or ignored. Extra information on address line ignored. Extra information not considered for matching moved to Address Line 2.

Location Codes

GeoTAX returns location codes that indicate the methodology used to compute the geocode and may also provide some information about the quality of the geocode. The location codes are described in Location codes.

Use the following to view the Location Codes:

Batch processing

Refer to the Location for 4-byte Location Return Code field specified in the LLOUT parameter card.

Integrator Series API

Refer to the szAMLocationCode element in the GTXOUTPUT Output Structure.

Callable Functions

Refer to the MOA-ADDR-LOC-CODE field in the Matcher Output Area (MOA).