FAQ | Cheat Sheet | Specification | Incident Modules | Shared Modules | Type Values | Terminology

 

Civic Location Data

USFA NERIS - is a BETA SPECIFICATION, presented here to aid in review
WORK IN PROGRESS: This information is beta and subject to change.

The NERIS data framework provides fields and definitions for the data.

Shared Civic Location ( see Civic Location Data Exchange ). A civic location is effectively an address for a home or business
   

Grouped Fields

cldxf_named_location

Attribute Type Definition / Comment Mandatory
nl_structure Text A built feature which has a vertical dimension, including both conventional buildings which have walls, doors, and a roof, and other kinds of infrastructure such as cell towers, transformer stations, fuel tanks, and so on. -
nl_subsite Text Name of a sub-area within a larger area specified either by site name, by a thoroughfare address, or both. -
nl_site Text Name of an exterior area which is publicly known and unique within a given place. A site may contain one or more structures and/or sub-sites. -
nl_wing Text Designated part of a structure which spans one or many floors, typically including more than one unit or room and representing a significant portion of the structure floor area. -
nl_floor Text Standardized identifier for a story or level within a structure, wing, or unit. -
nl_unit_pre_type Text Part of the complete unit identifier that precedes the Unit Value and indicates the kind of unit. -
nl_unit_value Text Part of the complete unit identifier that uniquely identifies a particular unit. -
nl_room Text Single, distinctly identified, enclosed space within a structure. -
nl_section Text Identified, unenclosed area within a structure, wing, unit, or room. -
nl_row Text Identified linear feature, such as a linear arrangement of seats, workstations, equipment, or storage, within a structure, wing, unit, or room. -
nl_seat Text Identified seat, desk, workstation, or similar precise location within a structure, wing, unit, room, section, or row. -
nl_additional_info Text Information that relates to location but does not meet the definition of any other named location elements. -
nl_marker Text Uniquely identified and indivisible infrastructure component, smaller than a structure, which exists either within a structure or exterior to any structure, such as an alarm box, a utility pole, a callbox, or other similar feature. -
 
 

cldxf_address_number

Attribute Type Definition / Comment Mandatory
an_prefix Text Identifier in the portion of the complete address number that precedes the integer Address Number in order to further specify a location along a thoroughfare or within a defined area. -
an_number Integer Integer identifier of a location along a thoroughfare or within a defined community. -
an_suffix Text Identifier in the portion of the complete address number that follows the integer Address Number in order to further specify a location along a thoroughfare or within a defined area. -
an_complete Text Address Number Complete includes the Address Number Prefix (if any), the Address Number, Address Number Suffix (if any), and any formatting or separator characters needed to display the official version of the complete address number. The Address Number Complete precedes the complete street name to identify a location along a thoroughfare or within a defined area. -
an_distance_marker Text Distance travelled along a route such as a road or highway, indicated by a distance marker sign, typically a post or other marker indicating the distance in miles/kilometers from or to a given point. -
 
 

cldxf_street_name

Attribute Type Definition / Comment Mandatory
sn_pre_modifier Text Word or phrase that precedes and modifies the Street Name element but is separated from it by a Street Name Pre Type or a Street Name Pre Directional or both. -
sn_pre_dir Text Word preceding the Street Name element that indicates the direction taken by the street from an arbitrary starting point or line, or the sector where it is located. -
sn_pre_type Text Word or phrase that precedes the Street Name element and identifies a type of thoroughfare in a complete street name. -
sn_pre_type_separator Text Preposition or prepositional phrase between the Street Name Pre Type and the Street Name. -
sn_street_name Text Element of the complete street name that identifies the particular street (as opposed to any street types, directionals, and modifiers). -
sn_post_type Text Word or phrase that follows the Street Name element and identifies a type of thoroughfare in a complete street name. -
sn_post_directional Text Word following the Street Name element that indicates the direction taken by the street from an arbitrary starting point or line, or the sector where it is located. -
sn_post_modifier Text Word or phrase that follows and modifies the Street Name element and is either separated from it by a Street Name Post Type and/or a Street Name Post Directional. -
sn_dir_of_travel Text Word which follows all other street name elements and is used only as needed to indicate direction of travel on a divided roadway and associated frontage roads. -
 
 

