Parameters for Input Data - Spectrum_OnDemand - Latest

Spectrum OnDemand Web Services (SOAP)
Product type
Software
Portfolio
Verify
Product family
Product
Spectrum OnDemand
Version
Latest
Language
English
Product name
Spectrum OnDemand
Title
Spectrum OnDemand Web Services (SOAP)
First publish date
2006

GlobalTypeAhead USCAN takes an address fragment as input, for example, '123 Mai', '123 Main St, Apple', and returns candidate addresses that match the input.

Table 1. GlobalTypeAhead USCAN Input

Parameter

 Format

Description

AddressLine1

String

The firstaddress line. It may contain City, StateProvince or PostalCodeinformation. It is a mandatory field.

Note: The guidelines given below do not apply if you provide City, StateProvince, or PostalCode along with AddressLine1.
  • Include at least two words that are separated by a space. The second word must be at least three characters long. For example, an input of 430 or 4575 Cot, you will get an address in return. However, typing just 430 or 4575 Co will not return an address.
  • The non-numeric string should have five or more characters. For example, an input of Bavarian Way, Cana will return a valid address.

City

String

The city name.

It is only specified when results need to be restricted to acity.

StateProvince

String

The state or province.

It is only specified when results need to be restricted to astate or province.

InstanceKey

String

The InstanceKey is used for usage tracking purposes so that youare only charged each time a user looks up an address and noteach time the service is called.

An instance key can be created by calling theCreateAddressingInstanceKey service before the first time youcall a Global Type Ahead service.

The service will then return an InstanceKey value that is thesame. If it is different, that means the same InstanceKey hasbeen used too long. You should pass this new InstanceKey tosubsequent calls until the user has selected an address orabandoned an address.

Refer to GlobalTypeAhead example that explains the usage of InstanceKey.
Note: If you are entering multiple addresses, such as a separate Ship To and Ship From addresses, these are considered separate address lookups and do not share the same InstanceKey.

PostCode

String

The post code.

Country

String

The country code or name, in any of the formats below:

  • Two-character ISO 3166-1 Alpha 2 country code
  • Three-character ISO 3166-1 Alpha 3 country code
  • English country name

For a list of ISO codes, see ISO Country Codes and Module Support.

The ISO codes are as follows:
  • For Canada, the ISO 3166-1 Alpha-2 code is CA, and ISO 3166-1 Alpha-3 code is CAN.
  • For US, the ISO 3166-1 Alpha-2 code is US, and ISO 3166-1 Alpha-3 code is USA.
Note: This field is mandatory.