com.geotab.model.coordinate

Class Coordinate

java.lang.Object

com.geotab.model.coordinate.Coordinate

Direct Known Subclasses:

TemporalCoordinate

public class Coordinate
extends Object

A coordinate on the earth's surface. "x" is longitude and "y" is latitude.

Constructor Summary

Constructors

Constructor and Description
Coordinate()

Method Summary

Modifier and Type	Method and Description
static double	distanceBetween(double x1, double y1, double x2, double y2) Calculates the distance between this point and the supplied point.
double	distanceFrom(Coordinate coordinate) Returns the distance between this point and the supplied point in meters.
static double	distanceFromPoly(double x, double y, List<Coordinate> polygon) The distance from the closest polygon's border to the point.
boolean	equals(Object obj)
static int	getBearing(Coordinate from, Coordinate to) Calculates a geographical bearing between two points.
static List<Coordinate>	getCalculatedExtent(List<Coordinate> features) Recalculate the extent of collection of coordinates.
static Coordinate	getCentroid(List<Coordinate> coordinates) Get the centroid of collection of Coordinate(s).
int	hashCode()
static boolean	intersectsWithPoly(double x, double y, List<Coordinate> polygon) Returns whether the polygon intersects with a specific x and y.
static boolean	isPolygon(List<Coordinate> feature) Get whether this polygon is a properly formed polygon having the end point equal to the first point.
static List<Coordinate>	rectangleFromLtrb(double left, double top, double right, double bottom) Gets collection of Coordinate(s) representing rectangular shape.
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Coordinate

public Coordinate()

Method Detail

distanceBetween

public static double distanceBetween(double x1,
                                     double y1,
                                     double x2,
                                     double y2)

Calculates the distance between this point and the supplied point.

Parameters:

x1 - The fist x coordinate (longitude).

y1 - The fist y coordinate (latitude).

x2 - The second x coordinate (longitude).

y2 - The second y coordinate (latitude).

Returns:

The distance.

distanceFromPoly

public static double distanceFromPoly(double x,
                                      double y,
                                      List<Coordinate> polygon)

The distance from the closest polygon's border to the point.

Parameters:

x - The origin's x-coordinate.

y - The origin's y-coordinate.

polygon - The SimpleCoordinate list represents the the polygon.

Returns:

The distance from the polygon.

getBearing

public static int getBearing(Coordinate from,
                             Coordinate to)

Calculates a geographical bearing between two points.

Parameters:

from - The origin coordinates.

to - The destination coordinates.

Returns:

The bearing in degrees.

getCalculatedExtent

public static List<Coordinate> getCalculatedExtent(List<Coordinate> features)

Recalculate the extent of collection of coordinates.

Parameters:

features - The features.

Returns:

List of coordinates.

getCentroid

public static Coordinate getCentroid(List<Coordinate> coordinates)

Get the centroid of collection of Coordinate(s).

Parameters:

coordinates - The coordinates.

Returns:

The centroid.

intersectsWithPoly

public static boolean intersectsWithPoly(double x,
                                         double y,
                                         List<Coordinate> polygon)

Returns whether the polygon intersects with a specific x and y.

Parameters:

x - The x-coordinate being tested for intersection.

y - The y-coordinate being tested for intersection.

polygon - The Coordinate list (the polygon) being tested for intersection.

Returns:

true if the coordinate intersects with the polygon.

isPolygon

public static boolean isPolygon(List<Coordinate> feature)

Get whether this polygon is a properly formed polygon having the end point equal to the first point.

Parameters:

feature - The feature

Returns:

Whether is a polygon or not.

rectangleFromLtrb

public static List<Coordinate> rectangleFromLtrb(double left,
                                                 double top,
                                                 double right,
                                                 double bottom)

Gets collection of Coordinate(s) representing rectangular shape.

Parameters:

left - The left.

top - The top.

right - The right.

bottom - The bottom.

Returns:

List of Coordinate(s).

distanceFrom

public double distanceFrom(Coordinate coordinate)

Returns the distance between this point and the supplied point in meters.

Parameters:

coordinate - The Coordinate being checked for distance.

Returns:

The distance.

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object