Stillwater, OK GIS import

From OpenStreetMap Wiki
Jump to: navigation, search

Overview

Please do not attempt to import any features without first consulting the main contacts below.


The goal of this import is to add building and associated address data from publicly available datasets in Stillwater, OK.

The Github repository for all code is here: (in process) as well as issues and project tasks.

The scripts and code for creating the data are intended to generate OSM files that will be validated and imported on a neighborhood by neighborhood bases.

Contacts

Main contributors/organizers of this project:

  1. Mike : User page

How can I help?

We need technical help with validation and script updates as necessary and documentation help.

Technical help

  1. Importing. OpenStreetMap account required (Create one here)

Documentation help

  1. Help update this project page; OpenStreetMap Wiki account required (Create one here)
  2. Write docs about importing
    • Working with the building and address data
    • Setting up and using JOSM
    • Setting up and using OSMLY

Source data

Summary

Data is provided by Stillwater. The datasets:

  1. Building Footprints:
  2. Address points:

The Building Footprints dataset will be referred to as "bldgs". The Address Points dataset will be referred to as "addrs".

License

These datasets are in the Public Domain

Process

The general process for importing data is described below.

Data processing

  1. Import building and address data into PostGIS
  2. Convert address data to OSM format (expanded abbreviations, etc.)
  3. Import existing OSM buildings (building=*) into the database
  4. Any new building footprints which intersect existing buildings will, for now, be ignored
  5. Tags will be created for each building as below


Address Tag Mappings

tag source
addr:housenumber STNO
addr:street (expanded)STDIR + STNAME + (expanded)STTYPE
addr:postcode NEAR_FID
addr:city Stillwater
addr:state OK
addr:country USA

Building Types

The bldgs dataset contains a column representing the use of the building "USAGE". The corresponding building= tag will be set as follows (based on http://wiki.openstreetmap.org/wiki/Key:building):

source value final value
Residential detached
Garage garage
RES, Res residential
Duplex, Apartment Complex, Multiplex, Residential Condominiums apartments
Dormitories dormitory
Everything else (the vast majority) yes

Addresses

Addresses are connected to a building through a Accessors id. bldgs dataset contains a PARC_ACCT field that matched the addrs dataset ACCT field.

Some buildings have multiple addresses associated with them. Where this is the case, the addresses will be assigned to nodes inside the building polygon. No addresses will be assigned to the building, since there is no way to determine which, if any, of them is the "primary" address.

In the case where there are multiple buildings and multiple addresses, with no way to distinguish, then a site boundary will be generated, and nodes will be created inside that polygon, but not on any given building. If for some reason that is not possible, then no addresses will be assigned at that time.

Import Plan

Phase 0: Preparation

  1. Contributors/importers will create separate accounts followed by their normal usernames + "_stillwatergis" for import purposes.
  2. Buildings will be extracted into neighborhoods (of at least 10 buildings each, at most 1400) and converted into .osm format, with three outputs:
    • Only those that DO NOT overlap with existing OSM data and have a single address
    • Only those that overlap with existing OSM data or have multiple addresses (to use in Phase 2)
    • All buildings

Phase 1: The easy stuff

  1. This phase will only deal with buildings that do not overlap with other features in OSM and have one (or no) address, or simple one building on one Accessors id with multiple addresses
  1. Contributors will download a section of buildings, and a section of address nodes and validate it in JOSM, verify them with local knowledge & against the most recent imagery available; likely NAIP imagery with Bing as a fall back.

Please note: satellite imagery can have significant positioning errors versus more accurate surveys.

  1. After validation, the changeset for that section will be uploaded by the contributor with a commit message that indicates it is part of this project
  2. Contributors will adhere to a strict limit of features edited per hour to be determined with consultation of the OSM Imports-us group.

Phase 2: Reconciliation with existing buildings/addresses

This phase will involve conflating data to be added to buildings that already exist in OSM and dealing with any complex addressing issues.

Maintenance Plan

Contributors to this project are (and should be) Stillwater-area community members with an interest in keeping the data up to date.