Home
Module Services
Describes module services addressible by Spectrum APIs.
Universal Addressing Module
GetCityStateProvince
Output

Welcome
Learn how to use a supported compiler and runtime to connect applications to Spectrum Technology Platform 2022.1.0.
Getting Started
Useful information about using the Spectrum API.
The C API
The C API is a set of functions that allow C code to interact with Spectrum Technology Platform 2022.1.0.
The C++ API
The C++ API is a set of functions that allow C++ code to interact with Spectrum Technology Platform 2022.1.0.
The Java API
The Java API is a set of functions that allow Java code to interact with Spectrum Technology Platform 2022.1.0.
ManagementAPI Methods (Deprecated)
The deprecated ManagementAPI supports two methods used by existing legacy applications.
Module Services
Describes module services addressible by Spectrum APIs.
- Enterprise Geocoding
- Enterprise Tax Module
- GeoConfidence Module
- Global Addressing Module
- Universal Addressing Module
  - Spectrum Universal Address
  - AutoCompleteLoqate
  - GetCandidateAddresses
  - GetCandidateAddressesLoqate
  - GetCityStateProvince
  - GetCityStateProvinceLoqate
  - GetPostalCodes
  - GetPostalCodes Loqate
  - ValidateAddress
  - ValidateAddressGlobal
  - ValidateAddressLoqate
  - Encountering False Positives
    Information on what is false positives, how to report DPV, LACS/Link False-Positives Violations.
  - ValidateAddress Confidence Algorithm
- Spectrum Universal Name
About Spectrum Technology Platform
An overview of Spectrum, its data management architecture, its platform architecture, and its modules and components.
Appendix
Look up ISO codes for countries and Spectrum modules that support addressing, geocoding, and routing for each country.

Output

GetCityStateProvince returns the matching city and state/province for the input postal code as well as a code to indicate the success or failure of the match attempt. If more than one city/state or city/province matches the input postal code, multiple output records are returned.

Table 1. GetCityStateProvince Output
columnName	Description
City	The matched city name.
City.Type	The USPS® standardized city name type (U.S. addresses only). V Vanity (non-mailing) city name. P Primary. The city name is the primary mailing city name. S Secondary. The city name is an alternate city name but is acceptable. A city can have multiple secondary city names.
PostalCode	The input postal code.
ProcessedBy	Indicates which address coder processed the address. One of the following: USA The U.S. address coder processed the address. CAN The Canadian address coder processed the address.
StateProvince	The validated state/province or its abbreviated value.
Status	Reports the success or failure of the match attempt. null Success F Failure
Status.Code	The reason for failure, if there is one. The only valid value is: DisabledCoder UnrecognizedPostalCode
Status.Description	The description of the failure. The valid values are: Postal code not found This value will appear if Status.Code=UnrecognizedPostalCode. PerformUSProcessing disabled This value will appear if Status.Code=DisabledCoder. PerformCanadianProcessing disabled This value will appear if Status.Code=DisabledCoder.