hackerrdave/citysdk

Through our CitySDK, we are aiming to provide a user-friendly “toolbox” for civic hackers to connect local and national public data. The creation of the SDK came out of the desire to make it easier to use the Census API for common tasks that our developer community asked for. We have been engaging developers around the country for the past two years and have observed how they use the API and have built the most commonly needed functionalities usually put ‘on top’ of our API right into the SDK, saving the developer from having to do it herself.

CitySDK

This readme is a work in progress. For an overview of the project, please visit https://uscensusbureau.github.io/citysdk

Instructions on using the CitySDK and the current modules can be found in the Examples directory.

Generated jsDocs can be found in the docs directory.

Source code can be found in the js directory.

Intro

Through our City SDK, we are aiming to provide a user-friendly "toolbox" for civic hackers to connect local and national public data. The creation of the SDK came out of the desire to make it easier to use the Census API for common tasks that our developer community asked for. We have been engaging developers around the country for the past two years and have observed how they use the API and have built the most commonly needed functionalities built on top of our API right into the SDK, saving the developer from having to do it herself.

Features

• Never have to figure out what your FIPS code is again! Just pass in lat/longs, we handle the translation. Only have ZIP codes? No problem, we translate those too.
• Get values (currently American Community Survey (ACS) 5-yr 2013 only) and Census geographic boundaries (currently GeoJSON only: down to ‘block-group’ level) with a SINGLE CALL (whoohoo)!
• A modular architecture which makes mashing Census data up with third-party data a snap.
• Pull down Census Bureau geographic boundaries by sending your own custom geography in the request (currently GeoJSON support only, Terraformer.io)
• A showcase of examples to help you get started.
• We’ve provided a starting list of aliases for some of our most popular variables (currently ACS 5-yr 2013 only)
• More coming soon! (you may also add to our issues using the #user stories label to make feature requests)