MapQuest Open Directions API Web Service


The MapQuest Platform: Open Directions API Web Service allows you to use OpenStreetMap (OSM) routing data directly over HTTP without having to go through a language-specific SDK. Requests can be submitted as Key-Value pairs, JSON, XML and more. Responses do not have to match the request-type; mix-and-match to fit your development needs.


Web Service Resources

Open Directions API Developer's Guide

Instructions, code samples, and demos all combined in easy-to-follow, easy-to-use documentation.

Open Forums

Discuss and collaborate with other developers who use the Open Directions API Web Service.



This service is powered completely by free-to-use-by-anyone, open-sourced OSM data. 



Using latitude/longitude pairs, request a multi-point route for up to 50 locations, receive maneuver narratives, road shield images, turn direction images, street names, static maneuver maps, route shapes in raw or compressed lat/lng formats, set options to avoid ferries, highways, toll roads, or even down to avoiding specific links in the road network. Ask for the route as shortest, fastest, pedestrian or bicycle.


Sample Open Directions API route:


NOTE: The Open Directions API does not currently support using single-line addresses.


Optimized Routing

All the power of the routing function, plus we'll re-order the stops for you to provide the most efficient route to get to all your stops. Great for planning out the best way to get round multiple places you need to visit in a single journey.


Terms of Use

The MapQuest Open Directions API Web Service is available for use for free under the following conditions:


  • OpenStreetMap must be given credit for the data – see this section of OSM's legal FAQ for details.

  • Please place “Directions Courtesy of MapQuest ” on your page, or in the copyright area of the map and please link the word “MapQuest” to Below is a code snippet you can use for your site:


<p>Directions Courtesy of <a href="" target="_blank">MapQuest</a> <img src=""></p>


  • If your application will get heavy usage, please let us know by sending us an email at Please include the estimate of your expected usage so that we will be aware and accommodate the extra traffic.

  • If there will be an announcement (for example – a press release or a corporate announcement), please contact MapQuest at to let us know of the good news and any expected jumps in our directions service usage.

  • Usage of these directions are at your own risk.

  • Usage of these directions are governed by paragraph 9, section (a) of the MapQuest Developer Network Terms of Use.


OpenStreetMap data is licensed under the Open Data Commons Open Database License (ODbL).