Richmond, Virginia/Tags
Below are some guidelines for editing OpenStreetMap in Richmond, Virginia.
We welcome any suggestions or feedback, please get in touch!
Bicycle Infrastructure
Generally, Richmond mappers follow the accepted practices documented in the OpenStreetMap Wiki and the consensus among active mappers in other cities in the US.
Tagging of Bike Lanes
In OpenStreetMap, cycle tracks can be mapped either as separated ways, or as a part of the road they run along. See Key:cycleway#Cycle Tracks for more information.
In Richmond, our preference is to add the cycleway=* tag to the road when there is no physical protection between vehicles and bicycles (unless the cycle track is two-way, see below). This includes buffer spaces with flexible bollards (a.k.a flexposts or candlesticks) and a buffer space that has parking.
Bicycle facilities are mapped separately from the road (as highway=cycleway) when there is physical protection (i.e. concrete median, jersey barrier, curbs, etc.) or there is a two-way cycle track separated with a buffer (with at minimum flexible bollards) from vehicle traffic. In these cases, parallel carriageways should be tagged with e.g. cycleway:left=separate to communicate the existence of a separately-mapped cycle track way.
Examples
- This section of Brook Road is tagged with
cycleway:right=trackto denote its cycleway. There should not be a separate way tagged withhighway=cyclewayalong Brook Road here because while the buffer space does contain parking spaces, there is still no physical protection. - This section of E. Franklin Street is tagged with the bicycle facility as a separate feature because it is a two-way cycle track separated from vehicles with a buffer space containing flexible bollards. The road also has an additional
cycleway=separatetag.
Pedestrian Infrastructure
We prefer to map sidewalks as separate ways in Richmond. There is an ongoing project to fill in the sidewalks, crossings, and other pedestrian infrastructure around our city.
Footway Links
The use of footway=link is encouraged. Footway links are valuable to describe how pedestrians might commonly travel where there is not a traditional footway=*. footway=link is most commonly used to create connections between sidewalks and roads, where such a connection might be necessary or convenient for a pedestrian to reach a nearby destination. footway=link is most useful to routing engines and pedestrian mapping styles, and may not be rendered in maps intended for other modes of transportation.
While it is common to map foot path surfaces after their ways are initially drawn, it is good practice to tag footway links with a surface=* tag upon creation. This is because footway links are not well-known to all OSM users, and folks using surveying apps like StreetComplete for example might not easily identify which surface is in question.
Common Mistakes
footway=linkshould not be used on any sort of established foot path, or wherefootway=crossingwould be appropriate
- Short ways between a crossing and the centerline of a sidewalk are considered a part of the sidewalk and should be tagged with
footway=sidewalk. - Anywhere a pedestrian could reasonably cross a road,
footway=crossingshould be used, withcrossing:markings=noif there are no markings on the street.footway=crossingdoes not imply that a pedestrian must fully cross!
Examples
- Here,
footway=linkis used to connect a sidewalk way to the centerlines of adjacent service roads. This keeps the sidewalk's geometry well-defined, while connecting the two highways for routing purposes. - In apartment complexes, it's common to use
footway=linkways to connect sidewalk segments to residential roads, like is done here. - Occasionally,
footway=linkis appropriate where pedestrians could be meaningfully expected to travel, but there is no real path (informal or not). For example, this link between a sidewalk and unmarked crossing along Douglasdale Road. This Bing Streetside image shows that there is no path from the sidewalk to the curb at this corner, yet for navigation purposes it is reasonable to have a footway link connecting these ways.
Sidewalks vs. Foot Paths
Sidewalks are distinct from other highway=footway ways in that they run along a carriageway. These ways should have the additional tag footway=sidewalk. In Richmond, this distinction is usually clear. Short ways connecting a sidewalk out to a crossing in an intersection may also be tagged with footway=sidewalk.
There are other values of footway=* that you should consider using (see Footway Links above). For example, footway=residential may be used on ways in and around housing complexes and single-family homes. We have not established a firm standard for the use of this tag, however.
Tagging Roads
We have decided that adding sidewalk=separate to all roads in Richmond is out of scope for our current sidewalk-mapping project. We welcome your help adding these tags where we have completed mapping sidewalks as separate ways.
Unmarked Crossings
We add unmarked crossing ways wherever two footways can be reasonably connected across a carriageway for routing purposes. This includes but is not limited to crossings at intersections. Wherever a pedestrian could reasonably cross a carriageway to reach a local destination, an unmarked crossing should be added if there is not one nearby. The omission of an unmarked crossing should indicate that it is unsafe and/or illegal to cross in a vicinity. Mapping curbs on unmarked crossing ways is encouraged.
Common Mistakes
If a pedestrian may enter a carriageway at a location but could not reasonably cross it, an unmarked crossing is not appropriate and you should consider adding a footway link instead (see above).
Neighborhoods
Neighborhoods are tagged as nodes in the center of the neighborhood with place=neighbourhood (note the British English spelling).
Name=Jackson Ward
place=neighbourhood
Neighborhoods may or may not be aggregated into areas or Ends/Sides, tagged as listed in the sections below.
Ends and Sides
Richmond is traditionally quartered into the East End, West End, Northside, and Southside (or South Richmond). While it runs contrary to the North American definition of a suburb (localities outside of a city), we have agreed that, following OpenStreetMap conventions, these are tagged as a node with place=suburb:
Use
place=suburbto identify a major area in aplace=townorplace=citywith a distinct and recognized local name and identity. Suburbs may have uncertain boundaries, may overlap with other suburbs, and are often best mapped using a node.
We have placed nodes representing the theoretical center of these areas and tagged them similar to:
Name=Southside
place=suburb
Areas
Some colloquially-referenced areas of Richmond within an End/-side can be comprised of multiple neighborhoods. Take, for example, Church Hill: while it is itself a neighborhood, many use "Church Hill" to refer to the combined neighborhoods of Church Hill, Church Hill North, Libby Hill, Chimborazo, Oakwood, Union Hill, and Fairmount.
We have agreed that, following OpenStreetMap conventions, these are tagged as place=quarter. Note that not all neighborhoods are in, or must be, part of a quarter.
The tag
place=quartershould be applied to a named part of a bigger settlement where this part is smaller than aplace=suburband bigger than aplace=neighbourhood.
We have placed nodes representing the theoretical center of these areas and tagged them similar to:
Name=Church Hill
place=quarter
Surveillance
Surveillance mapping in Richmond largely follows the process outlined by Deflock, with the addition of surveillance devices beyond automatic license plate readers (ALPRs).
Flock Safety
The predominance of Flock devices are located in easements owned by the operator (the locality or private entity). In areas where installation of a custom pole is easy -- grass medians -- devices are located under solar panels atop c. 20' tall black carbon fiber poles (example here). In areas where it would involve removal of hard substrate, devices and solar panels are affixed directly to pieces of infrastructure owned by the locality (street lights, e.g.).
ALPRs (Falcons)
Gunshot detectors (Ravens)

Operators
Flock technology is leased by Flock Safety to a particular operator. If you know the operator, you can tag them as well. These are the most common situations we see:
- Public property in the City of Richmond
- Public property in Henrico County
- Lowe's Home Improvement Parking lot
Ocean10 Security
Mostly located in the subsidized housing developments of Richmond, characterized by a white box with multiple directional cameras. The model branding, "Tsunami", is place conspicuously on a plate affixed to the box. These cameras are not ALPRs, but general public surveillance systems. Example here.
Leonardo
Leonardo ELSAG ALPRs are more rectangular in shape than Flock Falcons, with much larger solar panels (approximately 1' x 3'). Example here.