United States (USA) - geo_addressing_sdk - 5.0

Geo Addressing SDK Developer Guide

Product type
Software
Portfolio
Locate
Product family
Geo Addressing
Product
Geo Addressing SDK
Version
5.0
Language
English
Product name
Geo Addressing SDK
Title
Geo Addressing SDK Developer Guide
Copyright
2023
First publish date
2007
Last updated
2024-10-17
Published on
2024-10-17T16:12:58.390251

Custom Preferences

USA supports custom preferences and custom output fields.

Additional topics for USA geocoding are included following the custom tables.

Table 1. Custom Preferences
Preference Description
USE_ADDRESS_POINT_INTERPOLATION Use Address Point Interpolation When set to true, enables address point interpolation. Default = false. Supported only in forward geocoding.
Note: The address point interpolation feature requires that you have a point-level geocoding dataset installed.
CALCULATE_CENTERLINE_ PROJECTION_OF_POINT Calculate Centerline Projection of Point Computes the closest point on the street from the parcel point. Default = disabled.
Note: This feature requires that a point-level geocoding dataset is installed.
USE_CENTERLINE_OFFSET Use Centerline Offset When set to true, calculates the centerline offset for point addresses. Default = false. Supported only in forward geocoding.
Note: The centerline feature requires that you have a point-level geocoding dataset installed.
A centerline point match is indicated by a result code beginning with SC.
CENTERLINE_OFFSET Centerline Offset When USE_CENTERLINE_OFFSETUse Centerline Offsetis enabled, this specifies the distance to offset the point from centerline. Default = 0. Supported in forward geocoding only.
CENTERLINE_OFFSET_UNITS Centerline Offset Units When USE_CENTERLINE_OFFSETUse Centerline Offset is enabled, this specifies the unit type for the centerline offset. Valid values = feet, meters. Default = meters. Supported only in forward geocoding.
FIND_ADDR_POINT_INTERP When set to true, enables address point interpolation. Default = false.
Note: Supported only in forward geocoding.
Note: This feature does not work with point addresses in Auxiliary files.
FIND_ADDRCODE When set to true, attempts to standardize and find an address geocode. Set this option if you want the address parsed and standardized. If this option is not set, only the input ZIP and ZIP+4 address elements are used. Default = false.
Note: Supported only in forward geocoding.
FIND_ADDRESS_RANGE When set to true, returns address range information. Default = false.
Note: Supported only in forward geocoding.
Note: Ignored in CASS and Exact match modes.
FIND_ALTERNATE_LOOKUP Determines whether the preferred lookup is to look for the streets first or the firms first. Default = 3.
Note: Supported only in forward geocoding.
Note: Ignored in CASS match mode.
1
Prefer street lookup: Matches to the address line, if a match is not made, then matches to the placeName line.
2
Prefer firm lookup: Matches to the placeName line, if a match is not made, then matches to the address line.
3
Street lookup only: Matches to the address line. Default.
FIND_APPROXIMATE_PBKEY When set to true, enables the PreciselyID Fallback option. If an address match is not made to Master Location Data (MLD), but a match is made to a different dataset, the PreciselyIDr of the nearest MLD point located within the search distance is returned. To distinguish when a fallback PreciselyID is returned, the PBKEY return value contains a leading character of "X" rather than "P", for example: X00001XSF1IF. Note, all of the other fields returned for the address match, including the geocode and all associated data, reflect the match results for the input address. The fallback PreciselyID can then be used for the lookup to the GeoEnrichment dataset(s), and the attribute data for the fallback location is returned for the match. Default = false.
Note: This option requires that you have licensed and installed the Master Location Dataset.

For more information, see PreciselyID Fallback.

The search distance for the nearest MLD point with a PreciselyID is configurable:

  • For forward geocoding, use the FIND_SEARCH_DIST option. For more information, see FIND_SEARCH_DIST.
  • For reverse geocoding, the search distance is the same that is used for the reverse geocoding search radius, use preferences:distance. For more information, see Reverse Geocode POST Request.
