United States (USA)
Custom Preferences
USA supports custom preferences and custom output fields.
Additional topics for USA geocoding are included following the custom tables.
Preference | Description |
---|---|
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 | 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 | 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 | When Use Centerline Offsetis enabled, this specifies the distance to offset the point from centerline. Default = 0. Supported in forward geocoding only. |
Centerline Offset Units | When Use Centerline Offset is enabled, this specifies the unit type for the centerline offset. Valid values = feet, meters. Default = meters. Supported only in forward geocoding. |
Custom Output Fields
This section lists the unique output fields for USA. Unless otherwise noted, these fields can be returned for both forward and reverse geocoding.
The following categories of output fields are defined:
- Quality Descriptors
- Parsed Address
- Point
- Centerline
- Intersection
- Census
- Postal
- DPV
- Residential Delivery Indicator (RDI)
- LACSLink
- SuiteLink
- Short Address
- Segment
- Other
To include one or more of these categories in the output:
- In Management Console: Use the Country Filter dropdown menu and select United States. Then, on the Return Values tab, select the desired output category checkboxes.
To return all category output fields:
- In Management Console: Use the Country Filter dropdown menu and select United States. Then, on the Return Values tab, select the Return all available information checkbox.
Quality Descriptors Output Fields
The Quality Descriptors output fields provide information about the results of the matching and geocoding processes.
Field Name | Description |
---|---|
Confidence | The Confidence value for USA candidates is available as a custom output field on the candidate. The key is “CONFIDENCE”. |
LocationCode | Location codes indicate the accuracy of the assigned geocode. For descriptions of location codes, see Address Location Codes in the appendix. |
MatchCode | Match codes indicate the portions of the address that matched or did not match to the reference file. For descriptions of match codes, see Match Codes in the appendix. |
PostalFallback | USA fallback candidates returns the correct MatchCode and LocationCode indicating a postal fallback, rather than codes indicating a postal level geocode. |
MMResultCode | The MapMarker result code for this candidate. See result codes in Global Result Codes in the appendix. |
Parsed Address Output Fields
The Parsed Address output fields provide the components of a matched address which have been parsed and standardized by the geocoder.
Field Name | Description |
---|---|
ParsedAddressLine | The address line for single line input addresses. |
ParsedCity | The abbreviated city name from the last line of the input or output address;
the value from ParsedCityName or ParsedPreferredCity . |
ParsedCountyName | The county name. |
ParsedFirmName | The name of firm from the USPS data or the input firm name. Not applicable to street intersection matches. |
ParsedHouseNumber | The house number of input or output address. Not applicable to street intersection matches. |
ParsedLastLine | The complete last line of the address. |
ParsedMainAddress | The complete first line of the address. |
Parsed Name | The street name. |
ParsedCityName | The city name for the matched address from the City-State record. |
ParsedPreferredCity | The preferred city name for the output ZIP Code of the matched address. |
ParsedState | The state abbreviation. |
ParsedUnitNumber | The unit number. Not applicable to street intersection matches. |
ParsedUnitType | The unit type (APT, STE, etc.). Not applicable to street intersection matches. |
ParsedZip | 5-digit ZIP Code. Not applicable to street intersection matches. |
ParsedZip4 | 4-digit ZIP Code extension. |
ParsedZip9 | 9-digit ZIP Code (ZIP + 4). |
ParsedZip10 | 10-digit ZIP Code (ZIP + 4) with dash separator. |
Point Output Fields
The Point output fields provide additional information about the geocode resulting from a match using point-level data.
Field Name | Description |
---|---|
APN ID | The Assessor's Parcel Number Identifier. Not applicable to street intersection matches. |
NearestDistance | Gives the distance, in feet, from the input
location to the matched street segment, point address, or intersection.
Note: For reverse geocoding only. |
Parcen Elevation | The elevation of the geocode at the parcel centroid. Not applicable to street intersection matches. |
PBKey | A unique address identifier that is returned when an address match is made
using the Master Location Dataset. The pbKey™ unique
identifier is used as a lookup key to a GeoEnrichment dataset, in order
to return attribute data for the match. Note: For forward and reverse
geocoding. Note: To return this field, select the
Return all available information checkbox. |
Point ID | The unique point ID of the matched record when matched to point-level data. Blank if the matched record is not from point-level data. Not applicable to street intersection matches. |
Centerline Output Fields
Centerline matching is used with point-level matching to tie a point-level geocode with its parent street segment. This type of match provides you with additional data about the parent street segment that is not available with only a point-level match. The output information also includes the bearing and distance from the point data geocode to the centerline match.
Field Name | Description |
---|---|
CenterlineBearing | For centerline candidates, provides the compass direction, in decimal degrees, from the point data match to the centerline match. Measured clockwise from 0 degrees north. |
CenterlineLeftBlock | For centerline candidates, the Census block ID from the left side of the street. Not applicable to street intersection matches. |
CenterlineRightBlock | For centerline candidates, the Census block ID from the right side of the street. Not applicable to street intersection matches. |
CenterlineLeftSFXBlock | For centerline candidates, the current left block suffix for Census 2010 geography. This field will be blank if the matched record is from point-level data. |
CenterlineRightSFXBlock | For centerline candidates, the current right block suffix for Census 2010 geography. This field will be blank if the matched record is from point-level data. |
CenterLineDatatype | For centerline candidates, the data type used to make the centerline match.
|
CenterlineIsAlias | Three characters indicating that a centerline match was located by an index alias. The first character:
The next 2 characters:
|
CenterLineLatitide | For centerline candidates, the latitude as integer value in millionths of degrees. |
CenterLineLongitude | For centerline candidates, the longitude as integer value in millionths of degrees. |
CenterlineName | For centerline candidates, the primary street name. |
CenterlineNearestDistance | For centerline candidates, gives the distance, in feet, from the point-level match to the centerline match. |
CenterlinePostDirectional | For centerline candidates, the street postfix directional. Can be blank, N, S, E, W, NE, NW, SW, or SE. |
CenterlinePreDirectional | For centerline candidates, the street prefix directional. Can be blank, N, S, E, W, NE, NW, SW, or SE. |
CenterlineQCity | For centerline candidates, the state, city, or finance numbers. |
CenterlineRoadClass | For centerline candidates, the road class code:
|
CenterlineSegmentHiRange | For centerline candidates, provides the high house number in the segment. |
CenterlineSegmentLoRange | For centerline candidates, provides the low house number in the segment. |
CenterlineSegmentDirection | For centerline candidates, gives the direction of the segment:
|
CenterlineSegmentID | For centerline candidates, the unique segment ID from data vendors. |
CenterlineSegmentParity | For centerline candidates, provides the segment parity. The parity indicates
which side of the street the odd numbers in the segment are located:
|
CenterlineType | For centerline candidates, provides the street type. |
Intersection Output Fields
The Intersection output fields provide data about the second segment in an intersection match.
Field Name | Description |
---|---|
BlockLeft2 | For intersection matches, the Census block ID from the left side of the street for the second segment in an intersection. |
BlockRight2 | For intersection matches, the Census block ID from the right side of the street for the second segment in the intersection. |
BlockSFXLeft2 | For intersection matches, the current left block suffix for Census 2010 geography for the second segment in the intersection. |
BlockSFXRight2 | For intersection matches, the current right block suffix for Census 2010 geography for the second segment in the intersection. |
CBSADivisionName2 | For intersection matches, the Core Based Statistical Area (CBSA) division name for the second segment in the intersection. |
CBSADivisionNumber2 | For intersection matches, the Core Based Statistical Area (CBSA) division number for the second segment in the intersection. |
CBSAName2 | For intersection matches, the name of the Core Based Statistical Area (CBSA) for the second segment in the intersection. |
CBSANumber2 | For intersection matches, the Core Based Statistical Area (CBSA) number for the second segment in the intersection. |
CountyName2 | For intersection matches, the County name for the second segment in the intersection. |
County2 | For intersection matches, the county FIPS code for the second segment in the intersection. |
CSAName2 | For intersections matches, the Combined Statistical Area (CSA) name for the second segment in the intersection. |
CSANumber2 | For intersection matches, the Combined Statistical Area (CSA) number for the second segment in the intersection. |
DataType2 | For intersection matches, the type of data used to make the match for the
second segment in the intersection.
|
MetroFlag2 | Indicates whether the Core Based Statistical Area (CBSA) in which the address
is located is a metropolitan area or a micropolitan area. One of the following:
|
Name2 | For intersection matches, the street name for the second segment of the intersection. |
PostDirectional2 | For intersection matches, the postfix direction of the second street in the intersection. Can be blank, N, S, E, W, NE, NW, SW, or SE. |
PreDirectional2 | For intersection matches, the prefix direction of the second street in the intersection. Can be blank, N, S, E, W, NE, NW, SW, or SE. |
RoadClass2 | For intersection matches, the road class code of the second segment in the
intersection:
|
SegHiRange2 | For intersection matches, provides the high house number of the second segment in the intersection. |
SegLoRange2 | For intersection matches, provides the low house number of the second segment in the intersection. |
SegmentDirection2 | For intersection matches, gives the direction of the second segment in the
intersection:
|
SegmentID2 | For intersection matches, the Segment ID (TLID) or unique ID from premium data vendors for the second segment in the intersection. |
SegmentParity2 | For intersection matches, provides the segment parity for the second segment in
the intersection. The parity indicates which side of the street the odd numbers in
the segment are located:
|
Type2 | For intersection matches, the street type for the second segment in the intersection. |
Census Output Fields
Census output fields contain U.S. Census information about the address.
Field Name | Description |
---|---|
Block | 15-digit census block ID/census FIPS code, using the syntax
sscccttttttgbbb where:
|
County | The county FIPS code. |
StateFIPS | The state FIPS code. |
Postal Output Fields
The Postal output fields contain detailed postal information for the address.
Field Name | Description |
---|---|
AltFlag | Alternate/base record indicator:
|
CART | Carrier route ID. Not applicable to street intersection matches. |
CheckDigit | A one-digit code at the end of a mailing label barcode. |
CountyStateKey | USPS city state key (an alphanumeric value that uniquely identifies a locale in the USPS city state product). |
DFLT | Indicates the return status of Highrise DFLT or
Rural Routes :
|
DPBCCode | Delivery Point Barcode. |
EWSMatch | Indicates if an EWS match was made:
|
Govt Flag | The government building indicator:
|
HighriseDFLT | Indicates if the match was made to a highrise.
|
LotCode | Lot ascending and descending value. Only available for addresses that can be
standardized. Blank if running in CASS mode and you have not initialized DPV or the
output address does not DPV confirm.
|
LotNumber | 4-digit eLot number. Requires an input address that can be standardized. Blank if running in CASS mode and you have not initialized DPV or the output address does not DPV confirm. |
MailStop | Returns address information appearing after mail stop designator words: MSC, MS, MAILSTOP, MAIL STOP, ATTN, ATTENTION. |
PMBDesignator | PMB designator. |
PMBNumber | PMB number. |
RuralRoutes | Match indicator for rural routes.
|
URBName | The urbanization name for Puerto Rico. |
ZipCarrtSort | Indicates the type of cart sort allowed:
|
ZipClass | ZIP Classification Code:
|
ZipFacility | Returns the USPS City State Name Facility Code:
|
DPV Output Fields
DPV data output fields contain information about a match made using DPV data.
Field Name | Description |
---|---|
DPVCMRA | Delivery Point Validation CMRA indicator.
|
DPVConfirm | Indicates if a match occurred for DPV data.
|
DPVFalsePOS | DPV false-positive indicator.
|
DPVFootNote1 | Information about the matched DPV records.
|
DPVFootNote2 | Information about the matched DPV records.
Note: A unique ZIP Code is a ZIP Code assigned to a company, agency, or entity
with sufficient mail volume to receive its own ZIP Code. |
DPVFootNote3 | Information about the matched DPV records.
|
DPVNoSTAT |
|
DPVShutdown |
|
DPVVacant |
|
Residential Delivery Indicator (RDI) Output Fields
The Residential Delivery Indicator (RDI™) is a United States Postal Service (USPS®) data product that identifies whether a delivery type is classified as residential or business. If you are shipping to residences, you may lower costs by shipping with the Postal Service™ and avoid residential delivery surcharges typically charged by other shipping companies.
Note: To use RDI, Delivery Point Validation (DPV) must also be enabled and a US Streets dataset loaded.
Field Name | Description |
---|---|
RDIRetCode | USPS Residential Delivery Indicator (RDI) return codes: • Y = Residence • N = Business • Blank = Not processed through RDI. |
LACSLink Output Fields
LACSLink data output fields contain information about a match made using the LACSLink dataset.
Field Name | Description |
---|---|
LACSLinkFlag | Indicates if the address is marked for conversion.
|
LACSLinkIND | LACSLink indicator.
|
LACSLinkRetCode | LACSLink return code.
|
LACSLinkShutdown |
|
SuiteLink Output Fields
The SuiteLink output fields contain information about a match made using the SuiteLink dataset.
Field Name | Description |
---|---|
SuiteLink_Ret_Code |
|
Short Address Output Fields
The short address output fields contain abbreviated elements of the matched address.
Field Name | Description |
---|---|
ShortAddressline | Shortest possible address line that can be constructed from available short street name and other address line components. |
ShortCityName | The output city name that appears in LASTLINE_SHORT . This
value is determined by logic similar to CITY . Whenever possible,
this city name is 13 characters or less.This output city name is determined by CASS rules. This can be either City State Name, City State Name Abbreviation, or Preferred Last Line City State Name. |
ShortLastline | The address last line. Whenever possible, this field is 29 characters or less:
|
ShortStreetName | The short street name used to construct the short address line. All attempts
are made to abbreviate this name according to the process specified by the USPS in
the 30 Character Abbreviation - Cycle M Flow Chart. If an abbreviated address
cannot be constructed that is 30 characters or less, this field then contains the
same street name value as the |
ShortPostDirectional | Postdir from the ADDRLINE_SHORT field. |
ShortPreDirectional | Predir from the ADDRLINE_SHORT field. |
ShortStreetType | Street type from the ADDRLINE_SHORT field. |
Segment Output Fields
Segment output fields contain information on the street segment identified by the data provider.
Field Name | Description |
---|---|
LeftBlockID | Census block ID from the left side of the street. Not applicable to street intersection matches. |
RightBlockID | Census block ID from the right side of the street. Not applicable to street intersection matches. |
LeftSFXBlock | The current left block suffix for Census 2010 geography. This field will be blank if the matched record is from point-level data. |
RightSFXBlock | The current right block suffix for Census 2010 geography. This field will be blank if the matched record is from point-level data. |
DataType | The type of data used to make the match.
|
DataTypeName | The source data vendor for the candidate match. |
HiRange | House number at the high end of the range. Not applicable to street intersection matches. |
HighUnit | High unit number for the range. Not applicable to street intersection matches. |
HiZip4 | High ZIP+4 for the range. Not applicable to street intersection matches. |
IsStreetAlias | The first character:
The next 2 characters:
|
LoRange | House number at the low end of the range. Not applicable to street intersection matches. |
LowUnit | Low unit number. Not applicable to street intersection matches. |
LoZip4 | Low ZIP+4 for this range. Not applicable to street intersection matches. |
NearestDistance | Gives the distance, in feet, from the input
location to the matched street segment, point address, or intersection.
Note: For reverse geocoding only. |
StreetPostDirectional | Postfix direction. Can be blank, N, S, E, W, NE, NW, SW, or SE. |
StreetPreDirectional | Prefix direction. Can be blank, N, S, E, W, NE, NW, SW, or SE. |
QCity | State, city, or finance numbers. |
RangeParity | Indicates the parity of the house number in the range:
|
RecType | The range record type:
|
RoadClass | The road class code:
|
SegmentHighRange | Provides the high house number in the segment. |
SegmentLowRange | Provides the low house number in the segment. |
SegmentDirection | Gives the direction of the segment:
|
SegmentID | Segment ID (TLID) or unique ID from premium data vendors. Not applicable to street intersection matches. |
SegmentParity | Provides the segment parity. The parity indicates which side of the street the
odd numbers in the segment are located:
|
StreetSide | The matched address is on the following side of the street:
|
ThoroughfareType | Street type. |
Other Output Fields
The Other output fields contain additional information about the match.
Field Name | Description |
---|---|
AUXUserData | User data from an auxiliary file. Blank if no auxiliary file. |
CBSADivisionName | Core Based Statistical Area (CBSA) division name. |
CBSADivisionNumber | Core Based Statistical Area (CBSA) division number. |
CBSAName | The name of the Core Based Statistical Area (CBSA) in which the address is
located. A CBSA is a collective term that refers to both metropolitan and micropolitan areas. A metropolitan area has a population of more than 50,000, and a micropolitan area has a population between 10,000 and 49,999. For more information, see Metropolitan and Micropolitan Statistical Areas section of the U.S. Census Bureau website:http://www.census.gov/population/www/metroareas/metroarea.html |
CBSANumber | Core Based Statistical Area (CBSA) number. |
CSAName | Combined Statistical Area (CSA) name. |
CSANumber | Combined Statistical Area (CSA) number. |
LAT | The latitude of the address. |
LON | The longitude of the address. |
MatchedDB | Index of geocoding dataset for matched record. |
MCDName | Minor Civil Division name from the auxiliary file. Blank if no auxiliary file match. |
MCDNumber | Minor Civil Division number from the auxiliary file. Blank if no auxiliary file match. |
MetroFlag | Indicates whether the Core Based Statistical Area (CBSA) in which the address
is located is a metropolitan area or a micropolitan area. One of the following:
|
ResolvedLine | Indicates which line in a 2-line address was used to resolve the address. |