Matching Options

Matching options control the address search methodology and match results handling returned by AssignGeoTAXInfo.

optionName Description

Optional files: The following options enable the database resource(s) to use in the search process.

UseGeoTaxAuxiliaryFile

Specifies whether or not AssignGeoTAXInfo should attempt a match to the GeoTAX Auxiliary file. The GeoTAX Auxiliary file contains new addresses that have not yet been added to the Primary File.

Y
Use the GeoTAX Auxiliary file for matching. (default)
N
Do not use the GeoTAX Auxiliary file for matching.

UseAuxiliaryFile

Specifies whether to attempt a match to a User Auxiliary file. User Auxiliary files are user-defined files that override results from the primary files in street-level matching.

Y
Use the User Auxiliary file for matching.
N
Do not use the User Auxiliary file for matching. (default)

UseStateProvidedFile

Specifies whether to attempt a match to the state-supplied file. Use this option in combination with FileSearchOrder to specify a state-supplied file to use.

State-supplied files are provided by individual state governments. By matching to the state-supplied files, you can remain compliant with tax jurisdiction assignment requirements mandated by new federal and state laws, such as the Mobile Telecommunications Sourcing Act and the Florida state Communications Services Tax Simplification Law.

There are two supported file formats: the Florida-native format and the national TS-158 format (ANSI Transaction Set No. 158). The state of Florida provides address files in both the TS-158 and its own native format.

If this option is enabled, the address is first matched to the state supplied file. If a state match cannot be found, the primary files are used to attempt a match.

Y
Use the State-supplied file for matching.
N
Do not use the State-supplied file for matching. (default)
Note: You must install the appropriate State-supplied file to use these options. For instructions, see the Spectrum Technology Platform Installation Guide.

FileSearchOrder

Specifies which state-supplied file to use. This option only takes effect if you specify UseStateProvidedFile=Y. One of the following:

FLOnly
Use only the Florida-native formatted file. (default)
TSOnly
Use only the TS-158 formatted file.

UseRelaxedSecondaryMatching

Specifies whether input addresses with secondary information are matched to records without secondary information. This option applies only to Florida-native files.

Y
Use relaxed secondary matching.
N
Do not use relaxed secondary matching. (default)
Address Searching and Matching: These options can be enabled for use in the address search and match processes.

GsMatchMode

Match modes determine the leniency used to make a match between your input and the reference database. Select a match mode based on the quality of your input and your desired output. For example, if you have an input database that is prone to errors, you may want to select the relaxed match mode.

0 - Exact
Requires a very tight match. This restrictive mode generates the fewest match candidates, which decreases the processing time. When using this mode, ensure that your input is very clean; free of misspellings and incomplete addresses.
1 - Close
Requires a close match and generates a moderate number of match candidates. (default)
2 - Relaxed
Allows a loose match and generates the most match candidates, which increases the processing time and results in more multiple matches. Use this mode if you are not confident that your input is clean; free of misspellings and incomplete addresses. This is the only mode that does not respect the street parity when making an address match.

GsSearchArea

The search area options allow for searching the address' finance area or an expanded area specified by distance.

1
Searches the entire finance area for a match. A finance area is a region defined by the U.S. Postal Service and typically consists of a set of contiguous ZIP Codes.(default)
2
Searches the area specified by the radius in miles. The search area can be extended up to a 99-mile radius from the centroid of the input ZIP Code to assist in finding a match when the input address contains limited or inaccurate city or ZIP Code information. The expanded area is confined to within the state's borders.

GsSearchRadius

Radius for search area.

1-99 miles
Search radius. (default = 0 miles)

GsEnableFirstLetterExpanded

Looks for the correct first letter of a street address if the first letter is missing or incorrect. Spectrum Enterprise Tax searches through the alphabet looking for possible correct first letters to complete the street address.

Note: This feature is disabled by default and cannot be enabled in Exact mode.
Y
Enable first letter change matches.
N
Do not allow first letter change matches. (default)

GsEnableRangedAddress

Matches to a house range input. Some business locations are identified by address ranges. For example, a shopping plaza could be addressed as 10-12 Front St. - this is how business mail is typically addressed to such a business location. When this feature is enabled, the address range is geocoded to the interpolated mid-point of the range.

Note: This feature is disabled by default and cannot be enabled in Exact mode.
Y
Allow address range matches.
N
Do not allow address range matches. (default)

GsAlternateLookup

This option allows specifying the preferred way to match when both an address and firm name are provided. The matching method can be set to match to the address rather than the firm name or vice versa. If neither are specified, the default matching method is to match to the address line only.

1
Searches for street name, but if there isn't a match, will use the firm name.
2
Looks up the firm name, but if there isn't a match, will use the street name.
3
Searches only street records. (default)

GsMultiMatchResolution

A multi-match occurs when multiple equally-scored matches are found in either the Points or Streets files and cannot be resolved to a single best candidate. There are several choices for handling a multi-match outcome:

N
No matches are returned. (default)
R
Return the first match candidate in the list.
A
The information for all the match candidates is returned.

Specifying Default State-Supplied File Options

If you use the Spectrum Technology Platform API, note that the value you specify in the Management Console for the State supplied file field controls the default settings for three AssignGeoTAXInfo API options: UseStateProvidedFile, UseRelaxedSecondary, and FileSearchOrder. The table below shows how each value in the State supplied file field affects these three options.

"State supplied file" value

UseStateProvidedFile

FileSearchOrder

UseRelaxedSecondary

None

N

N/A

N

Florida-native

Y

FSOnly

N

Florida-native with relaxed secondary matching

Y

FSOnly

Y

TS-158

Y

TSOnly

N