The allowable search radius is 0-5280 feet. The default is 150 feet.
FIND_BUILDING_SEARCH Controls the ability to search by building name entered in the address line. When set to true, enables matching to building names even when no unit numbers are present. Default = false.
Note: Supported only in forward geocoding.
Note: Ignored in CASS match mode.

This option is also used when matching to POI data, an optional index file included in the Master Location Data. See Point of Interest Matching.

FIND_CENTERLINE_OFFSET Offset distance from the street center for a centerline match. Any positive integer, which represents number of feet. Default = 0 feet.
Note: Supported only in forward geocoding.
Note: This feature requires a points dataset is installed.
FIND_CENTERLN_PROJ_OF_POINT When set to true, computes the closest point on the street from the parcel point. Default = false.
Note: Supported only in forward geocoding.
Note: This feature requires a points dataset is installed.
FIND_CLOSEST_POINT When set to true, matches to the nearest point address within the search radius, rather than to the closest feature (e.g. street segment or intersection as well as point addresses). Default = false.
Note: Supported only in reverse geocoding.
Note: This feature requires that at least one points dataset and one streets dataset are installed; otherwise, the match will be made to the closest feature.
FIND_CORRECT_LASTLINE When set to true, corrects elements of the output lastline, providing a good ZIP Code or close match on the soundex even if the address would not match or was non-existent. Default = false.
Note: Supported only in forward geocoding.
FIND_DB_ORDER Allows you to specifically set the order in which User Dictionary and GSD data sets are searched. The default search order is:
  • User Dictionaries
  • Point GSD files
  • Street GSD files
Enter a list of geocoding dataset index values [starting at 0, separated by semi-colons] indicating which datasets to search and in what order.
FIND_DPV When set to true, enables delivery point validation. Default = false.
Note: Supported only in forward geocoding.
FIND_EXPANDED_SEARCH_RADIUS Allows the setting of the radius in miles (up to 99) around which your record lies. Must be used with applicable FIND_SEARCH_AREA setting. Default radius setting = 25 miles.
Note: Ignored in CASS match mode.
FIND_EXPND_SRCH_LIM_TO_STATE When set to true, limits an expanded search to a state's border. Must be used with applicable FIND_SEARCH_AREA setting. Default = true.
Note: Ignored in CASS match mode.
FIND_FIRST_LETTER_EXPANDED When set to true, enables extra processing for a bad first letter (missing, wrong, etc.). Default = false.
Note: Supported only in forward geocoding.
Note: Ignored in Exact match mode.
FIND_LACSLINK When set to true, enables LACSLink lookup. Default = false.
Note: Supported only in forward geocoding.
FIND_MATCH_CODE_EXTENDED When set to true, enables the return of additional address match information. Most notably, this is used to indicate whether or not an exact match was made to the input unit number. An address match is still returned if there is not an exact match to the input unit number, but the match is to the main building address without units. This extended match code digit will also provide information about any changes in the house number, unit number and unit type fields. In addition, it can indicate whether there was address information that was ignored. Default = true. For more information, see Extended Match Codes.
Note: Supported only in forward geocoding.
FIND_MIXED_CASE When set to true, returns candidate information in mixed case rather than uppercase. Default = false.
FIND_NEAREST_ADDRESS When set to true, enables matching to addresses interpolated on street segments or to point data locations.

You can use FIND_NEAREST_ADDRESS and FIND_NEAREST_INTERSECTION together to specify reverse geocoding to both addresses and intersections.

Set the reverse geocoding processing find properties: FIND_NEAREST_ADDRESS, FIND_NEAREST_INTERSECTION, and/or FIND_NEAREST_UNRANGED. Default = false.
Note: Supported only in reverse geocoding.
FIND_NEAREST_INTERSECTION When set to true, enables matching to intersections.

You can use FIND_NEAREST_INTERSECTION and FIND_NEAREST_ADDRESS together to specify reverse geocoding to both addresses and intersections.

