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.

Modifying

1. Fork the repo on Github so that you have your own copy to work with.
2. 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.
3. 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:
4. You'll need to change sodaUrl in js/main.js:91 to the API Endpoint for your dataset.
5. Modify the branding in the .modal-cdph div in index.html to reflect your own instance of the app.
6. Replace the Google Maps API key in index.html with your own key.
7. Update the city in js/main.js
8. If your data isn't compliant with the schema below, you can remap your data schema in js/main.js

Deploying

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

Data Schema

• 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

Data Hosting

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.

Contributing

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.

Warranty

This is sample code provided by Socrata. No warranties or guaranties of any kind are granted. The code is licensed under the MIT License, so have at it!