Package globus.glmap

Class GLMapVectorLine

java.lang.Object

globus.glmap.GLNativeObject

globus.glmap.GLMapVectorObject

globus.glmap.GLMapVectorLine

All Implemented Interfaces:

GLMapTagsContainer, AutoCloseable

public class GLMapVectorLine
extends GLMapVectorObject

Vector object with line or multiline geometry.

Nested Class Summary

Nested classes/interfaces inherited from class globus.glmap.GLMapVectorObject

GLMapVectorObject.Type

Field Summary

Fields inherited from class globus.glmap.GLMapVectorObject

drawAttributes

Constructor Summary

Constructors

Constructor	Description
GLMapVectorLine(MapGeoPoint start, MapGeoPoint end, double quality)	Creates a great-circle line from start to end.

Method Summary

Modifier and Type	Method	Description
double	lineDistanceToPoint(MapPoint point, MapPoint nearestPoint, double maxDistance)	Finds the nearest point on the line and returns distance from the line start to it.
MapPoint	pointAtLineDistance(double distance)	Finds a point located at the given distance from the start of the line.

Methods inherited from class globus.glmap.GLMapVectorObject

asGeoJSON, compare, copyProperties, createFromGeoJSONOrError, createFromGeoJSONOrThrow, createFromGeoJSONStreamOrError, createFromGeoJSONStreamOrThrow, createGeoLine, createGeoPoint, createMultiline, createMultilineGeo, createPoint, createPolygon, createPolygonGeo, equals, getBBox, getLineCount, getLinePointCount, getLinePointStart, getPointAtIndex, getPointCount, getPolygonCount, getPolygonLineCount, getPolygonLineStart, getType, hashCode, localizedName, point, setValueForKey, updateDrawAttributes, valueForKey, valuesForKey

Methods inherited from class globus.glmap.GLNativeObject

close, dispose

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Details

GLMapVectorLine

public GLMapVectorLine(@NonNull
 MapGeoPoint start,
 @NonNull
 MapGeoPoint end,
 double quality)

Creates a great-circle line from start to end. Useful to display plane routes.

Parameters:

start - start point

end - end point

quality - subdivision step in meters: the line is split until its half-segments are shorter than this, into at most 65536 segments

Method Details

pointAtLineDistance

@NonNull
public MapPoint pointAtLineDistance(@FloatRange(from=0.0)
 double distance)

Finds a point located at the given distance from the start of the line.

Parameters:

distance - distance in meters along the line

Returns:

point on the line in internal map coordinates; contains NaN if the line is empty

lineDistanceToPoint

public double lineDistanceToPoint(@NonNull
 MapPoint point,
 @Nullable
 MapPoint nearestPoint,
 @FloatRange(from=0.0)
 double maxDistance)

Finds the nearest point on the line and returns distance from the line start to it.

Parameters:

point - point to test (internal map coordinates)

nearestPoint - output: nearest point on the line (optional)

maxDistance - maximum distance from the line in internal map units

Returns:

distance from the start of the line to the nearest point, in meters, or NaN if nothing is within maxDistance