cldxf_country_state_and_other_place_name

Attribute Type Definition / Comment Mandatory
csop_postal_comm Text City name for the ZIP Code of an address, as given in the USPS City State file. -
csop_neighborhood_comm Text Name of an unincorporated neighborhood, subdivision or area, either within an incorporated municipality, or in an unincorporated portion of a county or both, where the address is located. -
csop_unincorporated_comm Text Name of an unincorporated community, either within an incorporated municipality or in an unincorporated portion of a county, or both, where the address is located. -
csop_incorporated_muni Text Name of the incorporated municipality or other general-purpose local governmental unit (if any) where the address is located. -
csop_county Text Name of the county or county-equivalent where the address is located. A county (or its equivalent) is the primary legal division of a state or territory. -
csop_state Text Name of a state or state equivalent, represented by the two- letter UPPER CASE abbreviation given in USPS Publication 28 [15], Appendix B. A state is a primary governmental division of the United States. -
csop_postal_code Text System of 5-digit codes that identifies the individual USPS Post Office or metropolitan area delivery station associated with an address. -
csop_postal_code_ext Text System of 4-digit codes that are used after the 5-digit ZIP Code to specify a range of USPS delivery addresses. -
csop_country Text Name of a country represented by its two-letter ISO 3166-1[14] English country alpha-2 code elements in UPPER CASE letters. -
 
 

cldxf_address_descriptor

Attribute Type Definition / Comment Mandatory
place Text Type of feature identified by the address. -
 
 

neris_addition

Attribute Type Definition / Comment Mandatory
additional_attributes JSONB JSON string of structure address elements which the transmitter wishes to include. -
 
 

neris_addition.cross_street

Attribute Type Definition / Comment Mandatory
cross_street Array[Array[Text, Text]] Array of (Street name + optional address number) for the nearest intersection. -
type_cross_street Array[Text] Modifier of the cross street, such as ‘nearest’ or ‘second nearest’ -
 
 

 

Individual Fields

Group of Fields: ‘cldxf_named_location’

Field ‘nl_structure’

Attribute Value
Key nl_structure
Type Text
Overview A built feature which has a vertical dimension, including both conventional buildings which have walls, doors, and a roof, and other kinds of infrastructure such as cell towers, transformer stations, fuel tanks, and so on.
Mandatory False
Cardinality Single
 
 

Field ‘nl_subsite’

Attribute Value
Key nl_subsite
Type Text
Overview Name of a sub-area within a larger area specified either by site name, by a thoroughfare address, or both.
Mandatory False
Cardinality Single
 
 

Field ‘nl_site’

Attribute Value
Key nl_site
Type Text
Overview Name of an exterior area which is publicly known and unique within a given place. A site may contain one or more structures and/or sub-sites.
Mandatory False
Cardinality Single
 
 

Field ‘nl_wing’

Attribute Value
Key nl_wing
Type Text
Overview Designated part of a structure which spans one or many floors, typically including more than one unit or room and representing a significant portion of the structure floor area.
Mandatory False
Cardinality Single
 
 

Field ‘nl_floor’

Attribute Value
Key nl_floor
Type Text
Overview Standardized identifier for a story or level within a structure, wing, or unit.
Mandatory False
Cardinality Single
 
 

Field ‘nl_unit_pre_type’

Attribute Value
Key nl_unit_pre_type
Type Text
Overview Part of the complete unit identifier that precedes the Unit Value and indicates the kind of unit.
Mandatory False
Cardinality Single
 
 

Field ‘nl_unit_value’

Attribute Value
Key nl_unit_value
Type Text
Overview Part of the complete unit identifier that uniquely identifies a particular unit.
Mandatory False
Cardinality Single
 
 

Field ‘nl_room’

Attribute Value
Key nl_room
Type Text
Overview Single, distinctly identified, enclosed space within a structure.
Mandatory False
Cardinality Single
 
 

Field ‘nl_section’

Attribute Value
Key nl_section
Type Text
Overview Identified, unenclosed area within a structure, wing, unit, or room.
Mandatory False
Cardinality Single
 
 

Field ‘nl_row’

Attribute Value
Key nl_row
Type Text
Overview Identified linear feature, such as a linear arrangement of seats, workstations, equipment, or storage, within a structure, wing, unit, or room.
Mandatory False
Cardinality Single
 
 

Field ‘nl_seat’

Attribute Value
Key nl_seat
Type Text
Overview Identified seat, desk, workstation, or similar precise location within a structure, wing, unit, room, section, or row.
Mandatory False
Cardinality Single
 
 

Field ‘nl_additional_info’

Attribute Value
Key nl_additional_info
Type Text
Overview Information that relates to location but does not meet the definition of any other named location elements.
Mandatory False
Cardinality Single
 
 

Field ‘nl_marker’

Attribute Value
Key nl_marker
Type Text
Overview Uniquely identified and indivisible infrastructure component, smaller than a structure, which exists either within a structure or exterior to any structure, such as an alarm box, a utility pole, a callbox, or other similar feature.
Mandatory False
Cardinality Single
 
 

Group of Fields: ‘cldxf_address_number’

Field ‘an_prefix’

Attribute Value
Key an_prefix
Type Text
Overview Identifier in the portion of the complete address number that precedes the integer Address Number in order to further specify a location along a thoroughfare or within a defined area.
Mandatory False
Cardinality Single
 
 

Field ‘an_number’

Attribute Value
Key an_number
Type Integer
Overview Integer identifier of a location along a thoroughfare or within a defined community.
Mandatory False
Cardinality Single
 
 

Field ‘an_suffix’

Attribute Value
Key an_suffix
Type Text
Overview Identifier in the portion of the complete address number that follows the integer Address Number in order to further specify a location along a thoroughfare or within a defined area.
Mandatory False
Cardinality Single
 
 

Field ‘an_complete’

Attribute Value
Key an_complete
Type Text
Overview Address Number Complete includes the Address Number Prefix (if any), the Address Number, Address Number Suffix (if any), and any formatting or separator characters needed to display the official version of the complete address number. The Address Number Complete precedes the complete street name to identify a location along a thoroughfare or within a defined area.
Mandatory False
Cardinality Single
 
 

Field ‘an_distance_marker’

Attribute Value
Key an_distance_marker
Type Text
Overview Distance travelled along a route such as a road or highway, indicated by a distance marker sign, typically a post or other marker indicating the distance in miles/kilometers from or to a given point.
Mandatory False
Cardinality Single
 
 

Group of Fields: ‘cldxf_street_name’

Field ‘sn_pre_modifier’

Attribute Value
Key sn_pre_modifier
Type Text
Overview Word or phrase that precedes and modifies the Street Name element but is separated from it by a Street Name Pre Type or a Street Name Pre Directional or both.
Mandatory False
Cardinality Single
Reference
 
 

Field ‘sn_pre_dir’

Attribute Value
Key sn_pre_dir
Type Text
Overview Word preceding the Street Name element that indicates the direction taken by the street from an arbitrary starting point or line, or the sector where it is located.
Mandatory False
Cardinality Single
Reference
 
 

Field ‘sn_pre_type’

Attribute Value
Key sn_pre_type
Type Text
Overview Word or phrase that precedes the Street Name element and identifies a type of thoroughfare in a complete street name.
Mandatory False
Cardinality Single
Reference
 
 

Field ‘sn_pre_type_separator’

Attribute Value
Key sn_pre_type_separator
Type Text
Overview Preposition or prepositional phrase between the Street Name Pre Type and the Street Name.
Mandatory False
Cardinality Single
Reference
 
 

Field ‘sn_street_name’

Attribute Value
Key sn_street_name
Type Text
Overview Element of the complete street name that identifies the particular street (as opposed to any street types, directionals, and modifiers).
Mandatory False
Cardinality Single
 
 

Field ‘sn_post_type’

Attribute Value
Key sn_post_type
Type Text
Overview Word or phrase that follows the Street Name element and identifies a type of thoroughfare in a complete street name.
Mandatory False
Cardinality Single
Reference
 
 

Field ‘sn_post_directional’

Attribute Value
Key sn_post_directional
Type Text
Overview Word following the Street Name element that indicates the direction taken by the street from an arbitrary starting point or line, or the sector where it is located.
Mandatory False
Cardinality Single
Reference
 
 

