We were so impressed by the work that @tkompare did on his Chicago Flu Shots web application for the 2013 flu season, that we decided to fork and improve upon it for the 2014 season. Our version has one big change - instead of being based on Google Fusion Tables, it's instead powered by a Socrata Open Data API.
About the Flu Shot Finder
Given data about the location and hours of flu shot providers in your area, this application will help you locate the nearest place you can get the flu vaccine. It will even use geolocation in your browser to help find the nearest provider to your current location.
- Fork the repo on Github so that you have your own copy to work with.
- Locate data about the location of flu shot providers in your area. Hopefully, your local or state government has already provided this data, but if not, you can learn more about data hosting below.
- If your data is already compliant with the schema below, you'll be able to use the app mostly without modifications. However, you'll still need to modify a few things:
- You'll need to change
js/main.js:91to the API Endpoint for your dataset.
- Modify the branding in the
index.htmlto reflect your own instance of the app.
- Replace the Google Maps API key in
index.htmlwith your own key.
- Update the city in
- If your data isn't compliant with the schema below, you can remap your data schema in
Flu Shots deployment using OpenShift
OpenShift is a platform-as-a-service (PaaS) that lets you quickly and easily deploy Django/Python apps to a production hosting environment. The OpenShift software is open source so you can either run it on servers that you own or rent, or you can use Redhat's hosted OpenShift service at http://openshift.redhat.com
Step 1: Sign Up for an Account
Go to here and sign up for an account. You only need to signup for a free account. Skip if you has already had an account there.
Step 2: Setup Your Publish Key
You will need a public key for connection between you and OpenShift later. A public key is a plain text file usually name id_rsa.pub that's located in ~/.ssh/.
So if you are on a Mac, it's in /Users/[your_username]/.ssh/id_rsa.pub or if you are on Linux it's in /home/[your_user_name]/.ssh/id_rsa.pub. You need to copy content of this file and update it with OpenShift so OpenShift is aware of your public key. When you make a connection to OpenShift from the terminal (that is, when you SSH to your box and are pushing code), OpenShift will identify and authorize you by based on your public/private key.
If you are not familiar with the public key concept, this tutorial will give you a solid background for it.
Step 3: Setup Your Application
- Add an Application from https://openshift.redhat.com/app/console/applications
- Choose a type of application: PHP 5+ Cartridge
- Configure the application by adding a public url, url to your git respository and selecting a nearby region.
Step 4: Your application has been created.
- Following the instructions for making code changes
- Continue to the application overview page for additional settings
facility_name- The name of the facility providing the vaccinations
begin_date- The begin date for a timeframe for when the facility will be open for vaccinations. (M/d/yyyy e.g. "1/4/1982")
begin_time- The start time (example: 9:00:00) for when the facility will be open for vaccinations. (hh:mm:ss e.g. "12:00:00")
contact- A contact name listed for the facility
cost- Vaccination costs. For example, "No cost to individual. If insured, insurance will be billed."
end_date- The end date for a timeframe for when the facility will be open for vaccinations. (M/d/yyyy e.g. "1/4/1982")
end_time- The end time for when the facility will be open for vaccinations. (hh:mm:ss e.g. "12:00:00")
hours- List the hours for when the facility will be open. For example, Mon-Fri: 9:00 AM-9:00 PM, Sat: 9:00 AM-5:00 PM"
id- Assign an unique numeric value for each row
latitude- The latitude value for the location of the facility
longitude- The longitude value for the location of the facility
notes- Additional notes. For example, "Free to individual. Insurance will be billed. Closed 2nd Wed every month 12 to 4 PM"
phone- The phone number for the facility providing the vaccinations
recurrence_days- The days of the week the facility is open between the begin_date and end_date. A comma-separated list is required. For example, "Sunday, Monday, Tuesday, Wednesday, Thursday"
url- An unique url assocated with the vaccinations for a specific location
street1- Primary street address of the facility. For example, "7811 S Rachine Ave"
street2- Secondary street address of the facility. For example, "2nd Floor"
city- The city where the facility is located
state- The state where the facility is located
postal_code- The zip code where the facility is located
If vaccine provider data is not provided by your local government on Socrata, do not despair! There are other options available as well.
- If you're a local community group, free hosting is available via the Socrata Community Data Platform. Your organization can sign up and be granted an account that'll allow you to upload your data to Socrata and self-host your own API.
- If you're a Code for America Brigade, you can also sign up for free hosting on the Brigade Open Data Sharing Platform.
We warmly welcome pull requests, so if there are modifications or improvements you'd like to make, feel free to fork this repo and send them our way! Please note that we may modify your pull requests to make sure they work properly with the main fork of the app.