README.md

OpenTrailMap

opentrailmap.us

This is a prototype web map application for viewing OpenStreetMap (OSM) trail data. The tool is being developed in support of our Trails Stewardship Initiative, a community project to improve the quality of trail data in OSM.

⚠️ This tool is still in early development and serves as a proof-of-concept. OpenStreetMap US is seeking funding partners to build out the tool as the primary app for visualizing, updating, validating, and maintaining OpenStreetMap trail data in the United States. The app will close the feedback loop between trail users, trail managers, and trail mappers. If you or your organization are interested in supporting this tool, please contact us or consider donating.

Prototype functionality

UI features

• View OpenStreetMap trail data using various map styles.
• Click a feature to view its current tags, relations, and metadata.
• Use quick links to open the feature on openstreetmap.org, iD, JOSM, and other viewers.

Map styles

OpenTrailMap aims to display all land trails, snow trails, and water trails present in OpenStreetMap.

Land and snow trails

The following styles show allowed trail access for different travel modes. Dark green lines are public paths, while striped pale green lines are restricted or infeasible for the given travel mode. Dashed lines are informal=yes, while solid lines are infomal=no or informal not given.

• Hiking & Walking Trails (foot access)
• Wheelchair Trails (wheelchair access)
• Biking Trails (bicycle access)
• Mountain Biking Trails (mtb access)
• Inline Skating Trails (inline_skates access)
• Horseback Riding Trails (horse access)
• ATV Trails (atv access)
• Cross-Country Ski Trails (ski:nordic access)
• Snowmobile Trails (snowmobile access)

The following styles highlight the presence and values of trail attribute tags. Purple lines mean an attribute is missing, incomplete, or needs review, while teal lines indicate the attribute is good to go.

• operator/informal
• name/noname
• surface
• smoothness
• trail_visibility
• width
• incline
• fixme/todo
• check_date/survey:date
• Last Edited Date: the timestamp of the latest version of the feature

In all the land and snow styles, some trail-related points of interest are included on the map:

• amenity=ranger_station: ranger stations are generally public visitor centers where trail users can get info or seek help
• highway=trailhead: trailheads are access points to trail networks, often with various amenities
• information=guidepost: signage marking the direction of one or more trails, typically at a trailhead or junction
• information=route_marker: signage marking the route of a trail

Water trails

Currently, just one marine travel mode is supported:

• Canoe & Kayak Trails (canoe/portage access)

The following water trail attribute styles are supported:

• name/noname/waterbody:name
• tidal
• intermittent
• rapids
• open_water
• oneway:canoe/oneway:boat
• width
• fixme/todo
• check_date/survey:date
• Last Edited Date: the timestamp of the latest version of the feature

Map tiles

Trail vector tiles are rendered and hosted by OpenStreetMap US using the schema files here. Thank you to @zelonewolf for setting up the vector tile pipeline. Render time is currently about 4 hours, so any changes you make will take 4 to 8 hours to appear on the map. Map tiles are not available for public use at this time.

The trail vector tilesets are segmented so you do not have to download data that you're not viewing. Namely, the water trail tiles are distinct from the land trail tiles.

Get involved

Code of Conduct

Participation in OpenTrailMap is subject to the OpenStreetMap US Code of Conduct. Please take a moment to review the CoC prior to contributing, and remember to be nice :)

Contributing

You can open an issue in this repository if you have a question or comment. Please search existing issues first in case someone else had the same thought. Pull request are public, but we recommend opening or commenting on an issue before writing any code so that we can make sure your work is aligned with the goals of the project.

We also collaborate via the #opentrailmap channel on OpenStreetMap US Slack. Anyone is free to join.

Development setup

1. Clone the repository
2. Open your terminal and cd into the repo's directory
3. Run npm install and npm run build (first-time setup only)
4. Run node serve.js to start the development server
5. Visit http://localhost:4001 in your browser
6. That's it!

Building sprites

Source vector images for use in the map are located at /style/sprites/svg/. If you add or change any of these, you'll need to rebuild the spritesheets.

1. Install the spreet command line tool
2. Run npm run sprites

License

The OpenTrailMap source code is distributed under the MIT license. Dependencies are subject to their respective licenses.