ai.nextbillion.kits.turf

Class TurfMisc

java.lang.Object

ai.nextbillion.kits.turf.TurfMisc

public final class TurfMisc
extends java.lang.Object

Class contains all the miscellaneous methods that Turf can perform.

See Also:

Turf documentation

Method Summary

Modifier and Type	Method and Description
static ai.nextbillion.kits.geojson.LineString	lineSlice(ai.nextbillion.kits.geojson.Point startPt, ai.nextbillion.kits.geojson.Point stopPt, ai.nextbillion.kits.geojson.Feature line) Takes a line, a start Point, and a stop point and returns the line in between those points.
static ai.nextbillion.kits.geojson.LineString	lineSlice(ai.nextbillion.kits.geojson.Point startPt, ai.nextbillion.kits.geojson.Point stopPt, ai.nextbillion.kits.geojson.LineString line) Takes a line, a start Point, and a stop point and returns the line in between those points.
static ai.nextbillion.kits.geojson.LineString	lineSliceAlong(ai.nextbillion.kits.geojson.Feature line, double startDist, double stopDist, java.lang.String units) Takes a LineString, a specified distance along the line to a start Point, and a specified distance along the line to a stop point and returns a subsection of the line in-between those points.
static ai.nextbillion.kits.geojson.LineString	lineSliceAlong(ai.nextbillion.kits.geojson.LineString line, double startDist, double stopDist, java.lang.String units) Takes a LineString, a specified distance along the line to a start Point, and a specified distance along the line to a stop point, returns a subsection of the line in-between those points.
static ai.nextbillion.kits.geojson.Feature	nearestPointOnLine(ai.nextbillion.kits.geojson.Point pt, java.util.List<ai.nextbillion.kits.geojson.Point> coords) Takes a Point and a LineString and calculates the closest Point on the LineString.
static ai.nextbillion.kits.geojson.Feature	nearestPointOnLine(ai.nextbillion.kits.geojson.Point pt, java.util.List<ai.nextbillion.kits.geojson.Point> coords, java.lang.String units) Takes a Point and a LineString and calculates the closest Point on the LineString.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

lineSlice

@NonNull
public static ai.nextbillion.kits.geojson.LineString lineSlice(@NonNull
                                                                        ai.nextbillion.kits.geojson.Point startPt,
                                                                        @NonNull
                                                                        ai.nextbillion.kits.geojson.Point stopPt,
                                                                        @NonNull
                                                                        ai.nextbillion.kits.geojson.Feature line)

Takes a line, a start Point, and a stop point and returns the line in between those points.

Parameters:

startPt - Starting point.

stopPt - Stopping point.

line - Line to slice.

Returns:

Sliced line.

Throws:

TurfException - signals that a Turf exception of some sort has occurred.

See Also:

Turf Line slice documentation

lineSlice

@NonNull
public static ai.nextbillion.kits.geojson.LineString lineSlice(@NonNull
                                                                        ai.nextbillion.kits.geojson.Point startPt,
                                                                        @NonNull
                                                                        ai.nextbillion.kits.geojson.Point stopPt,
                                                                        @NonNull
                                                                        ai.nextbillion.kits.geojson.LineString line)

Takes a line, a start Point, and a stop point and returns the line in between those points.

Parameters:

startPt - used for calculating the lineSlice

stopPt - used for calculating the lineSlice

line - geometry that should be sliced

Returns:

a sliced LineString

See Also:

Turf Line slice documentation

lineSliceAlong

@NonNull
public static ai.nextbillion.kits.geojson.LineString lineSliceAlong(@NonNull
                                                                             ai.nextbillion.kits.geojson.Feature line,
                                                                             double startDist,
                                                                             double stopDist,
                                                                             @NonNull
                                                                             java.lang.String units)

Takes a LineString, a specified distance along the line to a start Point, and a specified distance along the line to a stop point and returns a subsection of the line in-between those points. This can be useful for extracting only the part of a route between two distances.

Parameters:

line - input line

startDist - distance along the line to starting point

stopDist - distance along the line to ending point

units - one of the units found inside TurfConstants.TurfUnitCriteria can be degrees, radians, miles, or kilometers

Returns:

sliced line

Throws:

TurfException - signals that a Turf exception of some sort has occurred.

See Also:

Turf Line slice documentation

lineSliceAlong

@NonNull
public static ai.nextbillion.kits.geojson.LineString lineSliceAlong(@NonNull
                                                                             ai.nextbillion.kits.geojson.LineString line,
                                                                             double startDist,
                                                                             double stopDist,
                                                                             @NonNull
                                                                             java.lang.String units)

Takes a LineString, a specified distance along the line to a start Point, and a specified distance along the line to a stop point, returns a subsection of the line in-between those points. This can be useful for extracting only the part of a route between two distances.

Parameters:

line - input line

startDist - distance along the line to starting point

stopDist - distance along the line to ending point

units - one of the units found inside TurfConstants.TurfUnitCriteria can be degrees, radians, miles, or kilometers

Returns:

sliced line

Throws:

TurfException - signals that a Turf exception of some sort has occurred.

See Also:

Turf Line slice documentation

nearestPointOnLine

@NonNull
public static ai.nextbillion.kits.geojson.Feature nearestPointOnLine(@NonNull
                                                                              ai.nextbillion.kits.geojson.Point pt,
                                                                              @NonNull
                                                                              java.util.List<ai.nextbillion.kits.geojson.Point> coords)

Takes a Point and a LineString and calculates the closest Point on the LineString.

Parameters:

pt - point to snap from

coords - line to snap to

Returns:

closest point on the line to point

nearestPointOnLine

@NonNull
public static ai.nextbillion.kits.geojson.Feature nearestPointOnLine(@NonNull
                                                                              ai.nextbillion.kits.geojson.Point pt,
                                                                              @NonNull
                                                                              java.util.List<ai.nextbillion.kits.geojson.Point> coords,
                                                                              @Nullable
                                                                              java.lang.String units)

Takes a Point and a LineString and calculates the closest Point on the LineString.

Parameters:

pt - point to snap from

coords - line to snap to

units - one of the units found inside TurfConstants.TurfUnitCriteria can be degrees, radians, miles, or kilometers

Returns:

closest point on the line to point