Matching to Auxiliary Files

GeocodeUSAddress matches an input address to an auxiliary file as follows:

  1. GeocodeUSAddress determines if there is an auxiliary file present.

    If you have an auxiliary file in the dataset directory, GeocodeUSAddress automatically loads and attempts to match to the auxiliary file. You can verify that GeocodeUSAddress found an auxiliary file by looking at the version information page in the Management Console. One of the following statuses display:

    • Loaded—An auxiliary file is loaded
    • None—An auxiliary file has not been found or loaded
    • Invalid—An auxiliary file was found, but failed to successfully load

    GeocodeUSAddress only accepts one auxiliary file. If more than one auxiliary files is present, GeocodeUSAddress attempts to match against the first file. GeocodeUSAddress ignores any additional auxiliary files for matching, regardless if GeocodeUSAddress found a match to the first auxiliary file.

    If a record in the auxiliary files is invalid, GeocodeUSAddress returns a invalid record message. GeocodeUSAddress continues to match input addresses with the auxiliary file, but will not match to the invalid auxiliary file record.

  2. If an auxiliary file is present, GeocodeUSAddress attempts to match to the auxiliary file.

    GeocodeUSAddress assumes that the auxiliary file is the most accurate data set and attempts to find a match to the input address in the auxiliary file. If GeocodeUSAddress cannot find a match in the auxiliary file, it matches the input address with the other Enterprise Geocoding Module databases.

    Note: GeocodeUSAddress only matches input address lists to auxiliary files if there is an exact match. Your input address list should be free of misspellings and incomplete addresses.
  3. If GeocodeUSAddress finds an exact record match to the auxiliary file, it standardizes the match to USPS regulations and returns the output of the auxiliary file match.

    GeocodeUSAddress uses the following defaults if you do not include the values in the auxiliary file:

    • House number parity = B (both odds and evens)
    • Segment direction = A (ascending)
    • Side of street = U (unknown)