Work the Shell - Generating Turn-by-Turn Driving Directions

Maps? We don't need no stinking maps. With bash and a few command-line utilities, we can extract the textual driving instructions from an on-line map source and dispense with all those pesky GUI maps.

I'm happy to report that this month, I'm answering a reader's question about how to script something. Dunno what's up with the rest of you readers, but apparently writing to me with your weird and challenging shell-scripting puzzles isn't making the short list right now. Reader Paul M. asks:

Is there a way to screen-scrape Google Maps direction results? I'm after the text (turn left at Ho-ho-kus Blvd), not the maps. When I look at a saved results page, all I can see is CSS and JavaScript code. If I do a manual copy and paste of the directions, however, the turn-by-turn directions appear. Got any suggestions on how to grab turn-by-turn driving directions automatically, Dave?

Ah, those tricky programmers over at Google Maps make this pretty darn difficult! Poke around at the source pages generated by looking for directions, and it's clear that they're using a method=post or other advanced way to hide the starting and ending points from the URL itself, along with some very fancy coding to make the Web pages highly interactive. So to heck with it!

After much digging around and looking at how the different mapping sites work, I settled on as the best place to get driving directions so that we'll be able to specify start and stop points via URL and also understand the output. To get started, check out Expedia's interactive driving directions in your Web browser at

On Expedia, enter a starting and ending address for directions, and you'll find that it's all stored in a scary-complex URL like this: (Eagle-eyed readers will notice that I'm offering the Obama family driving directions to Disney World.)

You can strip some of the superfluous information out of the URL and create a simple command-line call to get the map and directions:


curl --silent "$start&

You can see that Expedia wants an address unwrapped and split by street address, city, state and zip code (though if it can figure out the location, it appears you can skip the zip code, as shown in start above).

Now that we have that, let's use sed to extract just the table of results, without the other superfluous information. This is done by manual analysis of the source file and noting that it's all in a table that starts with this HTML line:


Not surprisingly, the line we seek that denotes the end of the table is </TABLE>. Here's the code that lets you slice things as desired:

sed -n '/BORDERCOLOR=#E4E4E4/,/<\/TABLE>/p'

Put them all together and save the output to a temp file. After that, the next challenge is to turn that HTML table into something you actually can read.

To do that, we're going to turn to a great open-source utility called Lynx. You might already have Lynx on your system, but if you don't, grab a copy of the Lynx text-based Web browser from We'll use that to interpret and convert the HTML markup to raw text.

Fortunately, Lynx excels at this kind of challenge, as demonstrated by the working code:

curl --silent "$start&
 ↪$dest&qscr=mrdr&rtyp=0&unit=0"| \
   sed -n '/BORDERCOLOR=#E4E4E4/,/<\/TABLE>/p' | \
   lynx -dump -stdin

Yup, that's it. Specify a correct start and destination, make sure that the script knows where to find Lynx on your system, and the output will look like this:

Directions Distance Time
Start: Depart Start on Local road(s) (East) 0.1 < 1min
    1: Turn RIGHT (South) onto E Executive Ave NW 0.1 0:01
    2: Turn LEFT (East) onto Alexander Hamilton Pl NW, then
       immediately turn RIGHT (South) onto 15th St NW 0.1 0:01
    3: Turn LEFT (East) onto Pennsylvania Ave NW, then immediately
       turn RIGHT (South) onto 14th St NW 0.3 0:02
    4: Keep STRAIGHT onto US-1 [14th St NW] 1.1 0:02
   22: Take Ramp (LEFT) onto Western Way (Disney World) 1.9 0:02
   23: Turn LEFT (North) onto Bear Island Rd 2.1 0:03
   24: Turn RIGHT (East) onto Floridian Way 0.3 0:01
   25: Keep STRAIGHT onto World Dr 0.4 0:01
  End: Arrive End < 0.1 < 1min
Total Route 881 mi 13 hrs  2 mins

I'll leave it as an exercise to you, dear reader, to create a wrapper that prompts people for starting and ending addresses and then uses the curl invocation to Expedia and subsequent invocation of Lynx to display turn-by-turn driving directions.

Dave Taylor has been hacking shell scripts for a really long time, 30 years. He's the author of the popular Wicked Cool Shell Scripts and can be found on Twitter as @DaveTaylor and more generally at


Dave Taylor has been hacking shell scripts for over thirty years. Really. He's the author of the popular "Wicked Cool Shell Scripts" and can be found on Twitter as @DaveTaylor and more generally at


Comment viewing options

Select your preferred way to display the comments and click "Save settings" to activate your changes.

Expedia has changed to use

Anonymous's picture

Expedia has changed to use POST method '-d' option with curl. You'd have to test if the same fields still work but I suspect they would.

One Click, Universal Protection: Implementing Centralized Security Policies on Linux Systems

As Linux continues to play an ever increasing role in corporate data centers and institutions, ensuring the integrity and protection of these systems must be a priority. With 60% of the world's websites and an increasing share of organization's mission-critical workloads running on Linux, failing to stop malware and other advanced threats on Linux can increasingly impact an organization's reputation and bottom line.

Learn More

Sponsored by Bit9

Linux Backup and Recovery Webinar

Most companies incorporate backup procedures for critical data, which can be restored quickly if a loss occurs. However, fewer companies are prepared for catastrophic system failures, in which they lose all data, the entire operating system, applications, settings, patches and more, reducing their system(s) to “bare metal.” After all, before data can be restored to a system, there must be a system to restore it to.

In this one hour webinar, learn how to enhance your existing backup strategies for better disaster recovery preparedness using Storix System Backup Administrator (SBAdmin), a highly flexible bare-metal recovery solution for UNIX and Linux systems.

Learn More

Sponsored by Storix