TIGER to OSM Attribute Map
From OpenStreetMap
see also TIGER
The TIGER to OSM Attribute Map is one of the key details which need to be figured out as part of the TIGER data importing efforts.
[edit] Base Attribute Pairs
[edit] Feature Name
TIGER names are split across four fields (:fedirp, :fename, :fetype, :fedirs) containing direction prefix ("NE"), name ("72nd"), type ("Ave"), and direction suffix ("W"). All fields are optional, and it if one is present it must be the :fename field. All four fields together form the name of the feature ("NE 72nd Ave W"). TIGER features may have more than one name.
Names are defined per link, and so can be inconsistent (slight differences in spacing, abbreviation, etc.), especially for very long roads.
Name components should be preserved to enable the OSM to be used as a geocoding dataset.
In pseudocode:
| OSM Key | TIGER Field | Example |
|---|---|---|
| name | "#{fedirp} #{fename} #{fetype} #{fedirs}".strip | "NW Chester St S" |
| name_direction_prefix | fedirp | "NW", "Southwest" |
| name_base | fename | "Chester" |
| name_type | fetype | "Street", "Ave" |
| name_direction_suffix | fedirs | "S" |
For each additional name:
| OSM Key | TIGER Field |
|---|---|
| name_1 | "#{fedirp} #{fename} #{fetype} #{fedirs}".strip |
| name_direction_prefix_1 | fedirp |
| name_base_1 | fename |
| name_type_1 | fetype |
| name_direction_suffix_1 | fedirs |
et cetera.
[edit] Address Ranges
TIGER road features have one or more associated address ranges. These should be preserved to enable the OSM to be used as a geocoding dataset.
Should adjacent TIGER features which are part of the same road be made into a single contiguous way? If we don't do this, we'll be back to a similar situation to where we were when there were no ways, only segments. Here's an example of how directly relating TIGER features looks when rendered.
If the features are combined into a single way, how to we preserve addressing information?
| OSM Key | TIGER Field |
|---|---|
| from_address_right | fraddr |
| to_address_right | toaddr |
| from_address_left | fraddl |
| to_address_left | toaddl |
| zip_left | zipl |
| zip_right | zipl |
For each additional address range:
| OSM Key | TIGER Field |
|---|---|
| from_address_right_1 | fraddr |
| to_address_right_1 | toaddr |
| from_address_left_1 | fraddl |
| to_address_left_1 | toaddl |
| zip_left_1 | zipl |
| zip_right_1 | zipl |
et cetera
[edit] Preserved TIGER fields
The Tiger Line ID (tlid) as well as the TIGER start and end zero-cell fields, and maybe the raw CFCC should be preserved, just for the hell of it. For each additional address range:
| OSM Key | TIGER Value | Note |
|---|---|---|
| tiger:tlid | tlid | |
| tiger:tzid | tzids | applied to first node in way |
| tiger:tzid | tzide | applied to last node in way |
| tiger:cfcc? | cfcc? |
[edit] Misc Attribute Pairs
| Key | Value | Notes |
|---|---|---|
| source | tiger_import_#{date}n | eg. tiger_import_20070127 |
| reviewed | no | Lines do now show up on the map until reviewed |
[edit] TIGER CFCC to OSM Attribute Pair
The following is a map of TIGER Census Feature Class Codes (CFCCs) to a set of OSM key/value pairs, for use providing some default annotation to OSM data imported directly from TIGER. The map is encoded in valid Ruby. A complete list of CFCCs with their descriptions can be found in the TIGER/Line Technical Documentation (PDF link), and a list of currently used OSM key/value pairs can be found at Map Features.
[edit] New Attributes for TIGER
Not all keys used in the map are currently cited in Map Features. In order to preserve the information in the TIGER/line CFCC code, the following additions may be necessary:
- :separated - In the OSM the separation of the road is an implicit property of the highway type, where the TIGER CFCC has different * codes for separated and unseparated highways of the same highway class.
- :rail + :highway - TIGER has a CFCC for a highway with a railroad running down the middle. In the OSM this could be modeled by a Way with both a :rail and a :highway tag.
[edit] Map
[edit] Primary roads with limited access
Interstate highways and some toll highways are in this category (A1) and are distinguished by the presence of interchanges. These highways are accessed by way of ramps and have multiple lanes of traffic. The opposing traffic lanes are divided by a median strip. The TIGER/Line files may depict these opposing traffic lanes as two distinct lines in which case, the road is called separated.
| CFCC | Description | OSM Attributes | Notes |
|---|---|---|---|
| A00 | Road feature; classification unknown or not elsewhere classified | :highway = :unclassified | |
| A11 | Primary road with limited access or interstate highway, unseparated | :highway => :motorway, :separated => :no | |
| A12 | Primary road with limited access or interstate highway, unseparated, in tunnel | :highway => :motorway, :separated => :no, :tunnel => :yes | |
| A13 | Primary road with limited access or interstate highway, unseparated, underpassing | :highway => :motorway, :separated => :no, :layer => -1 | |
| A14 | Primary road with limited access or interstate highway, unseparated, with rail line in center | :highway => :motorway, :separated => :no, :railway => :rail | |
| A15 | Primary road with limited access or interstate highway, separated | :highway => :motorway, :separated => :yes | |
| A16 | Primary road with limited access or interstate highway, separated, in tunnel | :highway => :motorway, :separated => :yes, :tunnel => :yes | |
| A17 | Primary road with limited access or interstate highway, separated, underpassing | :highway => :motorway, :separated => :yes, :layer => -1 | |
| A18 | Primary road with limited access or interstate highway, separated, with rail line in center | :highway => :motorway, :separated => :yes, :railway => :rail | |
| A19 | Primary road with limited access or interstate highway, bridge | :highway => :motorway, :bridge => :yes |
[edit] Primary roads without limited access
This category (A2) includes nationally and regionally important highways that do not have limited access as required by category A1. It consists mainly of US highways, but may include some state highways and county highways that connect cities and larger towns. A road in this category must be hard-surface (concrete or asphalt). It has intersections with other roads, may be divided or undivided, and have multi-lane or single-lane characteristics.
| CFCC | Description | OSM Attributes | Notes |
|---|---|---|---|
| A21 | Primary road without limited access, US highways, unseparated | :highway => :primary, :separated => :no | |
| A22 | Primary road without limited access, US highways, unseparated, in tunnel | :highway => :primary, :separated => :no, :tunnel => :yes | |
| A23 | Primary road without limited access, US highways, unseparated, underpassing | :highway => :primary, :separated => :no, :layer => -1 | |
| A24 | Primary road without limited access, US highways, unseparated, with rail line in center | :highway => :primary, :separated => :no, :railway => :rail | |
| A25 | Primary road without limited access, US highways, separated | :highway => :primary, :separated => :yes | |
| A26 | Primary road without limited access, US highways, separated, in tunnel | :highway => :primary, :separated => :yes, :tunnel => :yes | |
| A27 | Primary road without limited access, US highways, separated, underpassing | :highway => :primary, :separated => :yes, :layer => -1 | |
| A28 | Primary road without limited access, US highways, separated, with rail line in center | :highway => :primary, :separated => :yes, :railway => :rail | |
| A29 | Primary road without limited access, US highways, bridge | :highway => :primary, :bridge => :yes |
[edit] Secondary and connecting road
This category (A3) includes mostly state highways, but may include some county highways that connect smaller towns, subdivisions, and neighborhoods. The roads in this category generally are smaller than roads in Category A2, must be hardsurface (concrete or asphalt), and are usually undivided with single-lane characteristics. These roads usually have a local name along with a route number and intersect with many other roads and driveways.
| CFCC | Description | OSM Attributes | Notes |
|---|---|---|---|
| A31 | Secondary and connecting road, state and county highways, unseparated | :highway => :secondary, :separated => :no | |
| A32 | Secondary and connecting road, state and county highways, unseparated, in tunnel | :highway => :secondary, :separated => :no, :tunnel => :yes | |
| A33 | Secondary and connecting road, state and county highways, unseparated, underpassing | :highway => :secondary, :separated => :no, :layer => -1 | |
| A34 | Secondary and connecting road, state and county highways, unseparated, with rail line in center | :highway => :secondary, :separated => :no, :railway => :rail | |
| A35 | Secondary and connecting road, state and county highways, separated | :highway => :secondary, :separated => :yes | |
| A36 | Secondary and connecting road, state and county highways, separated, in tunnel | :highway => :secondary, :separated => :yes, :tunnel => :yes | |
| A37 | Secondary and connecting road, state and county highways, separated, underpassing | :highway => :secondary, :separated => :yes, :layer => -1 | |
| A38 | Secondary and connecting road, state and county highway, separated, with rail line in center | :highway => :secondary, :separated => :yes, :railway => :rail | |
| A39 | Secondary and connecting road, state and county highways, bridge | :highway => :secondary, :bridge => :yes |
[edit] Local, neighborhood, and rural roads
A road in this category (A4) is used for local traffic and usually has a single lane of traffic in each direction. In an urban area, this feature is a neighborhood road and street that is not a thorough-fare belonging in categories A2 or A3. In a rural area, this is a short-distance road connecting the smallest towns; the road may or may not have a state or county route number. Scenic park roads, unimproved or unpaved roads, and industrial roads are included in this category. Most roads in the United States are classified as A4 roads.
Proposal: A4x would be better as "unclassified" than as "residential"
| CFCC | Description | OSM Attributes | Notes |
|---|---|---|---|
| A41 | Local, neighborhood, and rural road, city street, unseparated | :highway => :residential, :separated => :no | |
| A42 | Local, neighborhood, and rural road, city street, unseparated, in tunnel | :highway => :residential, :separated => :no, :tunnel => :yes | |
| A43 | Local, neighborhood, and rural road, city street, unseparated, underpassing | :highway => :residential, :separated => :no, :layer => -1 | |
| A44 | Local, neighborhood, and rural road, city street, unseparated, with rail line in center | :highway => :residential, :separated => :no, :railway => :rail | |
| A45 | Local, neighborhood, and rural road, city street, separated | :highway => :residential, :separated => :yes | |
| A46 | Local, neighborhood, and rural road, city street, separated, in tunnel | :highway => :residential, :separated => :yes, :tunnel => :yes | |
| A47 | Local, neighborhood, and rural road, city street, separated, underpassing | :highway => :residential, :separated => :yes, :layer => -1 | |
| A48 | Local, neighborhood, and rural road, city street, separated, with rail line in center | :highway => :residential, :separated => :yes, :railway => :rail | |
| A49 | Local, neighborhood, and rural road, city street, bridge | :highway => :residential, :bridge => :yes |
[edit] Vehicular trail
A road in this category (A5) is usable only by four-wheel drive vehicles, is usually a one-lane dirt trail, and is found almost exclusively in very rural areas. Sometimes the road is called a fire road or logging road and may include an abandoned railroad grade where the tracks have been removed. Minor, unpaved roads usable by ordinary cars and trucks belong in category A4, not A5.
| CFCC | Description | OSM Attributes | Notes |
|---|---|---|---|
| A51 | Vehicular trail, road passable only by 4WD vehicle, unseparated | :highway => :track, :separated => :no | |
| A52 | Vehicular trail, road passable only by 4WD vehicle, unseparated, in tunnel | :highway => :track, :separated => :no, :tunnel => :yes | |
| A53 | Vehicular trail, road passable only by 4WD vehicle, unseparated, underpassing | :highway => :track, :separated => :no, :layer => -1 |
[edit] Roads with special characteristics
This category (A6) includes roads, portions of a road, intersections of a road, or the ends of a road that are parts of the vehicular highway system and have separately identifiable characteristics.
| CFCC | Description | OSM Attributes | Notes |
|---|---|---|---|
| A60 | Special road feature, major category used when the minor category could not be determined | :highway => :unclassified | |
| A61 | Cul-de-sac, the closed end of a road that forms a loop or turn-around | :highway => :unclassified, :noexit => :yes | |
| A62 | Traffic circle, the portion of a road or intersection of roads forming a roundabout | :highway => :unclassified, :junction => :roundabout | |
| A63 | Access ramp, the portion of a road that forms a cloverleaf or limitedaccess interchange | :highway => :motorway_link | |
| A64 | Service drive, the road or portion of a road that provides access to businesses, facilities, and rest areas along a limited-access highway; this frontage road may intersect other roads and be named | :highway => :unclassified, :note => :frontage | Subject to some debate. Perhaps needs a :highway => :frontage tag. |
| A65 | Ferry crossing, the representation of a route over water that connects roads on opposite shores; used by ships carrying automobiles or people | :route => :ferry | |
| A66 | Gated barrier to travel | :highway => :gate | |
| A67 | Toll booth barrier to travel | :highway => :toll_booth |
[edit] Road as other thoroughfare
A road in this category (A7) is not part of the vehicular highway system. It is used by bicyclists or pedestrians, and is typically inaccessible to mainstream motor traffic except for privateowner and service vehicles. This category includes foot and hiking trails located on park and forest land, as well as stairs or walkways that follow a road right-of-way and have names similar to road names.
| CFCC | Description | OSM Attributes | Notes |
|---|---|---|---|
| A70 | Other thoroughfare, major category used when the minor category could not be determined | :highway => :unclassified | |
| A71 | Walkway or trail for pedestrians, usually unnamed | :highway => :footway | |
| A72 | Stairway, stepped road for pedestrians, usually unnamed | :highway => :steps | |
| A73 | Alley, road for service vehicles, usually unnamed, located at the rear of buildings and property | :highway => :service | |
| A74 | Private road or drive for service vehicles, usually privately owned and unnamed. Primary type of use is for access to oil rigs, farms, or ranches | :highway => :unclassified, :access => :private | |
| A75 | Internal U.S. Census Bureau use | no mapping |
[edit] RAILROADS
[edit] Main line
Railroad Main Line A railroad in this category is the primary track that provides service between destinations. A main line track often carries the name of the owning and operating railroad company.
| CFCC | Description | OSM Attributes | Notes |
|---|---|---|---|
| B11 | Railroad main track, not in tunnel or underpassing | :railway => :rail | |
| B12 | Railroad main track, in tunnel | :railway => :rail, :tunnel => :yes | |
| B13 | Railroad main track, underpassing | :railway => :rail, :layer => -1 | |
| B14 | Abandoned/inactive rail line with tracks present | :railway => :disused | |
| B15 | Abandoned rail line with grade, but no tracks | :railway => :abandoned | |
| B16 | Abandoned rail line with track and grade information unknown | :railway => :abandoned | could use some distinction from B15 |
| B19 | Railroad main track, bridge | :railway => :rail, :bridge => :yes |
[edit] Spur
A railroad in this category is the track that leaves the main track, ending in an industrial park, factory, or warehouse area, or forming a siding along the main track.
| CFCC | Description | OSM Attributes | Notes |
|---|---|---|---|
| B21 | Railroad spur track, not in tunnel or underpassing | :railway => :spur | |
| B22 | Railroad spur track, in tunnel | :railway => :spur, :tunnel => :yes | |
| B23 | Railroad spur track, underpassing | :railway => :spur, :layer => -1 | |
| B29 | Railroad spur track, bridge | :railway => :spur, :bridge => :yes |
[edit] Railroad Yard
A railroad yard track has parallel tracks that form a working area for the railroad company. Train cars and engines are repaired, switched, and dispatched from a yard.
| CFCC | Description | OSM Attributes | Notes |
|---|---|---|---|
| B31 | Railroad yard track, not in tunnel or underpassing | :railway => :yard | |
| B32 | Railroad yard track, not in tunnel or underpassing | :railway => :yard, :tunnel => :yes | |
| B33 | Railroad yard track, not in tunnel or underpassing | :railway => :yard, :layer => -1 | |
| B39 | Railroad yard track, not in tunnel or underpassing | :railway => :yard, :bridge => :yes |
[edit] Railroad with Special Characteristics
A railroad or portions of a railroad track that are parts of the railroad system and have separately identifiable characteristics.
| CFCC | Description | OSM Attributes | Notes |
|---|---|---|---|
| B40 | Railroad ferry crossing, the representation of a route over water used by ships carrying train cars to connecting railroads on opposite shores. These are primarily located on the Great Lakes. | :railway => :rail, :route => :ferry |
[edit] Railroad as Other Thoroughfare
A rail line that is not part of the railroad system. This category is for a specialized rail line or railway that is typically inaccessible to mainstream railroad traffic.
| CFCC | Description | OSM Attributes | Notes |
|---|---|---|---|
| B50 | Other rail line; major category used alone when the minor category could not be determined | :railway => :unknown | |
| B51 | Streetcars, trolleys, and other mass transit systems | :railway => :light_rail | |
| B52 | Cog railroad, incline railway, or logging tram | :railway => :incline |
[edit] Miscellaneous Ground Transportation With Category Unknown
Source materials do not allow determination of the miscellaneous ground transportation category.
| CFCC | Description | OSM Attributes | Notes |
|---|---|---|---|
| C00 | Miscellaneous ground transportation, not road or railroad; major and minor categories unknown | import without attributes |
[edit] Pipeline
Enclosed pipe, carrying fluid or slurry, situated above ground, or in special conditions, below ground when marked by a cleared right-ofway and signage.
| CFCC | Description | OSM Attributes | Notes |
|---|---|---|---|
| C10 | Pipeline; major category used alone | :man_made => :pipeline |
[edit] Power Transmission Line
High voltage electrical line, on towers, situated on cleared right-of-way.
| CFCC | Description | OSM Attributes | Notes |
|---|---|---|---|
| C20 | Power transmission line; major category used alone | :power => :line |
[edit] Miscellaneous Ground Transportation With Special Characteristics
A portion of a ground transportation system that has separately identifiable characteristics. This category is for specialized transportation, usually confined to a local area, that is separate from other ground transportation.
| CFCC | Description | OSM Attributes | Notes |
|---|---|---|---|
| C30 | Other ground transportation that is not a pipeline or a power transmission line; major category used alone when minor category could not be determined | import without attributes | |
| C31 | Aerial tramway, monorail, or ski lift | :aerialway => :unknown | |
| C32 | Pier/dock a platform built out from the shore into the water and supported by piles; provides access to ships and boats | :man_made => :pier |
[edit] Sample TIGER/line Maps
Wisconsin: http://farm2.static.flickr.com/1230/536480556_318ed75054_o.png
Seattle, Washington: http://farm2.static.flickr.com/1390/536594719_b2fbda6d89_o.png
San Juan Island, Washinton: test data uploaded to OSM and rendered http://labs.metacarta.com/osm/?lat=6163799.79449&lon=-13693354.33969&zoom=15&layers=B00
