How GeocodeAddressUSA Processes Addresses - Spectrum_OnDemand - Latest

Spectrum OnDemand Web Services (REST)

Product type
Product family
Spectrum > Quality > Context Graph
Spectrum > Spatial > Spectrum Spatial Analyst
Spectrum > Spectrum Platform
Spectrum > Quality > Addressing
Spectrum > Quality > Spectrum Quality
Spectrum > Web Services
Spectrum > Dataflow Designer
Spectrum > Discovery
Spectrum OnDemand
Spectrum > Spatial > Spectrum Spatial Insights
Spectrum > Spatial > Spectrum Spatial
Spectrum > Geocoding > Enterprise Tax
Product name
Spectrum OnDemand
Spectrum OnDemand Web Services (REST)
First publish date

GeocodeAddressUSA processes addresses in this order:

  1. Parses the address elements.

    GeocodeAddressUSA parses input address data into single elements. Parsing occurs on data in the order in which you load the data. Even if a valid address is missing an element, GeocodeAddressUSA can find a match. Some elements, such as predirectionals, may not be critical elements of some addresses. By comparing an address as input against all known addresses in a search area, GeocodeAddressUSA can usually determine if any of these elements are missing or incorrect.

  2. Finds possible matches within the search area.

    GeocodeAddressUSA uses the last line elements of an address to determine a search area. You can specify if you want the search area based on a finance area or on an area defined by the city, state, and ZIP Code. (A Finance Area is a collection of ZIP Codes within a contiguous geographic region.) If the city and state are not in the ZIP Code, GeocodeAddressUSA performs separate searches for the ZIP Code and city.

    After GeocodeAddressUSA has determined the search area, it tries to match the elements from the street address line to the records in the standardized data files and does these:

    • Checks input address ranges for missing or misplaced hyphens, and alpha-numeric ranges for proper sequence.
    • Searches for any misspellings and standard abbreviations. For example, the GeocodeAddressUSA can recognize Mane for Main and KC for Kansas City.
    • Searches for any alias matches to the USPS and Spatial data. For example, GeocodeAddressUSA recognizes that in Boulder, CO Highway 36 is know as 28th Street.
    • Searches for any USPS recognized firm names for additional match verification.
    • Searches for street intersection matches. Matching to an intersection is extremely useful when you are using address matching to obtain a geocode.
    • Searches for addresses lines that contain a house number and unit number as the same element. For example, GeocodeAddressUSA recognizes the input 4750-200 Walnut Street and performs recombination to output 4750 WALNUT ST STE 200.
    Note: The USPS does not consider intersections valid addresses for postal delivery. Therefore, the GeocodeAddressUSA does not match intersections when processing in CASS mode.
  3. Scores each possible match against the parsed input.

    GeocodeAddressUSA compares each element in the input address to the corresponding element in the match candidates, and assigns a confidence level. GeocodeAddressUSA weighs the confidence level for all of the elements within a match candidate, and assigns a final score to the sum.

    Note: GeocodeAddressUSA uses a penalty scoring system. If an element does not exactly match an element in the match candidate, the GeocodeAddressUSA adds a penalty to the score of the match candidate. Therefore, scores with lower numbers are better matches.
  4. Determines the match.

    GeocodeAddressUSA prioritizes each match candidate based on the assigned confidence score and returns as a match the candidate that has the lowest score.

    The match mode you choose determines the range that GeocodeAddressUSA allows for a match. GeocodeAddressUSA only returns a match if the score of the target address falls within the range designated by the selected match mode.

    In some cases, more than one match candidate may have the lowest score. In this instance, GeocodeAddressUSA cannot determine on its own which record is correct, and returns a status indicating multiple matches.

    Note: If you have enabled Delivery Point Validation (DPV) processing, GeocodeAddressUSA automatically attempts to resolve multiple matches using DPV.

    Along with a standardized address, GeocodeAddressUSA also returns these:

    • Geocode—Longitude and latitude for the address
    • Match code—Information about the match of the input address to the reference data
    • Location code—Precision level of a geocode
    • Parity—The side of the street on which the match resides.

    GeocodeAddressUSA does not return parity when processing in relaxed mode. For more information about GeocodeAddressUSA output, see Response.