Draft:Foundation/Local Chapters/United States/Pedestrian Working Group/Guide
| PWG Draft Page: Continually open work-in-progress page for proposed changes for the next release. Edits are welcome, after discussion on the corresponding Draft Talk (Guide, Schema) page and/or during PWG meetings. |
| This guide document is still under active construction - consider other Wiki pages to be more authoritative in cases of conflicting information! |
This is a work-in-progress draft of a quick-start guide for pedestrian infrastructure mapping developed by the Pedestrian Working Group.
A work-in-progress draft of a full tagging schema for pedestrian infrastructure mapping is available here.
Questions? Email pedestrian@openstreetmap.us!
Anatomy of a Sidewalk
Our end-goal is mapping for a sidewalk network for navigation.
Tiers
A tier-based system is used to communicate which features and tags are possible with various resources and necessary for which use cases, as follows, with further details below:
| Icon | Name | Description | Use Cases | Required Resources |
|---|---|---|---|---|
| Bronze | Basic geometry and essential tags | Basic everyday pedestrian navigation | (Older) Low-quality aerial imagery | |
| Silver | Detailed geometry and tagging | Accessibility-focused applications | (Somewhat recent) Medium-quality aerial imagery and/or low-quality street-level imagery | |
| Gold | Micromapping and advanced tagging | Advanced routers and visualizations | (Recent) High-quality aerial and/or street-level imagery or in-person survey |
If, for example, you want to map pedestrian infrastructure so that it can be used for basic everyday routing and only have low-quality aerial imagery available, you would include only the features and tags marked with a File:PWG - Bronze.svg Bronze Tier symbol.
If you have access to high-quality imagery and want to map pedestrian infrastructure so that it can be used by accessibility-focused routers, you would include all features and tags marked with a File:PWG - Bronze.svg Bronze Tier symbol or a File:PWG - Silver.svg Silver Tier symbol.
Mapping Guidelines
Sidewalks
- File:PWG - Bronze.svg
highway=footway+footway=sidewalk- Representational mapping of sidewalk centerline.
Crossings
- File:PWG - Bronze.svg
highway=crossing- Node attached to the intersecting road, indicating the location of a crossing.
- File:PWG - Bronze.svg
highway=footway+footway=crossing- Representational mapping of crossing centerline.- ⚠️ NOTE: The
tactile_paving=*tag is common onfootway=crossing
ways, but often incorrect because the tag, when applied to ways, is meant to indicate linear wayfinding tactile paving that is present along the entire way. This is exceedingly rare in the United States, so please review this section of the tactile_paving=*page for additional information and fix thetactile_paving=*tag if it is present and incorrect!
- ⚠️ NOTE: The
Connectors (exact tagging schema pending)
- File:PWG - Bronze.svg
highway=?+?=?- Connecting sidewalk centerlines and curb nodes, bridging representational mapping of centerlines and literal mapping of curb locations.
Curbs
- File:PWG - Bronze.svg
barrier=kerb- Literal mapping of curb locations.
Elements
Included below are the File:PWG - Bronze.svg Bronze Tier and File:PWG - Silver.svg Silver Tier tags, which represent a good level of detail to aim for while balancing the amount of work required to map pedestrian infrastructure in detail.
For a full listing of tags and their tier classifications, refer to the full schema here.
Sidewalks
- File:PWG - Bronze.svg
highway=footway+footway=sidewalk- Indicate sidewalk location- File:PWG - Silver.svg
surface=*- Sidewalk surface material- File:PWG - Silver.svg
surface=concrete- Concrete surface material - File:PWG - Silver.svg
surface=asphalt- Asphalt surface material - File:PWG - Silver.svg
surface=*- Any other applicable value
- File:PWG - Silver.svg
- File:PWG - Silver.svg
Crossings
- File:PWG - Bronze.svg
highway=footway+footway=crossing- Indicate crossing location
- File:PWG - Bronze.svg
highway=crossing- Indicate crossing location- File:PWG - Silver.svg
tactile_paving=*- Specify tactile paving presence at curb nodes- File:PWG - Silver.svg
tactile_paving=yes- Tactile paving is present at both curbs - File:PWG - Silver.svg
tactile_paving=partial- Tactile paving is present at only one curb - File:PWG - Silver.svg
tactile_paving=no- Tactile paving is not present at either curb
- File:PWG - Silver.svg
- File:PWG - Silver.svg
- File:PWG - Bronze.svg
crossing:markings=*- Specify presence and type of markings- File:PWG - Bronze.svg
crossing:markings=no- No markings - File:PWG - Bronze.svg
crossing:markings=yes- Markings present, type unspecified - File:PWG - Silver.svg
crossing:markings=zebra- Zebra markings - File:PWG - Silver.svg
crossing:markings=lines- Lines markings - File:PWG - Silver.svg
crossing:markings=*- Any other applicable value
- File:PWG - Bronze.svg
- File:PWG - Bronze.svg
crossing:signals=*- Specify presence and type of signalization- File:PWG - Bronze.svg
crossing:signals=no- No signals - File:PWG - Bronze.svg
crossing:signals=yes- Signals present
- File:PWG - Bronze.svg
- File:PWG - Silver.svg
crossing:island=*- Presence of pedestrian island
- File:PWG - Silver.svg
surface=*- Crossing surface material- File:PWG - Silver.svg
surface=concrete- Concrete surface material - File:PWG - Silver.svg
surface=asphalt- Asphalt surface material - File:PWG - Silver.svg
surface=*- Any other applicable value
- File:PWG - Silver.svg
Curbs
- File:PWG - Silver.svg
barrier=kerb- Indicate curb location
- File:PWG - Silver.svg
kerb=*- Specify curb type:- File:PWG - Silver.svg
kerb=raised- Raised curb - File:PWG - Silver.svg
kerb=lowered- Curb ramp - File:PWG - Silver.svg
kerb=flush- Flush curb
- File:PWG - Silver.svg
- File:PWG - Silver.svg
- File:PWG - Silver.svg
tactile_paving=*- Specify tactile paving presence- File:PWG - Silver.svg
tactile_paving=yes- Tactile paving is present - File:PWG - Silver.svg
tactile_paving=no- Tactile paving is not present
- File:PWG - Silver.svg
- File:PWG - Silver.svg
Islands
- File:PWG - Bronze.svg
highway=footway+footway=traffic_island- Indicate traffic island location- File:PWG - Silver.svg
surface=*- Traffic island surface material- File:PWG - Silver.svg
surface=concrete- Concrete surface material - File:PWG - Silver.svg
surface=asphalt- Asphalt surface material - File:PWG - Silver.svg
surface=*- Any other applicable value
- File:PWG - Silver.svg
- File:PWG - Silver.svg
Access Aisles
- File:PWG - Silver.svg
highway=footway+footway=access_aisle- Indicate access aisle location- File:PWG - Silver.svg
access_aisle:markings=*- Specify presence and type of markings- File:PWG - Silver.svg
access_aisle:markings=no- No markings - File:PWG - Silver.svg
access_aisle:markings=yes- Markings present, type unspecified - File:PWG - Silver.svg
access_aisle:markings=zebra- Zebra markings - File:PWG - Silver.svg
access_aisle:markings=ladder:skewed- Skewed ladder markings - File:PWG - Silver.svg
access_aisle:markings=*- Any other applicable value
- File:PWG - Silver.svg
- File:PWG - Silver.svg
surface=*- Access aisle surface material- File:PWG - Silver.svg
surface=concrete- Concrete surface material - File:PWG - Silver.svg
surface=asphalt- Asphalt surface material - File:PWG - Silver.svg
surface=*- Any other applicable value
- File:PWG - Silver.svg
- File:PWG - Silver.svg
Roadways
- File:PWG - Bronze.svg
highway=*- Indicate roadway location- File:PWG - Bronze.svg
sidewalk:side=*(sidewalk:left=*|sidewalk:right=*|sidewalk:both=*)- File:PWG - Bronze.svg
sidewalk:side=no- No associated sidewalk present - File:PWG - Bronze.svg
sidewalk:side=separate- Associated sidewalk is present and mapped as separate geometry
- File:PWG - Bronze.svg
- File:PWG - Bronze.svg
In-editor Examples


