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:

Introduced in 2016
 (10.4)