jwo.landserf.process.gps.garmin
Class PositionDataPacket

java.lang.Object
  jwo.landserf.process.gps.garmin.GarminPacket
      jwo.landserf.process.gps.garmin.PositionDataPacket

All Implemented Interfaces:

Position

public class PositionDataPacket

extends GarminPacket

implements Position

Represents a packet containing a point location.

Version:

2.2, 16th June, 2004

Author:

Jo Wood, based on the design by Henrik Sorensen (haas@itu.dk).

Field Summary

Fields inherited from class jwo.landserf.process.gps.garmin.GarminPacket

Cmnd_Abort_Transfer, Cmnd_Start_Pvt_Data, Cmnd_Stop_Pvt_Data, Cmnd_Transfer_Alm, Cmnd_Transfer_Posn, Cmnd_Transfer_Prx, Cmnd_Transfer_Rte, Cmnd_Transfer_Time, Cmnd_Transfer_Trk, Cmnd_Transfer_Wpt, Cmnd_Turn_Off_Pwr, DLE, ETX, packet, Pid_Ack_Byte, Pid_Almanac_Data, Pid_Command_Data, Pid_Date_Time_Data, Pid_Nak_Byte, Pid_Position_Data, Pid_Product_Data, Pid_Product_Rqst, Pid_Protocol_Array, Pid_Prx_Wpt_Data, Pid_Pvt_Data, Pid_Records, Pid_Rte_Hdr, Pid_Rte_Link_Data, Pid_Rte_Wpt_Data, Pid_Trk_Data, Pid_Trk_Hdr, Pid_Wpt_Data, Pid_Xfer_Cmplt

Constructor Summary

PositionDataPacket(GarminPacket packet)
Creates a position packet from the given packet.

PositionDataPacket(int[] packet)
Creates a position packet from the given data.

Method Summary

float	getAltitude() Reports the altitude of this position.
AngleRadians	getLatitude() Reports the latitude of the position.
AngleRadians	getLongitude() Reports the longitude of the position.
String	toString() Reports a textual representation of this packet.

Methods inherited from class jwo.landserf.process.gps.garmin.GarminPacket

calcChecksum, commandToString, createBasicPacket, createCommandPacket, getByte, getDataLength, getID, getLength, getPacket, getRawPacket, idToString, isLegal, readByte, readDouble, readFloat, readLong, readNullTerminatedString, readWord, setPacket

Methods inherited from class java.lang.Object

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

Constructor Detail

PositionDataPacket

public PositionDataPacket(int[] packet)

Creates a position packet from the given data.

Parameters:

packet - Data representing the position packet.

Throws:

PacketNotRecognizedException - if the data do not represent a position data packet.

InvalidPacketException - if the packet data are not the expected length.

PositionDataPacket

public PositionDataPacket(GarminPacket packet)

Creates a position packet from the given packet.

Parameters:

packet - Packet to copy.

Throws:

PacketNotRecognizedException - if the given packet is not a position data packet.

Method Detail

getLatitude

public AngleRadians getLatitude()

Reports the latitude of the position.

Specified by:

getLatitude in interface Position

Returns:

Latitude in radians.

getLongitude

public AngleRadians getLongitude()

Reports the longitude of the position.

Specified by:

getLongitude in interface Position

Returns:

Longitude in radians.

getAltitude

public float getAltitude()

Reports the altitude of this position.

Specified by:

getAltitude in interface Position

Returns:

Altitude of this position in units determined by the GPS. May be 0 if GPS unit does not record waypoint altitude.

toString

public String toString()

Reports a textual representation of this packet.

Overrides:

toString in class GarminPacket

Returns:

String containing the position in a human readable format.