Skip to content

Home

Jump to bottom Edit New page
Justin Palmer edited this page Aug 3, 2015 · 13 revisions

Introduction

Welcome to the The Portland Metro Region Building Import! Here you'll find all the information and instructions you need to import the Portland buildings data set to OpenStreetMap. Please read all these steps to make a complete building import.

Table of Contents

Background

The goal of this import is to add building and associated address data from publicly available datasets in the Portland, OR USA, metropolitan region. This region includes not only the city of Portland but 24 other cities in Clackamas, Multnomah, and Washington counties. More background on where this data came from and the preprocess steps can be found here.

The scripts and code for creating the data are have been run to create the building footprints that are now available as downloadable OSM files ready for validating in JOSM. Once these files are selected by individual users, they can be imported on a quarter-section by quarter-section basis.

Before You Start

You will need to have a few things in place before you start.

  • Setup an OSM import account - You may already have an OSM account, however, it's recommended you create an account specific for importing as a way of reverting any changes in case something goes wrong. Usually, it's your existing OSM username followed by _imports (e.g. geografa_imports).
  • Download and install the latest JOSM - JOSM is a Java based application made specifically for editing and importing OSM data. For more info, read the docs on using JOSM.
  • Link your OSM account in JOSM - In order to upload data to the OSM servers, you'll need to link your account in JOSM. You can do that by Going to JOSM > Preferences > Connection Settings. Select "Use OAuth" and press "New Access Token."

authentication2

Downloading an OSM file

To select a file, go to the list of currently available OSM files and download the file using your Terminal application and the cURL command. You can't simply download and load the data and load it into JOSM since you may get an error. Instead, download the raw contents of a file hosted on GitHub using cURL.

Example:

curl -O "https://raw.githubusercontent.com/pdxosgeo/pdxbldgimport/master/data_to_import/1n3w25c.osm"

When you've selected the file you wish to import, update the Import Tasks list to indicate which quarter section file you are working on with your name and the status. For example:

  • 1n3w33d in progress (Tanya)
  • 1n1e22d complete (Rafa) #32642126

If you've completed a task, add the changeset number. More about this later.

###Importing to JOSM

  • Open JOSM and load your .osm file into JOSM. If you see an accompanying multi-address file, import that as well since you will be adding that to your buildings later. loadosm

  • Validate the .osm file. Validation checks for errors and you can highlight individual errors and correct them as needed. Common errors may be overlapping buildings or buildings with addresses but no street names.

validation

Note: If you don't see the validation panel select Windows > Validation Results

  • Download .osm data. Download the existing OpenStreetMap data into the area of interest (in this case, your quarter section). By default, it should load into a separate layer. Fix any errors/warnings.

download osm

  • Fix multipolygon errors. Make sure any multipolygons are genuinely multipolygons with holes, and not single, multi-part buildings.

  • Merge your buildings .osm file. Merging can be done one of two ways. You can merge just selections with the existing OSM data, or merge all the buildings into the OSM data layer. The former is easier when no buildings exist in the area. When buildings already exist, such as in the inner part of downtown Portland, it's more common to encounter overlap errors and will take longer to validate.

merge

  • Fix street addresses. Ensure you have the FixAddresses JOSM plugin installed and then run Tools > Fix Street Addresses to flag any buildings where the addr:street tag does not match the name of the existing street in OSM.

  • Merge multiaddress file. If you have an accompanying multiaddress .osm file, you will want to import that last and validate that addresses are within the building polygon.

  • Re-run validate. Make sure there are no conflicts with existing data.

  • Upload from the merged layer. When you are certain all errors are fixed, upload the merged data layer to OpenStreetMap.

  • Add comments to your changeset. When you commit the changeset, please add a changeset comment something like:

"Consolidated quarter section import (1n2w27a), part of Portland OR Building Import project"

And in the source field add:

Portland Metro (http://wiki.openstreetmap.org/wiki/Portland,_OR_Bldg_import#Source_data)

  • Rerun Tools > Fix Street Addresses - Many times you'll need to make an additional pass at fixing street addresses after uploading your quarter section.

When you are finished

When the changeset is complete, please edit the the Import Tasks list to reflect the completed status and include a link to the changeset.

It is from here out assumed that building .osm files include addresses. If there is no multi_address file, then it was empty and not included here.

Congratulations! You've made a building import! If you have any questions before, during, or after your import, tweet to @geografa or @nixzusehen for assistance.

Add a custom footer
Add a custom sidebar
Clone this wiki locally