/PDXAPI

JSON API for CivicApps.org datasets for Portland, OR

Primary LanguageRuby

PDX API

JSONP API for Portland, OR civic data

About

PDXAPI is a GeoCouch instance populated with data from the City of Portland, Oregon through CivicApps. Out of the box CouchDB provides a RESTy JSON API to all of the data.

Project Goals

  • Create an easily consumable data resource for developers interested in utilizing Portland civic data
  • Modify and build upon the city’s publicly released data by allowing users to edit and contribute data, and even start whole new datasets
  • Create automated processes for synchronizing with the original data sources (City of Portland, Metro, TriMet)
  • Create tools and examples for developers to use as a jumping off point for creating ‘civic apps’
  • Wiki-style revision history and conflict management/dispute resolution when users contribute to datasets

Developers

See pdxapi.com for more information and example usage.

The basic usage is to ask PDXAPI for all objects in a database contained within a particular bounding box. You can see an example of this on the PDXAPI.com homepage. You will receive a GeoJSON feature collection that contains any matching objects. Each object consists of some location data and an ID that you can use to look up metadata for the object by asking http://pdxapi.com/dataset/id

If you are interested in working with a local instance of PDXAPI, the included pdxapi_installer file demonstrates how to convert download Shapefiles from CivicApps and load them into GeoCouch. The old_scripts directory contains a bunch of geospatial related utilities developed for PDXAPI that are no longer in use, but may be useful as a reference.

Related Projects

  • shp2geocouch is a rubygem that converts Shapefiles into GeoCouch databases.
  • Food Cart Pages is an example web application that uses PDXAPI as it’s data store.
  • Food Cart Finder Mobile is an example mobile application (native iPhone and Android) that uses PDXAPI as it’s data store.

License

(The MIT License)

Copyright © 2010 Max Ogden

Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
‘Software’), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED ‘AS IS’, WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.