Skip to content

Project for #build4stl during National Day of Civic Hacking 2014

Notifications You must be signed in to change notification settings

jrcharney/dive

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Dive: GTFS-based local search

Project for #build4stl during National Day of Civic Hacking 2014

Formerly "GTFS_Search_Near" and "things-near-my-bus-stop"

Why the name change?

Basically, those names were kinda crappy. Underscores are a pain in the butt to use because they are on the alternative characters Swype keyboard and using dashes in hashtags is most uncouth.

Dive was the name I had given this project because one of the first queries we tested this project with was to find bars near a bus route. Since "dive" is another name for a "bar", I though it would be an ambiguous term good enough that one day, when this project caught on with a lot of folks people would say "Dive for [insert search terms here]". In fact, when I re-write this page, I plan to have the search form do more than just look for things along bus routes but also highways.

"Drop the 'The.' Just 'Facebook.' It's cleaner." --Napster founder Sean Parker (played by Justin Timberlake) in The Social Network

What does this thing do?

Given a trip route and desired search subject, this website displays a map of route and subject locations within 500 meters of the stops on the route.

Short answer: Finds places along the bus route you are on.

06/28/2014: We now have access to the "things-near-my-bus-stop-api" project. Consider it merged with this project. We are currently sprucing up the code.

What's used to make this work?

  • JavaScript
    • Node GTFS (Metro St. Louis uses it.)
    • Node.js (Eventually.)
    • Leaflet.js
      • Open Street Maps
    • jQuery
    • Coffee Script (something I also plan to add.)
  • FourSquare OAUTH (though I plan on replacing it with something that won't block you for scraping more than 1000 records.)
    • Notamatim should replace this.
  • MongoDB (which is currently broken on my computer, Thanks, Raspberry Pi.)
    • Since MongoDB is currently broken on my computer (and it takes 16 hours to reinstall on the pokey Raspberry Pi), I've decided to use SQLite as an alternative. It seems to be working well with Ruby on Rails. Why not Python?
  • Python
    • Bottle.py (because Flask wasn't working. That and this was better.)
    • requests
    • wsgiref
  • Heroku (for deployment)

What plans do I have for it?

Just to make me happy, I'd like to add weather information to it. It's no fun standing at a shelterless bus stop when the weather sucks. This information will be scraped from the National Weather Service, because I love those guys!

Foursquare OAUTH will be replaced with Open Street Map's Nominantim.

I might collab with Peter Greiss to add crime data from his Crimedb.org project. (No point of standing at a bus stop in a bad neighborhood. Although, if there is one thing crime stats do not show is that once an incident occurs, it shouldn't happen again...at least in theory.)

There was some websitre I found awhile back that had a list of people and addresses. Though, not to rock the boat over data and privacy, that part of the project might just stay offline.

Depending on my mood, I might rewrite this project in Ruby. I'm learning Python and Node.js, but if I can dabble with Rails as well as Sass, Compass, HAML, etc., that would be cool.

Our Awesome Team

  • Jeremia Kimelman - check out his github
  • LeAnne Lis
  • Vincent Lis
  • Noah Williams
  • Jason Charney (Me!)
  • Marc Braun

Acknowledgements

Special thanks go out to the following people.

  • Johnathan Leek for hosting this event.
  • Bill Schwulst for letting me know about it.
  • Brett Lord-Castillo
  • Elenore (who's last name I need to look up.)
  • My Awesome Team! (see previous section.)
  • Code for America
  • Build for STL
  • T-REX
  • And YOU for reading this page and leraning more about this project.

Copyright and Licensing

Last I checked, this project was under a BSD or MIT software license. I'll need to paste that part later.

This software was developed during an event where we collabbed with non-profits, community organizations, and local government agencies, so it would seem right that it would be free for the public to use.

However, if you do fork this project, as a courtesy to our hard work, please do not omitt the "Our Awesome Team" section of this README document, which you should continue to keep as part of documentation.

All trademarks, logos, and copyrights are property of their respective owners or organizations. (Such acknowlegdements will be included in this section in the near future.)

It is advisable that you probably not use this while driving a vechicle, motorcycle, aircraft, or bicycle, nor should it be used while operating an air traffic control center, nuclear power plant, oil tanker, or Large Hadron Collider.

DON'T TEXT AND DRIVE! That applies for Internet browsing too! Pull over and do that.

All your base are belong to us. :3

About

Project for #build4stl during National Day of Civic Hacking 2014

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 66.5%
  • Python 33.5%