To build a link that displays directions from a specific start and end point, use the base address http://maps.live.com/default.aspx and any of the following parameters.
| Parameter |
Definition |
Example |
Details |
| rtp |
Route |
Rtp=adr.
Seattle,WA
~adr.1Microsoft Way,
Redmond, WA |
Defines the start and end of a route to draw on the map, each separated by a tilde (~). Each of the waypoints (Coordinates that identify a point on the map.) are defined by either a pos (position) or adr (address) identifier, described below.
A complete route contains at least two waypoints. For example, a route with two waypoints is defined by the following:
rtp="A"~"B"
You can also specify an incomplete route. For example, you can define only the start of a route:
rtp="A"~
or the end of a route:
rtp=~"B"
If you provide only one waypoint, the driving directions panel is displayed with the provided waypoint, but no route is drawn.
|
| Identifier |
Definition |
Example |
Details |
| pos |
Position |
Rtp=
pos.42.2_
-122.3~
pos.55.2_-127. |
Defines a waypoint as a specific position on the map. Use the following format:
rtp=pos.latitude_longitude_name
|
| adr |
Address |
Rtp=
adr.Seattle,
WA~adr.1 Microsoft Way,
Redmond, WA |
Defines a waypoint as an address. Use the following format:
rtp=adr.address
|
| rtop |
Route options |
Rtop=0~0~E |
Defines options for the route. There are three possible options, each separated by ~. The default value of non-abbreviated route, quickest without traffic will be used if not specified.
- 0 = Quickest
- 1 = Shortest
- 0 = Don't use traffic
- 1 = Use traffic
- 0 = No abbreviation
- E = End only
- S = Start Only
|
Note
The pos and adr identifiers must be used with the rtp parameter
To create directions for a party and let others view those directions in the One Click Directions map view, start with the following base address http://maps.live.com/OnceClickDirections.aspx.
You can use any of the parameters listed in the above tables to specify your waypoints.
The destination is specified using the rtp and pos parameters described above. Make that sure you specify only the end location, for example rtp=~pos.45.21_-123.2. The following parameters can be used to specify the default view index that you want displayed:
| Parameter |
Definition |
Example |
Details |
| rtv |
View index |
rtv=4 |
This is an optional parameter that specifies the start view for a route. Use the following format:
rtv=1
- 0 = Show all (default)
- 1 = Start from the first direction
- 2 = Start from the second direction
- 3 = Start from the third direction
- 4 = Start from the fourth direction
|
Examples
The following example displays a route on the map from a specific address to a specific point:
http://maps.live.com/default.aspx?v=2&rtp=adr.One%20Microsoft Way,%20Redmond,%20WA%2098052~pos.45.23423_-122.1232_MyPlace
The following example opens the driving directions panel with a start address only:
http://maps.live.com/default.aspx?v=2&rtp=adr.Seattle,%20WA
The following example opens driving directions to Papa John's Pizza in Redmond, WA:
http://maps.live.com/default.aspx?v=2&rtp=~pos.rycz2z4tpkxm_16110 NE 87th St,
Redmond, WA_Papa John_425-283-6478