Open Directions Service Developer's Guide

• json
• xml

• json
• xml

• m - Miles
• k - Kilometers

• fastest - Quickest drive time route.
• shortest - Shortest driving distance route.
• pedestrian - Walking route; Avoids limited access roads; Ignores turn restrictions.
• multimodal - Combination of walking and (if available) Public Transit.
• bicycle - Bike route; Avoids limited access roads; Avoids roads where bicycle access is false; Favors bike specific paths and lower maxspeed roads.

• none - No narrative is generated
• text - Standard text narrative
• html - Adds some HTML tags to the standard text
• microformat - Uses HTML span tags with class attributes to allow parts of the narrative to be easily styled via CSS. Read more.

• false - No intersection counts or previous intersection advice will be displayed.
• true - Intersection counts and previous intersection advice can be displayed when available.

• Limited Access - Highways
• Toll Road
• Ferry
• Unpaved
• Seasonal Closure - Approximate. Seasonal roads may not be selected with 100% accuracy.
• Country Crossing

• true - State boundary crossings will be displayed in narrative.
• false - State boundary crossings will not be displayed in narrative.

• true - the "End at" destination maneuver is displayed in narrative.
• false - the "End at" destination maneuver is not displayed in narrative.

• raw - shape is represented as float pairs.
• cmp - shape is represented as a compressed path string with 5 digits of precision.
• cmp6 - Same as for cmp, but uses 6 digits of precision.

• DEFAULT_STRATEGY - No road grade strategy will be used.
• AVOID_UP_HILL - Avoid up hill road grades.
• AVOID_DOWN_HILL - Avoid down hill road grades.
• AVOID_ALL_HILLS - Avoid all hill road grades.
• FAVOR_UP_HILL - Favor up hill road grades.
• FAVOR_DOWN_HILL - Favor down hill road grades.
• FAVOR_ALL_HILLS - Favor all hill road grades.

• 1 or cautious - Assume a cautious driving style.
• 2 or normal - Assume a normal driving style. This is the default.
• 3 or aggressive - Assume an aggressive driving style.

• width (pixels)
• height (pixels)
• center (lat/lng of map center)
• scale (map scale)

• mapWidth
• mapHeight
• mapScale or mapZoom - The scale factor of the map. If mapZoom is provided, it will override the value of mapScale as follows: 1 = 88011773, 2 = 29337258, 3 = 9779086, 4 = 3520471, 5 = 1504475, 6 = 701289, 7 = 324767, 8 = 154950, 9 = 74999, 10 = 36000, 11 = 18000, 12 = 9000, 13 = 4700, 14 = 2500, 15 = 1500, 16 = 1000
• mapLat
• mapLng

• Previous Intersection = 1
• Place holders for future notes = 2 - 4
• Timed Restrictions = 5

• Timed Restrictions = 1

• Previous Intersection = 24
• Timed Restrictions = 10 - 14

• none = 0
• north = 1
• northwest = 2
• northeast = 3
• south = 4
• southeast= 5
• southwest = 6
• west = 7
• east = 8

• none = 0
• portions toll = 1
• portions unpaved = 2
• possible seasonal road closure = 4
• gate = 8
• ferry = 16
• avoid id= 32
• country crossing = 64
• limited access (highways) = 128

• straight = 0
• slight right = 1
• right = 2
• sharp right = 3
• reverse = 4
• sharp left = 5
• left = 6
• slight left = 7
• right u-turn = 8
• left u-turn =9
• right merge =10
• left merge = 11
• right on ramp = 12
• left on ramp = 13
• right off ramp = 14
• left off ramp = 15
• right fork = 16
• left form = 17
• straight fork = 18

• raw - shape is represented as float pairs
• cmp - shape is represented as a compressed path string; See - http://soulsolutions.com.au/Default.aspx?tabid=96 for a detailed description of the compressed format
• none - No shape will be returned. In this case, the generalize parameter will be ignored

• legIndex - An array of the starting index of each leg, and
• maneuverIndex - An array of the starting index for each maneuver.

• fastest - Quickest drive time route.
• shortest - Shortest driving distance route.
• pedestrian - Walking route; Avoids limited access roads; Ignores turn restrictions. Note: There is a distance limit (approximately 200 miles / 320 kilometers) for pedestrian routing. Requests to find a pedestrian route beyond the maximum distance will result in an error.
• multimodal - Combination of walking and (if available) Public Transit. Note: You must supply time information, because multimodal routes are implicitly time-sensitive.
• bicycle - Bike route; Avoids limited access roads; Avoids roads where bicycle access is false; Favors bike specific paths and lower maxspeed roads.

...                
locationSequence: [
   0,2,1,3
],
locations:[
{
   latLng: {
    	lng: -0.129892,
    	lat: 51.52441
	}, 
	latLng: {
    	lng: -0.149547,
    	lat: 51.520618
	},  
    latLng: {
    	lng: -0.165188,
    	lat: 51.544959
	},  
    latLng: {
    	lng: -0.201705,
    	lat: 51.528506
	}
]
...

...
<locationSequence>
   0,2,1,3
</locationSequence>
<locations>
   <location>
     <latLng>
	   <lat>51.52441</lat> 
	   <lng>-0.129892</lng>
	 </latLng> 
   </location> 
      <location>
     <latLng>
	   <lat>51.520618</lat> 
	   <lng>-0.149547</lng>
	 </latLng> 
   </location> 
      <location>
     <latLng>
	   <lat>51.544959</lat> 
	   <lng>-0.165188</lng>
	 </latLng> 
   </location> 
      <location>
     <latLng>
	   <lat>51.528506</lat> 
	   <lng>-0.201705</lng>
	 </latLng> 
   </location> 
</locations>
...