Unnamed sidewalks got you turned around? Never fear, for Sidewalk Sidekick is here!
OpenStreetMap predominantly models a sidewalk as a distinct linear feature running parallel to the street, connecting to the street network only at each crosswalk. A standard pedestrian route generated by an OSM-based routing engine lacks enough narrative detail like street names for pedestrians to comprehend without reading the map.
Sidewalk Sidekick demonstrates how to take a standard pedestrian route generated by Valhalla, feed its geometry back into Valhalla’s map matching utility, pretending it’s a car route, then collating the names in the response with the original route’s unnamed steps, performing find and replace on individual instructions.
Ideally, Valhalla would perform trace_route internally and output the enriched instructions without any client intervention. Internally, Valhalla has access to much more extensive context about the routing graph and structured metadata for forming each instruction.
This demo lets you route between any two waypoints as a pedestrian. A handful of preset routes are provided for your convenience. After setting the waypoints, click Amaze Me! to see the difference between the raw and matched responses. Click on an individual instruction to focus the map on it.
The raw pedestrian route is plotted on the map in purple, marking each coordinate along the route line with a gray dot and each maneuver with a ⌘ symbol. The result of matching this route to the road network is plotted as a dashed green line. A gray strut links each coordinate along the route line with the corresponding coordinate along the matched line.
- Nguyen, Minh. “Re: Don't recommend "description=... sidewalk"”. OpenSidewalks-Schema. GitHub. 21 March 2022.
- Nguyen, Minh. “Re: Announcement / request for comments: naming sidewalks in Toronto.” OpenStreetMap Community Forum. 13 January 2025.
- Nguyen, Minh. “Route along sidewalk should name the street to follow”. Valhalla. GitHub. 9 October 2025.
- Nguyen, Minh. “Inferring names for sidewalks using map matching”. OpenStreetMap Community Forum. 9 October 2025.