WOLFRAM

Wolfram Language & System Documentation Center
Wolfram Language Home Page »

TravelDirections
✖
TravelDirections

✖
TravelDirections[{loc1,loc2,…}]

generates directions for travel from loc1 to loc2, ….

✖
TravelDirections[{loc1,loc2,…},"prop"]

gives the property prop of travel directions.

Details and Options

  • The locations loci can be geographic entities, GeoPosition objects, or strings specifying addresses.
  • Possible options include:
  • TravelMethod "Driving"method of transportation to assume
    UnitSystem $UnitSystemunit system to be used in output
  • TravelDirections returns a TravelDirectionsData object, which behaves as a path specification inside GeoGraphics.
  • Possible properties prop to request include:
  • "Dataset"Dataset with maneuvers and other data
    "TravelPath"travel path as a GeoPath primitive
    "ManeuverGrid"grid of maneuvers
    "TravelDistance"total distance to travel
    "TravelTime"total time for travel
  • TravelDirections attempts to find the fastest path between the loci, not taking traffic into account.

Examples

open allclose all

Basic Examples  (2)Summary of the most common use cases

Find directions from New York City to Miami:

In[1]:=1
✖
https://wolfram.com/xid/0n4lsu3e26b-3c7ryq
Out[1]=1

Show the path as a thick red line:

In[2]:=2
✖
https://wolfram.com/xid/0n4lsu3e26b-4soszf
Out[2]=2

Get instructions as a dataset:

In[3]:=3
✖
https://wolfram.com/xid/0n4lsu3e26b-mp4xo8
Out[3]=3

Specify a method of transportation, in this case driving by car:

In[1]:=1
✖
https://wolfram.com/xid/0n4lsu3e26b-yq90ao
Out[1]=1

Get an estimate of the total travel time:

In[2]:=2
✖
https://wolfram.com/xid/0n4lsu3e26b-gs2rdx
Out[2]=2

Scope  (5)Survey of the scope of standard use cases

Compute travel instructions between two geographic location entities:

In[1]:=1
✖
https://wolfram.com/xid/0n4lsu3e26b-smif6p
Out[1]=1

Extract a property value:

In[2]:=2
✖
https://wolfram.com/xid/0n4lsu3e26b-pjug9y
Out[2]=2

Compute a property value:

In[1]:=1
✖
https://wolfram.com/xid/0n4lsu3e26b-wiqsas
Out[1]=1

Use GeoPosition objects to define locations:

In[1]:=1
✖
https://wolfram.com/xid/0n4lsu3e26b-2fco3u
Out[1]=1

Compute instructions to travel through a list of locations:

In[1]:=1
✖
https://wolfram.com/xid/0n4lsu3e26b-m1hs1e
Out[1]=1

Specify locations as addresses:

In[1]:=1
✖
https://wolfram.com/xid/0n4lsu3e26b-xn5ckf
Out[1]=1

Options  (3)Common values & functionality for each option

TravelMethod  (1)

TravelDirections uses "Driving" as the default method of transportation:

In[1]:=1
✖
https://wolfram.com/xid/0n4lsu3e26b-1rpfjj
Out[1]=1

Use "Walking" instead:

In[2]:=2
✖
https://wolfram.com/xid/0n4lsu3e26b-ecmcm5
Out[2]=2

The respective travel paths are different:

In[3]:=3
✖
https://wolfram.com/xid/0n4lsu3e26b-e898sp
Out[3]=3

UnitSystem  (2)

Specify the unit system of the output quantities:

In[1]:=1
✖
https://wolfram.com/xid/0n4lsu3e26b-2xl3hs
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0n4lsu3e26b-osc949
Out[2]=2

Extract property values in different unit systems:

In[1]:=1
✖
https://wolfram.com/xid/0n4lsu3e26b-uzybrz
Out[1]=1

The default unit system is given by $UnitSystem, usually determined by your location:

In[2]:=2
✖
https://wolfram.com/xid/0n4lsu3e26b-suw82o
Out[2]=2
In[3]:=3
✖
https://wolfram.com/xid/0n4lsu3e26b-gakz3v
Out[3]=3

