WOLFRAM

Wolfram Language & System Documentation Center

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

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

Details and Options
Details and Options Details and Options
Examples  
Basic Examples  
Scope  
Options  
TravelMethod  
UnitSystem  
Properties & Relations  
See Also
Related Guides
History
Cite this 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.
  • TravelDistanceList takes the following options:
  • TravelMethod "Driving"method of transportation to assume
    UnitSystem $UnitSystemunit system to be used in output

Examples

open all close all

Basic Examples  (1)

List of consecutive driving distances between cities:

Wolfram Language code: TravelDistanceList[{Entity["City", {"MexicoCity", "DistritoFederal", "Mexico"}], Entity["City", {"NewYork", "NewYork", "UnitedStates"}], Entity["City", {"Chicago", "Illinois", "UnitedStates"}], Entity["City", {"Toronto", "Ontario", "Canada"}]}]

Convert the QuantityArray object to its normal form:

Wolfram Language code: Normal[%]

Scope  (2)

Input can be given as a list of GeoPosition objects:

Wolfram Language code: TravelDistanceList[{GeoPosition[{-12.04, -77.03}], GeoPosition[{-33.46, -70.64}], GeoPosition[{-34.61, -58.37}]}]//Normal

It is possible to mix different location specifications:

Wolfram Language code: TravelDistanceList[{Entity["City", {"Lima", "Lima", "Peru"}], GeoPosition[{-33.46, -70.64}], Entity["City", {"BuenosAires", "BuenosAires", "Argentina"}]}]//Normal

Options  (2)

TravelMethod  (1)

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

Wolfram Language code: Table[{tm, TravelDistanceList[{Entity["City", {"NewYork", "NewYork", "UnitedStates"}], Entity["City", {"Philadelphia", "Pennsylvania", "UnitedStates"}], Entity["City", {"Washington", "DistrictOfColumbia", "UnitedStates"}]}, TravelMethod -> tm]//Normal}, {tm, {"Driving", "Biking", "Walking"}}]//Grid

UnitSystem  (1)

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

Wolfram Language code: $UnitSystem
Wolfram Language code: TravelDistanceList[{Entity["City", {"SanFrancisco", "California", "UnitedStates"}], Entity["City", {"Chicago", "Illinois", "UnitedStates"}], Entity["City", {"NewYork", "NewYork", "UnitedStates"}]}]//Normal

Change to a different system:

Wolfram Language code: TravelDistanceList[{Entity["City", {"SanFrancisco", "California", "UnitedStates"}], Entity["City", {"Chicago", "Illinois", "UnitedStates"}], Entity["City", {"NewYork", "NewYork", "UnitedStates"}]}, UnitSystem -> "Metric"]//Normal

Properties & Relations  (3)

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

Wolfram Language code: locs = {Entity["City", {"SanFrancisco", "California", "UnitedStates"}], Entity["City", {"Chicago", "Illinois", "UnitedStates"}], Entity["City", {"NewYork", "NewYork", "UnitedStates"}]}
Wolfram Language code: TravelDistance@@@Subsequences[locs, {2}]
Wolfram Language code: % == TravelDistanceList[locs]

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

Wolfram Language code: TravelDistance[locs] == Total[TravelDistanceList[locs]]

TravelDistanceList reports distance by road. GeoDistanceList reports geodesic distance:

Wolfram Language code: TravelDistanceList[{Entity["City", {"SanFrancisco", "California", "UnitedStates"}], Entity["City", {"Chicago", "Illinois", "UnitedStates"}], Entity["City", {"NewYork", "NewYork", "UnitedStates"}]}]//Normal
Wolfram Language code: GeoDistanceList[{Entity["City", {"SanFrancisco", "California", "UnitedStates"}], Entity["City", {"Chicago", "Illinois", "UnitedStates"}], Entity["City", {"NewYork", "NewYork", "UnitedStates"}]}]//Normal

TravelDistanceList[{loc}] returns an empty list:

Wolfram Language code: TravelDistanceList[{Here}]

TravelDistanceList[{}] is not defined:

Wolfram Language code: TravelDistanceList[{}]
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.

CMS

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

BibTeX

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

BibLaTeX

@online{reference.wolfram_2026_traveldistancelist, organization={Wolfram Research}, title={TravelDistanceList}, year={2016}, url={https://reference.wolfram.com/language/ref/TravelDistanceList.html}, note=[Accessed: 13-June-2026]}