net.maritimecloud.util.geometry

Class PositionTime

java.lang.Object

net.maritimecloud.util.geometry.Position

net.maritimecloud.util.geometry.PositionTime

All Implemented Interfaces:

Serializable, Message

public class PositionTime
extends Position

A position couple with a timestamp.

Author:

Kasper Nielsen

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static MessageSerializer<PositionTime>	SERIALIZER A parser of PositionTime messages.

Method Summary

Modifier and Type	Method and Description
static PositionTime	create(double latitude, double longitude)
static PositionTime	create(double latitude, double longitude, long time) Creates a new position from the specified latitude and longitude.
static PositionTime	create(Position position, long time)
static PositionTime	create(String pos)
boolean	equals(Object other) Equals method
boolean	equals(Position other)
boolean	equals(PositionTime other)
PositionTime	extrapolatePosition(float cog, float sog, long time) Calculate - using linear extrapolation (or dead reckoning) - a position based on known speed and course from this position.
static PositionTime	fromBinary(Binary b)
long	getTime()
int	hashCode() Hash code for the location
PositionTime	interpolatedPosition(PositionTime laterPosition, long time) Calculate - using linear interpolation - a position between this position and a specified.
boolean	positionEquals(Position other)
static PositionTime	readFrom(MessageReader r)
Timestamp	timestamp()
Binary	toBinary() Returns a 64 bit representation of this position.
String	toString()

Methods inherited from class net.maritimecloud.util.geometry.Position

fromPackedLong, geodesicDistanceTo, geodesicFinalBearingTo, geodesicInitialBearingTo, getCell, getCellInt, getLatitude, getLatitudeAsString, getLongitude, getLongitudeAsString, immutable, isValid, random, random, rhumbLineBearingTo, rhumbLineDistanceTo, toJSON, toPackedLong, toStringDegrees, verifyLatitude, verifyLongitude, withLatitude, withLongitude, withTime

Methods inherited from class java.lang.Object

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

Field Detail

SERIALIZER

public static final MessageSerializer<PositionTime> SERIALIZER

A parser of PositionTime messages.

Method Detail

fromBinary

public static PositionTime fromBinary(Binary b)

toBinary

public Binary toBinary()

Description copied from class: Position

Returns a 64 bit representation of this position. Encoded as decimal degress with 7 decimal places.

Overrides:

toBinary in class Position

Returns:

the position as a binary

equals

public boolean equals(Object other)

Equals method

Overrides:

equals in class Position

equals

public boolean equals(Position other)

Overrides:

equals in class Position

equals

public boolean equals(PositionTime other)

extrapolatePosition

public PositionTime extrapolatePosition(float cog,
                                        float sog,
                                        long time)

Calculate - using linear extrapolation (or dead reckoning) - a position based on known speed and course from this position.

Parameters:

cog - is the course over ground.

sog - is the speed over ground in knots.

time - the absolute time (in millis since Epoch) to extrapolate to.

Returns:

a new PositionTime instance containing the dead reckoned position at time t.

See Also:

Dead reckoning

getTime

public long getTime()

hashCode

public int hashCode()

Hash code for the location

Overrides:

hashCode in class Position

interpolatedPosition

public PositionTime interpolatedPosition(PositionTime laterPosition,
                                         long time)

Calculate - using linear interpolation - a position between this position and a specified. Assuming constant speed between the two positions.

Parameters:

laterPosition - the later position to use in the interpolation.

time - the time at which the interpolated position should be calculated.

Returns:

a new PositionTime instance containing the interpolated position at absolute time t.

positionEquals

public boolean positionEquals(Position other)

toString

public String toString()

Overrides:

toString in class Position

timestamp

public Timestamp timestamp()

create

public static PositionTime create(double latitude,
                                  double longitude)

create

public static PositionTime create(double latitude,
                                  double longitude,
                                  long time)

Creates a new position from the specified latitude and longitude.

Parameters:

latitude - the latitude

longitude - the longitude

time - the epoch time

Returns:

the new position

Throws:

IllegalArgumentException - if the

create

public static PositionTime create(Position position,
                                  long time)

create

public static PositionTime create(String pos)

readFrom

public static PositionTime readFrom(MessageReader r)
                             throws IOException

Throws:

IOException