Parameters for Input Data - Spectrum_OnDemand - Latest

Spectrum OnDemand Web Services (REST)

Product type
Software
Portfolio
Verify
Product family
Spectrum
Product
Spectrum > Spectrum Platform
Spectrum > Spatial > Spectrum Spatial
Spectrum > Spatial > Spectrum Spatial Analyst
Spectrum > Quality > Context Graph
Spectrum > Web Services
Spectrum > Discovery
Spectrum OnDemand
Spectrum > Quality > Addressing
Spectrum > Geo Addressing > Enterprise Tax
Spectrum > Spatial > Spectrum Spatial Insights
Spectrum > Quality > Spectrum Quality
Spectrum > Dataflow Designer
Version
Latest
Language
English
Product name
Spectrum OnDemand
Title
Spectrum OnDemand Web Services (REST)
Copyright
2024
First publish date
2006
Last updated
2024-10-21
Published on
2024-10-21T20:04:24.714961

If you want to specify a radius for the search, use the SearchRadius parameter. If you leave it blank, the radius considered is 10 Miles. However, the maximum radius that you can specify is 100 Miles.

To obtain valid search results upto 100 Miles, you must provide these input parameters:
  • AddressLine1
  • Latitude/Longitude or IPAddress or Country
To obtain valid search results beyond 100 Miles, you must provide these input parameters:
  • AddressLine1
  • Country
  • Latitude/Longitude or IPAddress

For the search results beyond 100 Miles, you will get the results in sequence. SearchRadius results will come first, followed by wide search results.

Table 1. GeoTypeAheadUSCAN Input

Parameter

Format

Description

Data.AddressLine1

String

The first address line. It may contain City, StateProvince or PostalCode information. 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 three 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 a city.

Data.StateProvince

String

The state or province.

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

Data.InstanceKey

String

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

An instance key can be created by calling the CreateAddressingInstanceKey service before the first time you call a Global Type Ahead service.

The service will then return an InstanceKey value that is the same. If it is different, that means the same InstanceKey has been used too long. You should pass this new InstanceKey to subsequent calls until the user has selected an address or abandoned 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.IpAddress

Optional

Specifies the ip address to be used to detect the location to perform the address search around that location. The parameter is used only when explicit location (latitude and longitude) is not provided in the request.

If the ip address is provided in input request, it will be used for detecting location.

Data.Longitude

Optional The longitude of the location. (WGS 84 datum/EPSG:4326 coordinate system)

Data.Latitude

Optional The latitude of the location. (WGS 84 datum/EPSG:4326 coordinate system)

Data.SearchRadius

Optional Specifies the radius within which this service searches for results. If not provided, the default value is 10 Miles. The allowed minimum value is greater than 0 and maximum range in all allowed units is mentioned below:

In Miles: upto 100 Miles

In Feet: upto 528000 Feet

In Kilometers: 160.934 Kilometers

In Meters: 160934 Meters

Default Radius: 10

Data.SearchRadiusUnit

Optional The acceptable unit values are: Feet, Kilometers, Miles and Meters.

The searchRadiusUnit is optional, if not provided, the unit ‘Miles’ is taken by default, otherwise the search is performed based upon the searchRadius calculated in the specified unit. The search results are returned accordingly in the specified unit. For example, 'Kilometers' searchRadiusUnit returns results in 'Kilometers'.

The input values are case-insensitive.

Default unit: Miles

Data.PostalCode

String

The postal code.

It is only specified when results need to be restricted to a postal code.

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, and ISO 3166-1 Alpha-3 code is USA.