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 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. |
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. Indicates whether the
address is for a Commercial Mail Receiving Agent (CMRA). A CMRA is a
private company that rents out mailboxes. A customer of a commercial
mail receiving agency can receive mail and other deliveries at the
street address of the CMRA rather than the customer's own street
address. Depending on the agreement between the customer and the
CMRA, the CMRA can forward the mail to the customer or hold it for
pickup.
|
DPVConfirm | Indicates if a match occurred for DPV data. Indicates whether the
address is confirmed to be a deliverable address by USPS Delivery
Point Validation (DPV).
|
DPVDna | Indicates whether this address was found in the Door Not
Accessible (DNA) Table. One of the following codes is stored:
|
DPVDrop | A Drop is a delivery point that receives mail in a single
receptacle or at a single drop site that services multiple dwellings
or businesses or primary or secondary addresses.
|
DPVEnhanced | Enhanced DPV Return Codes. Enhanced DPV return codes accommodate
an industry request for additional address information. Provide them
as an option for those mailers wanting the additional delineation of
reasons for DPV Status.
|
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 |
Provides information about the matched DPV records. It is
possible for 0 or more of the following values to be present. They
will begin in DPVFootnote3 and continue to the next available DPVFootnote<n> as needed.
|
DPVNddDays | Non-Deliverable days. 7 bytes, for Sunday through Saturday. If
Non-Delivery Days is indicated, Y or N for each day:
|
DPVNoSTAT |
|
DPVNsl | No Secure Location. Indicates whether this address was found in
the No Secure Location (NSL) table. One of the following codes is stored:
|
DVPNsr | NOSTAT Reason Code. If Address is a NoStat, this indicates the reason:
|
OrigDpbc | Original Delivery Point Bar Code |
DPVPbsa | Indicates whether this address was found in the PBSA table. One
of the following codes is stored:
|
DPVShutdown |
|
DPVThrowback | Indicates whether this address was found in the Throwback Table.
One of the following codes is stored:
|
DPVVacant |
|
NonDeliverable | Non-Deliverable Record Indicator. Indicates if the USPS can
deliver mail to the output address.
|
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. |