footway=access_aisle way ends where painted markings end, it is valuable here to connect the access aisles with an unmarked crossing to denote this navigable route.

surface=concrete rather than surface=paving_stones where appropriate.



PWG Guide and PWG Schema Releases
| PWG Guide Releases | ||
|---|---|---|
| Latest | Permanent link to latest version: wiki.osm.org/PWG_Guide | |
| Draft | Permanent link to latest draft: wiki.osm.org/PWG_Guide_Draft | |
| Talk | Permanent link to talk page: wiki.osm.org/PWG_Guide_Talk | |
| Version | Date | Changelog |
| 1.0.1 | 2026-01-30 | • Fix inclusion of footway tag on crossing nodes |
| 1.0.0 | 2025-11-19 | • Initial release |
| 1.0.0-beta | 2025-05-23 | • Initial pre-release |
| PWG Schema Releases | ||
|---|---|---|
| Latest | Permanent link to latest version: wiki.osm.org/PWG_Schema | |
| Draft | Permanent link to latest draft: wiki.osm.org/PWG_Schema_Draft | |
| Talk | Permanent link to talk page: wiki.osm.org/PWG_Schema_Talk | |
| Version | Date | Changelog |
| 1.0.0 | 2025-11-19 | • Initial release |
| 1.0.0-beta | 2025-05-23 | • Initial pre-release |