gdistm

Get distances in any length unit from mouse clicks on a map

Get distances between mouse clicks on a map or cumulative distances along a path of mouse clicks on a map. Data points are entered by pressing a mouse button or any key on the keyboard except the following:
Carriage return Terminates data entry.
Backspace Deletes previous data point.
z Zooms in, centered on current cursor location.
x Zooms out, centered on current cursor location.

Syntax
distances = gdistm
distances = gdistm(N)
distances = gdistm('rh')
distances = gdistm(DistanceUnit)
PathDistance = gdistm('path')
distances = gdistm('color',ColorSpec)
[distances,lat,lon] = gdistm(...)

Description
distances = gdistm gathers an unlimited number of points until the return key is pressed. Distances between points are returned in meters by default.

distances = gdistm(N) gets N points from the current map axes and returns a vector containing the great circle distance from point to point. The cursor can be positioned using a mouse.

distances = gdistm('rh') specifies a rhumb line track. If 'rh' is not specified, a great circle track is assumed.

distances = gdistm(DistanceUnit) specifies a unit of length measurement. Can be any unit described in the documentation for validateLengthUnit.

PathDistance = gdistm('path') specifies that a cumulative path distance along several point clicks is returned. If the 'path' option is chosen, length of distances array is N and distances(1) = 0. Matlabmatically, PathDistance = [0;cumsum(distances)];

distances = gdistm('color',ColorSpec) specifies a marker and line color.

[...,lat,lon] = gdistm(...) returns arrays of clicked latitudes and longitudes equivalent to [lat,lon] = inputm(...).