https://github.com/jake-low/usfs-to-osm

Convert USFS road and trail data to an OSM-compatible schema
https://github.com/jake-low/usfs-to-osm

Last synced: 6 days ago
JSON representation

Convert USFS road and trail data to an OSM-compatible schema

• Host: GitHub
• URL: https://github.com/jake-low/usfs-to-osm
• Owner: jake-low
• License: isc
• Created: 2024-07-11T19:36:11.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2024-07-23T18:20:34.000Z (4 months ago)
• Last Synced: 2024-07-23T21:35:43.508Z (4 months ago)
• Language: Python
• Size: 15.6 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Python scripts to convert USFS road and trail data to an OSM-compatible schema.

Status:

- **Roads**: mostly feature complete

- **Trails**: WIP; incomplete support for snow trails, motorized trails, and seasonal access restrictions

- **Recsites**: WIP; currently only trailheads are supported and other features are dropped

## Data sources

### Roads and Trails

You can download the required datasets from the [FS Data Clearinghouse](https://data.fs.usda.gov/geodata/edw/datasets.php). The specific datasets are "National Forest System Roads" (`S_USA.RoadCore`) and "National Forest System Trails" (`S_USA.TrailNFS_Publish`). You should download them in Geodatabase format (Shapefiles won't work with these scripts since the column names are truncated).

### Recreation POIs (recsites)

The "Recreation Opportunities" dataset can be downloaded as GeoJSON from the following URL:

https://data-usfs.hub.arcgis.com/datasets/usfs::recreation-opportunities-feature-layer/explore

## Running

The `justfile` in this repo can be used to run the conversion using the [`just`](https://github.com/casey/just) command runner. Or you can just paste the same series of commands into your shell.

The input files are assumed to be in `~/Downloads`; edit the script to change this path if required.

The code requires a fairly recent version of Python (3.9+ I think?). It also requires the `ogr2ogr` command from GDAL, and `jq` for JSON processing.

## Documentation

The conversion applied by this tool is based on the interpretation of the USFS data described on the [US Forest Service Data](https://wiki.openstreetmap.org/wiki/US_Forest_Service_Data) page on the OSM wiki.

## License

This code is available under the ISC license. See the LICENSE file for details.