com.mapbox.turf

Class TurfTransformation

java.lang.Object

com.mapbox.turf.TurfTransformation

public final class TurfTransformation
extends java.lang.Object

Methods in this class consume one GeoJSON object and output a new object with the defined parameters provided.

Since:

3.0.0

Method Summary

Modifier and Type	Method and Description
static com.mapbox.geojson.Polygon	circle(com.mapbox.geojson.Point center, double radius) Takes a Point and calculates the circle polygon given a radius in degrees, radians, miles, or kilometers; and steps for precision.
static com.mapbox.geojson.Polygon	circle(com.mapbox.geojson.Point center, double radius, int steps, java.lang.String units) Takes a Point and calculates the circle polygon given a radius in the provided TurfConstants.TurfUnitCriteria; and steps for precision.
static com.mapbox.geojson.Polygon	circle(com.mapbox.geojson.Point center, double radius, java.lang.String units) Takes a Point and calculates the circle polygon given a radius in the provided TurfConstants.TurfUnitCriteria; and steps for precision.
static java.util.List<com.mapbox.geojson.Point>	simplify(java.util.List<com.mapbox.geojson.Point> original) Simplifies provided list of coordinates points into a shorter list of coordinates.
static java.util.List<com.mapbox.geojson.Point>	simplify(java.util.List<com.mapbox.geojson.Point> original, boolean highQuality) Simplifies provided list of coordinates points into a shorter list of coordinates.
static java.util.List<com.mapbox.geojson.Point>	simplify(java.util.List<com.mapbox.geojson.Point> original, double tolerance) Simplifies provided list of coordinates points into a shorter list of coordinates.
static java.util.List<com.mapbox.geojson.Point>	simplify(java.util.List<com.mapbox.geojson.Point> original, double tolerance, boolean highQuality) Simplifies provided list of coordinates points into a shorter list of coordinates.

Methods inherited from class java.lang.Object

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

Method Detail

circle

public static com.mapbox.geojson.Polygon circle(@NonNull
                                                com.mapbox.geojson.Point center,
                                                double radius)

Takes a Point and calculates the circle polygon given a radius in degrees, radians, miles, or kilometers; and steps for precision. This uses the DEFAULT_STEPS and TurfConstants.UNIT_DEFAULT values.

Parameters:

center - a Point which the circle will center around

radius - the radius of the circle

Returns:

a Polygon which represents the newly created circle

Since:

3.0.0

circle

public static com.mapbox.geojson.Polygon circle(@NonNull
                                                com.mapbox.geojson.Point center,
                                                double radius,
                                                java.lang.String units)

Takes a Point and calculates the circle polygon given a radius in the provided TurfConstants.TurfUnitCriteria; and steps for precision. This method uses the DEFAULT_STEPS.

Parameters:

center - a Point which the circle will center around

radius - the radius of the circle

units - one of the units found inside TurfConstants.TurfUnitCriteria

Returns:

a Polygon which represents the newly created circle

Since:

3.0.0

circle

public static com.mapbox.geojson.Polygon circle(@NonNull
                                                com.mapbox.geojson.Point center,
                                                double radius,
                                                int steps,
                                                java.lang.String units)

Takes a Point and calculates the circle polygon given a radius in the provided TurfConstants.TurfUnitCriteria; and steps for precision.

Parameters:

center - a Point which the circle will center around

radius - the radius of the circle

steps - number of steps which make up the circle parameter

units - one of the units found inside TurfConstants.TurfUnitCriteria

Returns:

a Polygon which represents the newly created circle

Since:

3.0.0

simplify

@NonNull
public static java.util.List<com.mapbox.geojson.Point> simplify(@NonNull
                                                                         java.util.List<com.mapbox.geojson.Point> original)

Simplifies provided list of coordinates points into a shorter list of coordinates.

Parameters:

original - the coordinates to simplify

Returns:

simplified coordinates

simplify

@NonNull
public static java.util.List<com.mapbox.geojson.Point> simplify(@NonNull
                                                                         java.util.List<com.mapbox.geojson.Point> original,
                                                                         double tolerance)

Simplifies provided list of coordinates points into a shorter list of coordinates.

Parameters:

original - the coordinates to simplify

tolerance - tolerance in the same measurement as the point coordinates

Returns:

simplified coordinates

simplify

@NonNull
public static java.util.List<com.mapbox.geojson.Point> simplify(@NonNull
                                                                         java.util.List<com.mapbox.geojson.Point> original,
                                                                         boolean highQuality)

Simplifies provided list of coordinates points into a shorter list of coordinates.

Parameters:

original - the coordinates to simplify

highQuality - true for using Douglas-Peucker, false for Radial-Distance algorithm

Returns:

simplified coordinates

simplify

@NonNull
public static java.util.List<com.mapbox.geojson.Point> simplify(@NonNull
                                                                         java.util.List<com.mapbox.geojson.Point> original,
                                                                         double tolerance,
                                                                         boolean highQuality)

Simplifies provided list of coordinates points into a shorter list of coordinates.

Parameters:

original - the coordinates to simplify

tolerance - tolerance in the same measurement as the point coordinates

highQuality - true for using Douglas-Peucker, false for Radial-Distance algorithm

Returns:

simplified coordinates