WOLFRAM

Wolfram Language & System Documentation Center
Wolfram Language Home Page »

TravelDistanceList

✖
TravelDistanceList[{loc1,loc2,…,locn}]

returns the list {TravelDistance[loc1,loc2],…,TravelDistance[locn-1,locn]}.

Details and Options

  • The locations loci in TravelDistanceList[{loc1,…,locn}] can be given as pairs {lat,lon} in degrees, GeoPosition objects, geographic Entity objects, or any other specification of a location.
  • The result is returned as a QuantityArray object with length units.
  • If the input list of locations has length n, the resulting list of distances has length n-1.

Examples

open allclose all

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

List of consecutive driving distances between cities:

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

Convert the QuantityArray object to its normal form:

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

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

Input can be given as a list of GeoPosition objects:

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

It is possible to mix different location specifications:

In[1]:=1
✖
https://wolfram.com/xid/0bh070j1wqu8hm-6035s2
Out[1]=1

Options  (2)Common values & functionality for each option

TravelMethod  (1)

The distances returned correspond to routes that are optimal for a certain method of transportation. TravelDistanceList uses "Driving" as the default:

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

UnitSystem  (1)

The default unit of the result is determined by the value of $UnitSystem:

In[1]:=1
✖
https://wolfram.com/xid/0bh070j1wqu8hm-wax9nb
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0bh070j1wqu8hm-onpb73
Out[2]=2

Change to a different system:

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

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

TravelDistanceList is basically equivalent to (though much faster than) a combination of Subsequences and TravelDistance:

In[1]:=1
✖
https://wolfram.com/xid/0bh070j1wqu8hm-scrboi
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0bh070j1wqu8hm-5o9qzq
Out[2]=2
In[3]:=3
✖
https://wolfram.com/xid/0bh070j1wqu8hm-5do1u3
Out[3]=3

The sum of the distances returned by TravelDistanceList is equivalent to the total distance returned by TravelDistance:

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

TravelDistanceList reports distance by road. GeoDistanceList reports geodesic distance:

In[1]:=1
✖
https://wolfram.com/xid/0bh070j1wqu8hm-1d6cqu
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0bh070j1wqu8hm-b3vjbf
Out[2]=2

TravelDistanceList[{loc}] returns an empty list:

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

TravelDistanceList[{}] is not defined:

In[2]:=2
✖
https://wolfram.com/xid/0bh070j1wqu8hm-y94nsv
Out[2]=2
Wolfram Research (2016), TravelDistanceList, Wolfram Language function, https://reference.wolfram.com/language/ref/TravelDistanceList.html.
✖
Wolfram Research (2016), TravelDistanceList, Wolfram Language function, https://reference.wolfram.com/language/ref/TravelDistanceList.html.

Text

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

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

CMS

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

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

APA

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

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

BibTeX

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

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

BibLaTeX

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

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