Set the reverse geocoding processing find properties: FIND_NEAREST_ADDRESS, FIND_NEAREST_INTERSECTION, and/or FIND_NEAREST_UNRANGED. Default = false.

Note: Supported only in reverse geocoding.
FIND_NEAREST_UNRANGED When set to true, enables matching a street segment with no number ranges.

Enabled with FIND_NEAREST_ADDRESS. Ignored for point data and intersection matches.

Note: Supported only in reverse geocoding.
FIND_PREFER_POBOX When set to true, if both a street address and a PO Box are provided in the input address, the PO Box is used for matching. Default = false.
If both FIND_PREFER_POBOX and FIND_PREFER_STREET are set to true, then they are ignored, and the default, FIND_PREFER_STREET is used.
Note: Supported only in forward geocoding.
Note: Ignored in CASS match mode.
FIND_PREFER_STREET When set to true, if both a street address and a PO Box are provided in the input address, the street address is used for matching. Default = false.
If both FIND_PREFER_POBOX and FIND_PREFER_STREET are set to true, the default, FIND_PREFER_STREET is used.
Note: Supported only in forward geocoding.
Note: Ignored in CASS match mode.
FIND_PREFER_ZIP_OVER_CITY When set to true, prefers candidates matching the input ZIP Code over matches to the input city. Default = false.
Note: Supported only in forward geocoding.
Note: Ignored in CASS and Interactive match modes. Interactive match mode attempts to return the best address regardless of this setting.
FIND_SEARCH_AREA This option assists in finding a match when the input address contains limited or inaccurate city or ZIP Code information. One of the following options:
0
Searches the specified city.
1
Searches the entire Finance Area for possible streets. Note: This option has no effect when performing a ZIP centroid match.
2
Allows the setting of an expanded search area. When selected, you can use two other options to set how far to expand the search: FIND_EXPANDED_SEARCH_RADIUS and FIND_EXPND_SRCH_LIM_TO_STATE.
Note: Ignored in CASS match mode.
FIND_SEARCH_DIST When FIND_APPROXIMATE_PBKEY is enabled, this parameter sets the distance to use when searching for the nearest address record with an associated pbKey™ unique identifier. The allowable range is 0-5280 feet. Default = 150 feet.
Note: Supported only in forward geocoding.
FIND_STREET_CENTROID When set to true, enables street locator geocoding. When enabled, if an input street address cannot be found using the street number and name, then the input ZIP Code or city/state is searched for the closest match. If the street is located, a geocode is returned along the matched street segment rather than the geocode for the entered ZIP Code or ZIP + 4.

When using street locator geocoding, if no exact matching house number is found, a match code of either E029 (no matching range, single street segment found), or E030 (no matching range, multiple street segment) is returned.

Default = false.
Note: Supported only in forward geocoding.
Note: Ignored in CASS match mode.
FIND_SUITELINK When set to true, enables SuiteLink lookup. Default = false.
Note: Supported only in forward geocoding.
Note: Ignored in Exact match mode.
FIND_Z_CODE When set to true, attempts to find any ZIP centroid match. Default = true.
Note: Supported only in forward geocoding.
FIND_Z5_CODE When set to true, attempts to find a ZIP centroid match (no ZIP + 4 or ZIP+2). Default = false.
Note: Supported only in forward geocoding.
FIND_Z7_CODE When set to true, attempts to find a ZIP+2 centroid match only (no ZIP+4 or ZIP). Default = false.
Note: Supported only in forward geocoding.
FIND_Z9_CODE When set to true, attempts to find a ZIP+4 centroid match only. Default = false.
Note: Supported only in forward geocoding.
RETURN_LAT_LON_AS_INTEGER_VALUE When set to true, returns the LAT and LON custom fields as integer values in millionths of degrees. Default = false, returns the LAT and LON custom fields as decimal values.
Note: Supported only in forward geocoding.