Parameters for Input Data - Spectrum_OnDemand - Latest

Spectrum OnDemand Web Services (REST)

Product type
Software
Portfolio
Verify
Product family
Spectrum
Product
Spectrum > Geocoding > Enterprise Tax
Spectrum > Web Services
Spectrum > Spatial > Spectrum Spatial
Spectrum > Spectrum Platform
Spectrum > Quality > Addressing
Spectrum > Quality > Spectrum Quality
Spectrum > Spatial > Spectrum Spatial Insights
Spectrum > Discovery
Spectrum OnDemand
Spectrum > Dataflow Designer
Spectrum > Spatial > Spectrum Spatial Analyst
Spectrum > Quality > Context Graph
Version
Latest
Language
English
Product name
Spectrum OnDemand
Title
Spectrum OnDemand Web Services (REST)
Copyright
2024
First publish date
2006
ft:lastEdition
2024-07-17
ft:lastPublication
2024-07-17T23:23:16.481321
The GlobalTypeAheadUSCANPremium API is built upon the GlobalTypeAheadUSCAN API with this add-onfeature:
  • Support for rural route (RR), highway contract (HC), or P.O. boxaddress.

An address can be a street address, a rural route address, a highway contract address, a P.O. box address, a private mailbox address or a Military Post Boxes.

Table 1. GlobalTypeAhead USCANPremium Input

Parameter

Format

Description

Data.AddressLine1

String

The first addressline. It may contain City, StateProvince, PostalCode, or P.O.box number. 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.

Data.City

String

The city name.

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

Data.StateProvince

String

The state or province.

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

Data.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.

Data.PostCode

String

The post code.

Data.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, andISO 3166-1 Alpha-3 code is USA.
Note: This field is mandatory.