GeoDistanceList

GeoDistanceList[{loc1,loc2,,locn}]

returns the list of geodesic distances between consecutive pairs of locations.

Details and Options

  • The locations loci in GeoDistanceList[{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 dimensions of length. The unit used can be chosen with the option UnitSystem, which has $UnitSystem as its default value.
  • If the input list of locations has length n, the resulting list of distances has length n-1.
  • GeoDistanceList has option DistanceFunction, with the following settings:
  • "Boundary"minimum distance between any points in regions
    "Center"distance between centers of regions
    "SignedBoundary"distance to boundary, negative for interior points
  • GeoDistanceList by default uses the setting DistanceFunction->"Center". This is a different default from the one for GeoDistance.

Examples

open allclose all

Basic Examples  (1)

List of consecutive geodesic distances between cities:

Convert the QuantityArray object to its normal form:

Draw the three geodesic segments on a map:

Scope  (3)

Specify locations as pairs {lat,lon} in degrees:

Latitude and longitude can also be given as DMS strings:

Or as Quantity angles:

Use GeoPosition objects:

Use other forms of geodetic position:

Use Entity objects:

Options  (2)

DistanceFunction  (1)

For extended entities, the distances are computed between center points by default:

Compute the minimum distance between respective boundaries:

UnitSystem  (1)

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

Change to a different system:

Properties & Relations  (3)

GeoDistanceList is basically equivalent to a combination of Subsequences and GeoDistance:

GeoDistanceList reports geodesic distance. TravelDistanceList reports distance by road:

GeoDistanceList[{loc}] returns an empty list:

GeoDistanceList[{}] is not defined:

Possible Issues  (1)

The default value of the option DistanceFunction is "Boundary" for GeoDistance, but "Center" for GeoDistanceList:

The default choice "Center" computes distances between centers:

The choice "Boundary" gives zero distance for neighboring countries:

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

Text

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

BibTeX

@misc{reference.wolfram_2021_geodistancelist, author="Wolfram Research", title="{GeoDistanceList}", year="2016", howpublished="\url{https://reference.wolfram.com/language/ref/GeoDistanceList.html}", note=[Accessed: 26-September-2021 ]}

BibLaTeX

@online{reference.wolfram_2021_geodistancelist, organization={Wolfram Research}, title={GeoDistanceList}, year={2016}, url={https://reference.wolfram.com/language/ref/GeoDistanceList.html}, note=[Accessed: 26-September-2021 ]}

CMS

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

APA

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