Skip to content

Import OSM Data into Workspaces

Import OSM Data into Workspaces⚓︎

This tutorial explains how to download an area of interest from OpenStreetMap, convert it to the OpenSidewalks format, and upload it to Workspaces.

For a list of all guides on the TCAT Wiki, refer to the Guides List.

Step 1: Download Area of Interest from OpenStreetMap⚓︎

  1. Open SliceOSM in your browser.

    SliceOSM interface showing a world map with shape selection tools, a search bar, and a Generate Slice button SliceOSM interface showing a world map with shape selection tools, a search bar, and a Generate Slice button

  2. Search for a location or use the map to navigate to your area of interest, draw a bounding box (or other shape) around it, and enter a name for the area.

    SliceOSM interface showing a map of Covington, WA with a selected area of interest highlighted in purple SliceOSM interface showing a map of Covington, WA with a selected area of interest highlighted in purple

  3. Select Generate Slice, then select Download .osm.pbf once the slice is ready.

    SliceOSM showing a completed extract for Covington, WA, with a Download .osm.pbf button SliceOSM showing a completed extract for Covington, WA, with a Download .osm.pbf button

Step 2: Convert OSM Data to OSW Format⚓︎

Use the TDEI Portal to create and run a new OSW - Convert job to convert the .osm.pbf file to an OSW-format .zip package. For more information, refer to the OSW - Convert guide.

  1. Log in to the TDEI Portal.

  2. Navigate to Jobs and select Create Job.

  3. Set Job Type to OSW - Convert, Source Format to OSM, and Target Format to OSW. Upload your .osm.pbf file, then select Create.

    TDEI Portal Create Job form with Job Type set to OSW Convert, Source Format OSM, Target Format OSW, and the file us-wa-covington.osm.pbf attached TDEI Portal Create Job form with Job Type set to OSW Convert, Source Format OSM, Target Format OSW, and the file us-wa-covington.osm.pbf attached

  4. After submitting, a popup will prompt you to navigate to the Jobs page. Go there and find your Dataset-Reformat job at the top of the list. Once it shows Completed, select Download Result to download the output, which will be named <JobId>.zip.

    TDEI Portal Jobs page with a Success Download has been initiated notification banner at the top TDEI Portal Jobs page with a Success Download has been initiated notification banner at the top

Step 3: Upload to Workspaces⚓︎

  1. Navigate to Create Workspace from File and sign in. Alternatively, use the top navigation: Create Workspace > From File > Start.

  2. Fill in the Workspace Title and Project Group, set Dataset Type to OpenSidewalks, and upload the <JobId>.zip from the previous step. Select Create Workspace.

    TDEI Workspaces Create Workspace from File form with title Covington, WA, US, Dataset Type OpenSidewalks selected, and the file 35241.zip attached TDEI Workspaces Create Workspace from File form with title Covington, WA, US, Dataset Type OpenSidewalks selected, and the file 35241.zip attached

  3. The page will show Converting dataset... while the file is processed, followed by Initializing workspace... and then Importing dataset to workspace... before the process completes and the page automatically refreshes.

    Taking a while?

    This process can take anywhere from a few seconds to several minutes, depending on the size of the area and the density of mapped features.

  4. Once complete, you will be taken to the dashboard with the newly created workspace selected.

    TDEI Workspaces dashboard showing the Covington, WA, US OSW workspace selected, with a map preview of the Covington area and workspace metadata including creation date and project group ID TDEI Workspaces dashboard showing the Covington, WA, US OSW workspace selected, with a map preview of the Covington area and workspace metadata including creation date and project group ID

You have now successfully created a new workspace using the latest OSM data!

For more information on using the Workspaces platform, refer to the Workspaces User Manual.