Applications  (1)Sample problems that can be solved with this function

Take major stops of the Camino de Santiago through northern Spain:

In[1]:=1
✖
https://wolfram.com/xid/0n4lsu3e26b-tuwir

Compute travel directions assuming "Walking" as travel method:

In[2]:=2
✖
https://wolfram.com/xid/0n4lsu3e26b-fu9klr
Out[2]=2

Draw a map, including markers at the intermediate locations:

In[3]:=3
✖
https://wolfram.com/xid/0n4lsu3e26b-cc18oo
Out[3]=3

Estimate the total distance traveled:

In[4]:=4
✖
https://wolfram.com/xid/0n4lsu3e26b-izhw82
Out[4]=4

Estimate the total time spent, not counting any intermediate stops:

In[5]:=5
✖
https://wolfram.com/xid/0n4lsu3e26b-2anhgm
Out[5]=5

Properties & Relations  (2)Properties of the function, and connections to other functions

The estimated travel time can also be computed with TravelTime:

In[1]:=1
✖
https://wolfram.com/xid/0n4lsu3e26b-nhdlik
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0n4lsu3e26b-8qbbp8
Out[2]=2

The estimated travel distance can also be computed with TravelDistance:

In[1]:=1
✖
https://wolfram.com/xid/0n4lsu3e26b-g2mpca
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0n4lsu3e26b-pxzr8q
Out[2]=2

Possible Issues  (1)Common pitfalls and unexpected behavior

Traffic restrictions may force different routes when traveling to the locations in reverse order:

In[1]:=1
✖
https://wolfram.com/xid/0n4lsu3e26b-i1fqgu
In[2]:=2
✖
https://wolfram.com/xid/0n4lsu3e26b-9ny1j9
Out[2]=2
In[3]:=3
✖
https://wolfram.com/xid/0n4lsu3e26b-9niyj6
Out[3]=3
In[4]:=4
✖
https://wolfram.com/xid/0n4lsu3e26b-0wpexv
Out[4]=4

Travel distances are different:

In[5]:=5
✖
https://wolfram.com/xid/0n4lsu3e26b-8uv2ol
Out[5]=5
Wolfram Research (2015), TravelDirections, Wolfram Language function, https://reference.wolfram.com/language/ref/TravelDirections.html.
✖
Wolfram Research (2015), TravelDirections, Wolfram Language function, https://reference.wolfram.com/language/ref/TravelDirections.html.

Text

Wolfram Research (2015), TravelDirections, Wolfram Language function, https://reference.wolfram.com/language/ref/TravelDirections.html.

✖
Wolfram Research (2015), TravelDirections, Wolfram Language function, https://reference.wolfram.com/language/ref/TravelDirections.html.

CMS

Wolfram Language. 2015. "TravelDirections." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/TravelDirections.html.

✖
Wolfram Language. 2015. "TravelDirections." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/TravelDirections.html.

APA

Wolfram Language. (2015). TravelDirections. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/TravelDirections.html

✖
Wolfram Language. (2015). TravelDirections. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/TravelDirections.html

BibTeX

@misc{reference.wolfram_2025_traveldirections, author="Wolfram Research", title="{TravelDirections}", year="2015", howpublished="\url{https://reference.wolfram.com/language/ref/TravelDirections.html}", note=[Accessed: 16-April-2025 ]}

✖
@misc{reference.wolfram_2025_traveldirections, author="Wolfram Research", title="{TravelDirections}", year="2015", howpublished="\url{https://reference.wolfram.com/language/ref/TravelDirections.html}", note=[Accessed: 16-April-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_traveldirections, organization={Wolfram Research}, title={TravelDirections}, year={2015}, url={https://reference.wolfram.com/language/ref/TravelDirections.html}, note=[Accessed: 16-April-2025 ]}

✖
@online{reference.wolfram_2025_traveldirections, organization={Wolfram Research}, title={TravelDirections}, year={2015}, url={https://reference.wolfram.com/language/ref/TravelDirections.html}, note=[Accessed: 16-April-2025 ]}