Input

GeocodeUSAddress takes an address as input. To obtain the best performance with GeocodeUSAddress and the most possible matches, your input address should be as complete as possible and free of misspellings and incomplete information. Input addresses should be as close to USPS standards as possible for the highest match rate. For information about USPS standards, see the USPS website http://www.usps.com.

Input addresses should contain a street address line and a lastline, or a single line with both address and lastline elements. This helps GeocodeUSAddress accurately identify an area in which to search for a match candidate, based on the city, state, and ZIP Code. However, matching can still be performed in cases where only a city is input in the lastline rather than a full lastline containing the city, state and ZIP Code elements. For more information, see City-only Lastline Matching.

GeocodeUSAddress also accepts a street address line with individual city, state, and ZIP Code lines instead of a last line. You should only use this type of input if you are confident that the input address is free of misspellings and incomplete information.

If you are using GeocodeUSAddress for address standardization, input addresses must have at least a street name, and either a city and state or a ZIP Code to obtain a match. If you are using GeocodeUSAddress to obtain geocoding information, input addresses only need to contain a ZIP + 4 Code to receive geocoding information.

The following table provides information about the format and layout of GeocodeUSAddress input.

GeocodeUSAddress Input Data

columnName Format Description

AddressLine1

String

The first address line or a street intersection.

To specify a street intersection, use and, &, at, or @. For example, PEARL & 28th. GeocodeUSAddress does not match intersections when processing in CASS mode.

You may enter an address range instead of an individual address number. For example, 10-12 FRONT ST. For additional information, see Address Range Matching.

AddressLine2

String

The second address line or a street intersection.

To specify a street intersection, use and, &, at, or @. For example, PEARL & 28th. GeocodeUSAddress does not match intersections when processing in CASS mode.

AddressLine3

String

Third address line.

AddressLine4

String

Fourth address line.

AddressLine5

String

Fifth address line.

AddressLine6

String

Sixth address line.

City

String

The name of the municipality, such as a city or town.

Note: If there is any data in the input fields AddressLine3, AddressLine4, AddressLine5, or AddressLine6, GeocodeUSAddress will ignore data in the City input field.

FirmName

String

The name of a business. The geocoding process attempts to match the input firm name to the recognized firm names in the USPS data for a higher quality match. If the firm name is not in the USPS data, the firm name is ignored when matching and is returned with the output.

LastLine

String

The last line of an address containing the city, state, and ZIP Code.

Latitude

String

Input latitude for matching using the Predictive Lastline feature. The required input format is an integer value; for example, 40018301. Decimal is not a valid input format.

For more information, see Predictive Lastline.

Longitude

String

Input longitude for matching using the Predictive Lastline feature. The required input format is an integer value; for example: -105240976. Decimal is not a valid input format.

For more information, see Predictive Lastline.

PostalCode

String

The 5-digit ZIP Code or the 9-digit ZIP + 4 code.

Note: If there is any data in the input fields AddressLine3, AddressLine4, AddressLine5, or AddressLine6, GeocodeUSAddress will ignore data in the PostalCode input field.

StateProvince

String

The name or abbreviation of the state.

Note: If there is any data in the input fields AddressLine3, AddressLine4, AddressLine5, or AddressLine6, GeocodeUSAddress will ignore data in the StateProvince input field.