Field ‘sn_post_modifier’

Attribute Value
Key sn_post_modifier
Type Text
Overview Word or phrase that follows and modifies the Street Name element and is either separated from it by a Street Name Post Type and/or a Street Name Post Directional.
Mandatory False
Cardinality Single
 
 

Field ‘sn_dir_of_travel’

Attribute Value
Key sn_dir_of_travel
Type Text
Overview Word which follows all other street name elements and is used only as needed to indicate direction of travel on a divided roadway and associated frontage roads.
Mandatory False
Cardinality Single
Reference
 
 

Group of Fields: ‘cldxf_country_state_and_other_place_name’

Field ‘csop_postal_comm’

Attribute Value
Key csop_postal_comm
Type Text
Overview City name for the ZIP Code of an address, as given in the USPS City State file.
Mandatory False
Cardinality Single
 
 

Field ‘csop_neighborhood_comm’

Attribute Value
Key csop_neighborhood_comm
Type Text
Overview Name of an unincorporated neighborhood, subdivision or area, either within an incorporated municipality, or in an unincorporated portion of a county or both, where the address is located.
Mandatory False
Cardinality Single
 
 

Field ‘csop_unincorporated_comm’

Attribute Value
Key csop_unincorporated_comm
Type Text
Overview Name of an unincorporated community, either within an incorporated municipality or in an unincorporated portion of a county, or both, where the address is located.
Mandatory False
Cardinality Single
 
 

Field ‘csop_incorporated_muni’

Attribute Value
Key csop_incorporated_muni
Type Text
Overview Name of the incorporated municipality or other general-purpose local governmental unit (if any) where the address is located.
Mandatory False
Cardinality Single
 
 

Field ‘csop_county’

Attribute Value
Key csop_county
Type Text
Overview Name of the county or county-equivalent where the address is located. A county (or its equivalent) is the primary legal division of a state or territory.
Mandatory False
Cardinality Single
 
 

Field ‘csop_state’

Attribute Value
Key csop_state
Type Text
Overview Name of a state or state equivalent, represented by the two- letter UPPER CASE abbreviation given in USPS Publication 28 [15], Appendix B. A state is a primary governmental division of the United States.
Mandatory False
Cardinality Single
Reference
 
 

Field ‘csop_postal_code’

Attribute Value
Key csop_postal_code
Type Text
Overview System of 5-digit codes that identifies the individual USPS Post Office or metropolitan area delivery station associated with an address.
Mandatory False
Cardinality Single
 
 

Field ‘csop_postal_code_ext’

Attribute Value
Key csop_postal_code_ext
Type Text
Overview System of 4-digit codes that are used after the 5-digit ZIP Code to specify a range of USPS delivery addresses.
Mandatory False
Cardinality Single
 
 

Field ‘csop_country’

Attribute Value
Key csop_country
Type Text
Overview Name of a country represented by its two-letter ISO 3166-1[14] English country alpha-2 code elements in UPPER CASE letters.
Mandatory False
Cardinality Single
Reference
 
 

Group of Fields: ‘cldxf_address_descriptor’

Field ‘place’

Attribute Value
Key place
Type Text
Overview Type of feature identified by the address.
Mandatory False
Cardinality Single
Reference
 
 

Group of Fields: ‘neris_addition’

Field ‘additional_attributes’

Attribute Value
Key additional_attributes
Type JSONB
Overview JSON string of structure address elements which the transmitter wishes to include.
Mandatory False
Cardinality Single
 
 

Group of Fields: ‘neris_addition.cross_street’

Field ‘cross_street’

Attribute Value
Key cross_street
Type Array[Array[Text, Text]]
Overview Array of (Street name + optional address number) for the nearest intersection.
Mandatory False
Cardinality Multi
 
 

Field ‘type_cross_street’

Attribute Value
Key type_cross_street
Type Array[Text]
Overview Modifier of the cross street, such as ‘nearest’ or ‘second nearest’
Mandatory False
Cardinality Multi
Reference
 
 

Alternative Views

View Description
Examples Data dictionary details on the data, types.
Overview Overview of the data.
   
 

Need more NERIS help?

Need more help with NERIS, or not yet found what you are looking for? Please see if these help …