sosolimited/dudleyd3

D3 Dashboard for testing 311 data for Crisscross Signal Spire in Dudley Square

DudleyD3

Copyright Sosolimited 2014.

Overview

This is a web-based dashboard to explore data from the BOS:311 app. The app uses D3 (version 3) to visualize incoming 311 data in multiple charts and form-factors.

This dashboard was used during the research phase of Crisscross Signal Spire.

Software Setup

To clone this repository locally, type the following into terminal:

git clone https://github.com/sosolimited/DudleyD3.git

All dependencies are included in the repository.

To run the software locally, navigate to the directory containing index.html and launch a simple python server:

cd DudleyD3
python -m SimpleHTTPServer 8001

The page will now be available at http://localhost:8001 in the web browser.

DEV Notes

• About the BOS:311 API:

  • Specs : http://wiki.open311.org/GeoReport_v2
  • Other docs : General notes about data relating to City of Boston (311, MBTA tracker, etc., Notes about BOS:311 app, including example reports
  • GET requests URL : https://mayors24.cityofboston.gov/open311/v2/requests.json?page=1&page_size=250
  • The max number of returned results per page seems to be 250 (doesn't matter if you ask for more with the 'page_size' parameter)

  Example Charts

  Here are some examples of charts included in the app:

  A chart showing 311 reports, mapped by longitude and latitude. Colors indicate the type of report:

  

  Numbers of 311 events throughout the day. Requests are colored by event status (new 311 report or closed / resolved 311 report):

  

  A pie chart showing 311 report breakdown by category: