haberman.rhizomatics.utils

Class GeoUtils

java.lang.Object

haberman.rhizomatics.utils.GeoUtils

public class GeoUtils
extends java.lang.Object

Exposes static calculation utilities for basic computational geo(metry/graphy).

Field Summary

Fields

Modifier and Type	Field and Description
private static double	DEG_TO_RAD
private static double	RAD_TO_DEG

Constructor Summary

Constructors

Constructor and Description
GeoUtils()

Method Summary

Modifier and Type	Method and Description
static java.util.ArrayList<com.mapbox.mapboxsdk.geometry.LatLng>	close_poly(java.util.ArrayList<com.mapbox.mapboxsdk.geometry.LatLng> polygon) Simply create a new ArrayList that closes the provided one by inserting a clone of its first member at the end.
static com.mapbox.mapboxsdk.geometry.LatLng	compute_centroid(java.util.ArrayList<com.mapbox.mapboxsdk.geometry.LatLng> locations) Computes the centroid of the given locations array.
static double	earth_radius(double latitude) Returns the distance from the Earth's center to a point on its spheroid surface at the given latitude.
static boolean	in_polygon(com.mapbox.mapboxsdk.geometry.LatLng location, java.util.ArrayList<com.mapbox.mapboxsdk.geometry.LatLng> polygon) Tests if a given location is within a polygon.
static com.mapbox.mapboxsdk.geometry.LatLng	interpolate_list(com.mapbox.mapboxsdk.geometry.LatLng[] locations_list, float progress)
static com.mapbox.mapboxsdk.geometry.LatLng	interpolate(com.mapbox.mapboxsdk.geometry.LatLng start, com.mapbox.mapboxsdk.geometry.LatLng end, float progress) Computes the linear interpolation between 2 LatLng, by a specified extent.
private static Vector2	latlng_to_vector2(com.mapbox.mapboxsdk.geometry.LatLng location) Converts a LatLng to its Vector2 representation.
static com.mapbox.mapboxsdk.geometry.LatLng	location_at_screen_center()
static float	min_distance(com.mapbox.mapboxsdk.geometry.LatLng reference, java.util.ArrayList<com.mapbox.mapboxsdk.geometry.LatLng> locations) Returns the minimum distance between a reference point and a list of other locations.
static com.mapbox.mapboxsdk.geometry.LatLng	project_on_circle(com.mapbox.mapboxsdk.geometry.LatLng location, double radius, double angle) Projects a given location to a certain radius along a provided angle.

Methods inherited from class java.lang.Object

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

Field Detail

RAD_TO_DEG

private static final double RAD_TO_DEG

See Also:

Constant Field Values

DEG_TO_RAD

private static final double DEG_TO_RAD

See Also:

Constant Field Values

Constructor Detail

GeoUtils

public GeoUtils()

Method Detail

compute_centroid

public static com.mapbox.mapboxsdk.geometry.LatLng compute_centroid(java.util.ArrayList<com.mapbox.mapboxsdk.geometry.LatLng> locations)

Computes the centroid of the given locations array.

Parameters:

locations - An ArrayList describing the polygon on which to find the centroid

Returns:

The computed LatLng centroid.

close_poly

public static java.util.ArrayList<com.mapbox.mapboxsdk.geometry.LatLng> close_poly(java.util.ArrayList<com.mapbox.mapboxsdk.geometry.LatLng> polygon)

Simply create a new ArrayList that closes the provided one by inserting a clone of its first member at the end.

Parameters:

polygon - The ArrayList of points to close.

Returns:

The polygon as a closed list of locations.

project_on_circle

public static com.mapbox.mapboxsdk.geometry.LatLng project_on_circle(com.mapbox.mapboxsdk.geometry.LatLng location,
                                                                     double radius,
                                                                     double angle)

Projects a given location to a certain radius along a provided angle.

Parameters:

location - The LatLng point to project

radius - The amount of projection (expressed as degrees equivalent distance of meters)

angle - The angle_to of projection

Returns:

The projected LatLng instance.

interpolate_list

@Nullable
public static com.mapbox.mapboxsdk.geometry.LatLng interpolate_list(com.mapbox.mapboxsdk.geometry.LatLng[] locations_list,
                                                                              float progress)

interpolate

public static com.mapbox.mapboxsdk.geometry.LatLng interpolate(com.mapbox.mapboxsdk.geometry.LatLng start,
                                                               com.mapbox.mapboxsdk.geometry.LatLng end,
                                                               float progress)

Computes the linear interpolation between 2 LatLng, by a specified extent.

Parameters:

start - The first location to anchor the interpolation

end - The second location used as the projection axis

progress - The factor of interpolation between the 2 locations

Returns:

A new LatLng for the interpolated projection.

latlng_to_vector2

private static Vector2 latlng_to_vector2(@NonNull
                                         com.mapbox.mapboxsdk.geometry.LatLng location)

Converts a LatLng to its Vector2 representation.

Parameters:

location - LatLng instance to convert

Returns:

A new corresponding Vector2 point.

min_distance

public static float min_distance(com.mapbox.mapboxsdk.geometry.LatLng reference,
                                 java.util.ArrayList<com.mapbox.mapboxsdk.geometry.LatLng> locations)

Returns the minimum distance between a reference point and a list of other locations.

Parameters:

reference - The reference point to measure the distance from

locations - A list of coordinates

Returns:

The maximum distance in meters.

earth_radius

public static double earth_radius(double latitude)

Returns the distance from the Earth's center to a point on its spheroid surface at the given latitude.

Parameters:

latitude - The latitude where to calculate the Earth's radius from

Returns:

The Earth's radius.

in_polygon

public static boolean in_polygon(com.mapbox.mapboxsdk.geometry.LatLng location,
                                 java.util.ArrayList<com.mapbox.mapboxsdk.geometry.LatLng> polygon)

Tests if a given location is within a polygon.

Parameters:

location - The LatLng to test

polygon - An array of LatLng describing the contour of the polygon

Returns:

The boolean result.

location_at_screen_center

public static com.mapbox.mapboxsdk.geometry.LatLng location_at_screen_center()