OptionsParameters for Options - Spectrum_OnDemand - addressing - web_services - 23.1

Spectrum Web Services Guide

Product type
Software
Portfolio
Integrate
Product family
Spectrum
Product
Spectrum > Web Services
Version
23.1
Language
English
Product name
Spectrum Technology Platform
Title
Spectrum Web Services Guide
First publish date
2007
Last updated
2024-10-17
Published on
2024-10-17T00:33:46.811413
Table 1. Get Candidate Addresses Options

Option Name

optionName

Parameter

Description

Enable U.S. address processing

PerformUSProcessing

Option.PerformUSProcessing

Specifies whether or not to process U.S. addresses. If you enable U.S. address processing Get Candidate Addresses will attempt to retrieve candidate addresses for U.S. addresses. If you disable U.S. address processing, U.S. addresses will fail, meaning they are returned with an "F" in the Status output field. The output field Status.Code will say "DisabledCoder." If you are not licensed for U.S. address processing you must disable U.S. address processing in order for your jobs to complete successfully, regardless of whether or not they contain U.S. addresses.

Note: You must have a valid license for U.S. address processing to successfully process U.S. addresses. If you enable U.S. address processing but are not licensed for this feature, or your license has expired, you will receive an error. If you enable U.S. address processing but are not licensed for this feature, or your license has expired, your entire job will fail.
Y
Yes, process U.S. addresses (default).
N
No, do not process U.S. addresses.

Database

Database.US

Option.Database.US

Specifies the database to be used for U.S. address processing. Only databases that have been defined in the US Database Resources panel in the Management Console are available.

Enable Canadian address processing

PerformCanadianProcessing

Option.PerformCanadianProcessing

Specifies whether or not to process Canadian addresses. If you enable Canadian address processing Get Candidate Addresses will attempt to retrieve candidate addresses for Canadian addresses. If you disable Canadian address processing, Canadian addresses will fail, meaning they are returned with an "F" in the Status output field. The output field Status.Code will say "DisabledCoder." If you are not licensed for Canadian address processing you must disable Canadian address processing in order for your jobs to complete successfully, regardless of whether or not they contain Canadian addresses.

Note: You must have a valid license for Canadian address processing to successfully process Canadian addresses. If you enable Canadian address processing but are not licensed for this feature, or your license has expired, you will receive an error. If you enable Canadian address processing but are not licensed for this feature, or your license has expired, your entire job will fail.
Y
Yes, process Canadian addresses (default).
N
No, do not process Canadian addresses.

Database

Database.Canada

Option.Database.Canada

Specifies the database to be used for Canadian address processing. Only databases that have been defined in the Canadian Database Resources panel in the Management Console are available.

Enable International address processing

PerformInternationalProcessing

Option.PerformInternationalProcessing

Specifies whether or not to process international addresses (addresses outside the U.S. and Canada). If you enable international address processing Get Candidate Addresses will attempt to retrieve candidate addresses for international addresses. If you disable international address processing, international addresses will fail, meaning they are returned with an "F" in the Status output field. The output field Status.Code will say "DisabledCoder." If you are not licensed for international address processing you must disable international address processing in order for your jobs to complete successfully, regardless of whether or not they contain international addresses.

Note: You must have a valid license for international address processing to successfully process international addresses. If you enable international address processing but are not licensed for this feature, or your license has expired, you will receive an error. If you enable international address processing but are not licensed for this feature, or your license has expired, your entire job will fail.
Y
Yes, process international addresses (default).
N
No, do not process international addresses.

Database

Database.International

Option.Database.International

Specifies the database to be used for international address processing. Only databases that have been defined in the International Database Resources panel in the Management Console are available.

Casing

OutputCasing

Option.OutputCasing

Specifies the casing of the output data. One of the following:

Mixed
M
Returns the output in mixed case (default). For example:

123 Main St
Mytown FL 12345

Upper
U
Returns the output in upper case. For example:

123 MAIN ST
MYTOWN FL 12345

Maximum records to return

MaximumResults

Option.MaximumResults

The maximum number of candidate addresses that Get Candidate Addresses should return. The default is 10. The maximum is 10.

Return short city name

OutputShortCityName

Option.OutputShortCityName

For U.S. addresses, specifies whether or not to return the USPS®-approved abbreviation for the city, if there is one. The USPS® provides abbreviations for city names that are 14 characters long or longer. City abbreviations are 13 characters or less and can be used when there is limited space on the mailing label. If there is no short city name for the city, then the full city name is returned.

Y
Yes, return the short city name.
N
No, do not return the short city name.

Dual address match logic

DualAddressLogic

Option.DualAddressLogic

(U.S. addresses only). Controls whether Get Candidate Addresses should return a street match or a PO Box/Rural Route/Highway Contract match when the address contains both street and PO Box/Rural Route/Highway Contract information. For more information, see About Dual Address Logic.

Normal Match
N
(Default) USPS® CASS™ regulations determine the address returned based on the following order of priority:
  1. PO Box
  2. Firm
  3. Highrise
  4. Street
  5. Rural Route
  6. General Delivery
Street Match
S
Return a street match, regardless of the address line.
PO Box Match
P
Return a PO Box match, regardless of the address line.

Street matching

StreetMatchingStrictness

Option.StreetMatchingStrictness

The strictness of the street name match (U.S. addresses only).

Exact
E
The input street name must match the database exactly.
Tight
T
The matching algorithm is "tight."
Medium
M
The matching algorithm is "medium" (default).
Loose
L
The matching algorithm is "loose."

Firm matching

FirmMatchingStrictness

Option.FirmMatchingStrictness

The strictness of the firm name match (U.S. addresses only).

Exact
E
The input firm name must match the database exactly.
Tight
T
The matching algorithm is "tight."
Medium
M
The matching algorithm is "medium" (default).
Loose
L
The matching algorithm is "loose."

Directional matching

DirectionalMatchingStrictness

Option.DirectionalMatchingStrictness

The strictness of the directional match.

Exact
E
The input directional must match the database exactly.
Tight
T
The matching algorithm is "tight."
Medium
M
The matching algorithm is "medium" (default).
Loose
L
The matching algorithm is "loose."

Perform enhanced street matching

PerformESM

Option.PerformESM

Specifies whether or not to perform Enhanced Street Matching (ESM). ESM applies extra matching logic with additional data to any input address that is not matched through the regular address validation process. ESM applies to U.S. addresses only.

Y
Yes, perform ESM processing.
N
No, do not perform ESM processing (default).

Search address lines on fail

AddressLineSearchOnFail

Option.AddressLineSearchOnFail

Specifies whether ValidateAddress will search address lines for the city, state/province, and postal code.

This option enables Validate Address to search the AddressLine input fields for the city, state/province, postal code, and country when the address cannot be matched using the values in the City, StateProvince, and PostalCode input fields.

Consider enabling this option if your input addresses have the city, state/province, and postal code information in the AddressLine fields.

Consider disabling this option if your input addresses use the City, State/Province and PostalCode fields. If you enable this option and these fields are used, there is an increased possibility that Validate Address will fail to correct values in these fields (for example a misspelled city name).

Y
Yes, search the address line fields (default).
N
No, do not search the AddressLine fields.