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.
|
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.
|
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.
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
|
UseRelaxedSecondaryMatching |
Specifies whether input addresses with secondary information are matched to records without secondary information. This option applies only to Florida-native files.
|
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.
|
GsSearchArea |
The search area options allow for searching the address' finance area or an expanded area specified by distance.
|
GsSearchRadius |
Radius for search area.
|
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.
|
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.
|
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.
|
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:
|
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 |