A python utility for getting commute time data.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Traffic Monitor

WARNING: Google changed their maps so that they doesn't render without js anymore, so this is broken. THe visualization component here http://turtlemonvh.github.io/traffic-monitor/ (source) still works fine, though.

A simple python application for getting traffic data from Google Maps to do some simple commute time by time of day anaysis.

I couldn't find any nice graphs on commute time by time of day (* see notes below) - the knowledge about the best time of day to come and go seems to be passed from person to person based on experience. Why not get some data?


Just Python 2.7 is required for the python script.

There is also an executable for 64 bit Windows. To use this, download the zip folder from the "Releases" section. Unzip the folder and edit the configuration file to suit your needs. Run the route_test.exe executable within the downloaded folder.


There should be a routes.cfg file in the directory where the utility is run. It should look something like this:

# List routes as urls
# names used here will be included on lines of csv output file
route_a: https://maps.google.com/maps?saddr=Atlanta,+GA&daddr=Nashville,+TN&hl=en

# daysofweek = wd for weekdays, we for weekends, ad for all days
daysofweek: wd

# Times are integer military-time hours in your time zone
morningstart: 5
morningend: 10
eveningstart: 15
eveningend: 20

In the list of routes, adding -morning or -evening at the end of a route name will cause it to be calculated only for evening or morning periods. This option should be used most of the time to specific the direction for coming and going. An example "Routes" section for a commuter going between Atlanta and Nashville would look look like:

route_a-morning: https://maps.google.com/maps?saddr=Atlanta,+GA&daddr=Nashville,+TN&hl=en
route_a-evening: https://maps.google.com/maps?saddr=Nashville,+TN&daddr=Atlanta,+GA&hl=en

If neither -morning nor -evening is included in a route name, the route is run for both times of day. This may be useful for general analysis of traffic patterns.


Create the configuration file and set this up to run every few minutes with cron, Windows Task Scheduler, or a similar utility. I suggest limiting yourself to something less frequent than every 10 minutes because the extra data isn't that useful and it's more likely to get you noticed by Google. We're screen scraping here, so lets be considerate.

For Windows Task Scheduler, make sure you run the command with a user account that has "Log on as a batch job" permissions (any admin account will do) or you will see the 2147943785 error code in your scheduled job.

An output file named route_times.csv will be placed in the directory where this is run. It will look something like the following:


The contents of the columns in each line are as follows:

  1. The name of the route defined in your config file.
  2. The date the route was calculated.
  3. The day of the week, where Monday is 0 and Sunday is 6.
  4. The time of day that the route was calculated.
  5. The estimated time to complete the route in minutes.

After a few weeks of running this script you should be able to load your data into Excel or a similar application and do some analysis to determine the best time of day to come and go from the office. If you find anything interesting from doing this, send me an email. I'd like to hear about it.


  • I was just made aware of the fact that you can access Google's past traffic density data through Google Maps directly, and this feature has actually been around for a while. Still, as far as I know you can't get actual commute time estimates out of this, just colored lines indicating traffic density. If you want to plan your route, use the Google Maps feature. If you want some time estimates to look at, this script may still be useful to you.

  • To visualize the output of this tool with a series of plots that allow you to filter on multiple data dimensions simulteneously, see the github pages website for this project.

  • You can find historical data for commute times on Atlanta's southbound connector and northbound connector in the sample_data directory of this repository.