gives the geodesic distance between latitude-longitude positions on the Earth.
gives the distance between locations specified by position objects or geographical entities.
gives the total distance from loc1 to locn through all the intermediate loci.
Details and Options
- GeoDistance[loc1,loc2] gives the distance between locations loc1 and loc2 as measured along the geodesic joining them on the surface of the reference ellipsoid. Heights are ignored.
- The result is returned as a Quantity object with dimensions of length. The unit used can be chosen with the option UnitSystem, which has $UnitSystem as default value.
- Latitudes and longitudes can be given as numbers in degrees, as DMS strings, or as Quantity angles.
- Position objects in GeoDistance[loc1,loc2] can be given as GeoPosition, GeoPositionXYZ, GeoPositionENU, or GeoGridPosition objects.
- In GeoDistance[loc1,loc2], the loci can be Entity objects with domains such as "City", "Country", and "AdministrativeDivision".
- For entities corresponding to extended geographic regions, GeoDistance by default computes the minimum distance between any points in the regions.
- GeoDistance[loc1,loc2] by default uses the reference ellipsoid associated with the datum for loc1.
- GeoDistance automatically threads over lists of locations or GeoPosition arrays, so that GeoDistance[loc,locs] returns a list of distances, and GeoDistance[locs1,locs2] returns a matrix of distances. Results are given as QuantityArray objects.
- GeoDistance and GeoDirection, or their combination in GeoDisplacement, solve the geodetic inverse problem.
- GeoDistance 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
- GeoDistance by default uses the setting DistanceFunction"Boundary".
Examplesopen allclose all
Basic Examples (5)
Or as Quantity objects:
Compute the distance between Entity objects:
Or between an Entity object and a geo position:
Normalize the resulting QuantityArray object:
Height and time information is ignored in GeoDistance computations:
The default unit of the result is determined by the value of $UnitSystem:
Properties & Relations (10)
GeoDistance is a symmetric function:
Compute distances between consecutive pairs in a list of points with GeoDistanceList:
GeoDistance computes distances between points:
GeoLength computes the length of a geo path:
The list of distances can also be obtained with GeoDistanceList: